List assistants
Retrieve a list of all assistants in your workspace.
Request
GET https://superinterface.ai/api/cloud/assistants
Authentication
Include your private API key in the request headers:
Authorization: Bearer YOUR_PRIVATE_API_KEY
Example request
curl -X GET "https://superinterface.ai/api/cloud/assistants" \
-H "Authorization: Bearer YOUR_PRIVATE_API_KEY" \
-H "Content-Type: application/json"
Response
Example response
{
"assistants": [
{
"id": "00cfe680-fee5-49b9-b386-6a7097eb8497",
"storageProviderType": "OPENAI",
"storageProviderAssistantId": "asst_xwQudIsRPVWBOkanyBRWWBn2",
"modelProviderId": "01afd9c6-519f-4336-a39e-e739143f0a5c",
"model": "gpt-4.1",
"name": "AI builder",
"description": "Builds applications",
"instructions": "Help user build apps.",
"codeInterpreterEnabled": true,
"fileSearchEnabled": true,
"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"
}