Skip to main content
DELETE
/
api
/
v1
/
agents
/
{id}
Delete Agent
curl --request DELETE \
  --url https://api.example.com/api/v1/agents/{id}
Permanently delete an AI agent from your organization.

Request

DELETE /api/v1/agents/{id}
Authorization: Bearer YOUR_API_KEY

Path Parameters

ParameterTypeRequiredDescription
idstringYesUUID of the agent

Response

Returns 204 No Content on success.

Examples

curl -X DELETE "https://app.preclinical.dev/api/v1/agents/uuid" \
  -H "Authorization: Bearer $API_KEY"
Deleting an agent is permanent and cannot be undone. All associated test runs will remain but will reference a deleted agent.

Errors

CodeDescription
AGENT_NOT_FOUNDAgent not found or doesn’t belong to your organization