agents
Delete agent
Delete an AI SDR by sid: switched off, then soft-deleted; its threads fall to the team's default. The default goes last: with another agent alive its delete is a 409 delete_blocked naming the others (make another the default first); deleting the last agent provisions a fresh draft on the next read. The threads, the runs, its scenarios, Knowledge and Golden set rows stay (retained). To stop an agent without losing what it knows, update_agent with state off.
Contract:
- MCP tool delete_agent, registry package mcp.unibox/agents, mount unibox.agent.
- Operation delete, response envelope delete_simple.
- Flags: dangerous: the MCP layer gates it behind a preview/commit token, and the effect cannot be undone through this API.
delete/api/agents/{sid}
Request
- Base URLhttps://beta.getsales.io/unibox/v1
- AuthHTTP bearer and API key in header Team-SID
Path parameters
sidstring required
The ub_ag_* sid of the row to delete.
Response
delete_simple success envelope.
Changes
No recorded changes to this operation across all 1 revision of this API.