Delete an assistant

Deletes an existing assistant. It does not delete the underlying assistant in the storage provider like OpenAI, only all of it’s data in Superinterface.

Data removed upon assistant deletion:

Assistant and all associated data (initial messages, functions, MCP servers)

Threads

Messages (if they were stored in Superinterface Cloud)

Data disassociated upon assistant deletion:

Interfaces

Request

DELETE https://superinterface.ai/api/cloud/assistants/{assistantId}

Authentication

Include your private API key in the request headers:

Authorization: Bearer YOUR_PRIVATE_API_KEY

Path Parameters

Parameter	Type	Description
`assistantId`	string	The ID of an existing assistant to delete

Example request

curl -X DELETE "https://superinterface.ai/api/cloud/assistants/00cfe680-fee5-49b9-b386-6a7097eb8497" \ -H "Authorization: Bearer YOUR_PRIVATE_API_KEY" \ -H "Content-Type: application/json"

Response

Parameter	Type	Description
`assistant`	Assistant	Deleted Assistant

Example response

{ "assistant": { "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-16T12:00: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" }