Delete an agent (409 while a run is processing)
Deletes the agent and tears down the provider subscriptions behind it. The results list it built and the rows already delivered are KEPT — delete the list separately if you want them gone. Drafts delete immediately. An agent whose run is in progress (status: processing) answers 409 AGENT_PROCESSING; wait until it reads active or paused and retry. Nothing is refunded, and a deleted agent is not recoverable — duplicate it first if you may want it back. Answers 204 with no body.
Errors:
- 404 AGENT_NOT_FOUND — No agent with this id belongs to the token owner. A deleted agent and another user's agent answer identically.
- 409 AGENT_PROCESSING — A run is in progress (status processing); the agent cannot be changed until it settles. Retry once it is active or paused.
- 422 VALIDATION_FAILED — The request failed this endpoint's own validation — param names the offending field and message says why.
- 429 RATE_LIMITED — The agents bucket is exhausted: 30 requests per minute or 2,000 per day per token owner, shared by every /business/agents operation (a 429 raised by the agents service is relayed with this code too). Retry after the Retry-After header.
- 500 UNEXPECTED_ERROR — The agents service failed (5xx, refused service credential, or a timeout after 60s) or the rate limiter was unavailable. Retry later; quote request_id to support.
Requires one of the following token scopes: agents.
Request
- Base URL: https://api.tryfuse.ai/api/v1
- URL: https://api.tryfuse.ai/api/v1/business/agents/{agentId}
- Auth: HTTP basic
Path parameters
The agent's id: a 24-character hex string — the id of an item from GET /business/agents, or the agent.id a create or duplicate returned.
Response
Deleted
Changes
No recorded changes to this operation across all 1 revision of this API.