Create an assistant

Create a new assistant.

Request

POST https://superinterface.ai/api/cloud/assistants

Authentication

Include your private API key in the request headers:

Authorization: Bearer YOUR_PRIVATE_API_KEY

Request Body

Parameter	Type	Required	Description
`storageProviderType`	`StorageProviderType`	Yes	`StorageProviderType` (e.g., `OPENAI`)
`storageProviderAssistantId`	string	No	Storage provider assistant ID
`modelProviderId`	string	Yes	AI provider ID
`model`	string	Yes	Model to use (e.g., "gpt-4.1")
`name`	string	Yes	Name of the assistant
`description`	string	No	Description for the assistant
`instructions`	string	No	Instructions for the assistant
`codeInterpreterEnabled`	boolean	No	Enable code interpreter
`fileSearchEnabled`	boolean	No	Enable file search

Example request

curl -X POST "https://superinterface.ai/api/cloud/assistants" \ -H "Authorization: Bearer YOUR_PRIVATE_API_KEY" \ -H "Content-Type: application/json" -d '{ "storageProviderType": "OPENAI", "storageProviderAssistantId": "asst_22QudIsRPVWBOkanyBRWWBn2", "modelProviderId": "30cfe680-fee5-49b9-b386-6a7097eb8497", "model": "gpt-4.1", "name": "AI builder", "description": "Builds applications", "instructions": "Help user build apps." }'

Response

Parameter	Type	Description
`assistant`	Assistant	New Assistant

Example response

{ "assistant": { "id": "00cfe680-fee5-49b9-b386-6a7097eb8497", "storageProviderType": "OPENAI", "storageProviderAssistantId": "asst_22QudIsRPVWBOkanyBRWWBn2", "modelProviderId": "30cfe680-fee5-49b9-b386-6a7097eb8497", "model": "gpt-4.1", "name": "AI builder", "description": "Builds applications", "instructions": "Help user build apps.", "codeInterpreterEnabled": false, "fileSearchEnabled": false, "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" }