Delete
/assistants/{id}
Deletes an assistant from both the external provider and the local database.
Use this when an agent is no longer needed.
Security
API Key: CookieAuth
Cookie parameter nameauth-token
Authentication is handled via an auth-token HTTP-only cookie set by the
/auth/login endpoint.
- In a browser, you typically call
/auth/loginonce and the cookie will be stored and automatically sent on subsequent API requests. - In API tools (Postman, curl, etc.) you can manually capture the cookie
from the
Set-Cookieheader or configure cookie handling.
This spec models the cookie using apiKey-style auth for documentation
purposes.
Path parameters
id
stringRequired
Assistant identifier (external provider ID or local DB ID).
Responses
200
Assistant deleted successfully.
object
success
boolean
Exampletrue
401
Not authenticated or lacking permission to delete agents.
object
Standard error response envelope.
Example{
"error": "Failed to load agents. Please try again."
}
error
string
Human-readable error message.
404
Assistant not found.
object
Standard error response envelope.
Example{
"error": "Failed to load agents. Please try again."
}
error
string
Human-readable error message.
500
Error deleting assistant or communicating with the external provider.
object
Standard error response envelope.
Example{
"error": "Failed to load agents. Please try again."
}
error
string
Human-readable error message.