Agents

Delete an agent

Deletes an agent by ID. Fails with 409 if the agent has dependent generations or traces, or another project has accepted a share of it, unless force=true is passed, in which case those generations and traces are deleted along with the agent and the shares are revoked. Every share of the agent is revoked when it is deleted.

delete/v1/projects/{project_id}/agents/{agent_id}

Request

  • Base URL: https://api.naturali.ai
  • URL: https://api.naturali.ai/v1/projects/{project_id}/agents/{agent_id}
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://api.naturali.ai/authorize, token URL https://api.naturali.ai/token, scopes: mcp:access)

Path parameters

agent_idstring required
Example:agent_V1StGXR8Z5jdHi6B

Agent public ID

Query parameters

forceboolean

When true, deletes the agent's dependent generations and traces, revokes its accepted shares and leaves its ingestion rules naming it instead of returning 409 AGENT_HAS_DEPENDENTS.

Response

Deleted

Changes

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