List tools
Retrieve a list of tools for an assistant.
Request
GET https://superinterface.ai/api/cloud/assistants/{assistantId}/tools
Authentication
Include your private API key in the request headers:
Authorization: Bearer YOUR_PRIVATE_API_KEY
Path Parameters
Example request
curl -X GET "https://superinterface.ai/api/cloud/assistants/00cfe680-fee5-49b9-b386-6a7097eb8497/tools" \
-H "Authorization: Bearer YOUR_PRIVATE_API_KEY" \
-H "Content-Type: application/json"
Response
Example response
{
"tools": [
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"type": "WEB_SEARCH",
"webSearchTool": {},
"createdAt": "2024-01-15T10:30:00Z",
"updatedAt": "2024-01-15T10:30:00Z"
},
{
"id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"type": "IMAGE_GENERATION",
"imageGenerationTool": {
"model": "gpt-image-1",
"quality": "AUTO",
"size": "AUTO",
"outputFormat": "PNG",
"background": "AUTO",
"partialImages": 0
},
"createdAt": "2024-01-15T10:30:00Z",
"updatedAt": "2024-01-15T10:30:00Z"
}
]
}
Errors
The endpoint may return the following errors:
401 Unauthorized
This error occurs if the API key is invalid or missing.
{
"error": "Unauthorized",
"message": "Invalid or missing API key"
}