Delete Agent by ID

This endpoint deletes an agent by its identifier. Once deleted, the agent can no longer be used in threads.

DELETE /agents/{id}

cURL

cURL

curl --request DELETE \
  --url https://api.{environment}.corti.app/agents/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Tenant-Name: <tenant-name>'

400

{
  "code": "<string>",
  "description": "<string>",
  "howToFix": "<string>",
  "details": {},
  "cause": {}
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Tenant-Name · string · required

Identifies a distinct entity within Corti's multi-tenant system. Ensures correct routing and authentication of the request.

Example:

"base"

Path Parameters

id · string · required

The identifier of the agent associated with the context.

Example:

"12345678-90ab-cdef-gh12-34567890abc"

Response

204

Agent deleted successfully.