Agents

Delete agent

Permanently deletes the agent identified by agent_id. On success the endpoint returns HTTP 204 with no body. This removes the agent configuration; any analysis-group links involving this agent are also removed. The operation is irreversible — fetch the agent first if you need to preserve its configuration.

DELETE

https://api.nabrah.ai/api/ext/agent/{agent_id}

Delete agent

curl --request DELETE \
  --url 'https://api.nabrah.ai/api/ext/agent/<agent_id>' \
  --header 'X-API-Key: <your-api-key>'

// No example body for this response.

Before you call

Where agent_id comes from

Obtain agent_id from GET /api/ext/agent (list) or from the agent_id returned when you created the agent via POST /api/ext/agent.

No response body

A successful delete returns 204 No Content. A 422 indicates a malformed or invalid agent_id.

Authorization

X-API-Keystringheaderrequired

Your workspace API key. Create one in the dashboard under API keys.

Path parameters

agent_idstringrequired

UUID of the agent to delete.

Get this from GET /api/ext/agent or from the create-agent response (POST /api/ext/agent).

Response

204

Successful Response

422

Validation Error

application/json