Delete a custom agent
DELETE /api/agent-definitions/custom/{id}
DELETE
/api/agent-definitions/custom/{id}
Permanently deletes a custom specialist agent definition. The agent’s MCP connection assignments are also removed. The MCP hub cache is invalidated so the agent is no longer dispatched. Platform agents cannot be deleted.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ” id
required
string format: uuid
The unique identifier of the custom agent to delete.
Responses
Section titled “ Responses ”The custom agent was deleted.
Simple success acknowledgment returned by action endpoints (reply, resolve, take-over, etc.).
object
ok
required
Always true on success.
boolean
Example
trueNo custom agent exists with the given ID.
Standard error response returned by all endpoints on failure.
object
error
required
A human-readable error message describing what went wrong.
string
Example
Conversation not found