Skip to main content
DELETE
/
agents
/
{agent_id}
Delete agent
curl --request DELETE \
  --url https://api.natural.co/agents/{agent_id} \
  --header 'Authorization: Bearer <token>'
{
  "errors": [
    {
      "code": "NOT_AUTHENTICATED",
      "detail": "Authentication required.",
      "status": 401,
      "meta": {
        "supportId": "req_a1b2c3d4e5f6"
      }
    }
  ]
}

Authorizations

Authorization
string
header
required

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

Headers

X-Agent-ID
string | null

Agent ID (agt_xxx) identifying which agent is making the request.

X-Instance-ID
string | null

Agent session/conversation ID for observability.

Maximum string length: 1024

Path Parameters

agent_id
string
required

Agent ID

Response

Agent deleted. No content returned.