Delete an agent

DELETE 
/api/v1/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

400

Invalid request — a query parameter or body field the operation does not declare, or a value that fails validation

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.

429

QUOTA_EXCEEDED — a requests quota on the calling API key or its project is spent for the window; Retry-After says when it reopens

Response Headers

Retry-After

Seconds until the quota window admits a request again

500

Unexpected server error — INTERNAL_ERROR, with the raw message never forwarded