Delete an agent

DELETE 
/v1/projects/:project_id/agents/:agent_id

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.

Request

Responses

204

Deleted

401

Unauthorized

403

Forbidden

404

Not found

409

Agent has dependent generations, traces, accepted shares or ingestion rules in its own project (pass force=true to delete anyway; records and rules another project made through a share are kept). error.meta carries generation_count, trace_count, accepted_share_count and ingestion_rule_count so a caller can tell which one is nonzero.