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 URL
    https://beta.getsales.io/unibox/v1
  • Auth
    HTTP 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.

successtrue required
operation'delete' required
itemobject required
already_deletedboolean required
soft_deletedboolean required
retainedstring[] required

Changes

No recorded changes to this operation across all 1 revision of this API.