Delete Agent

Permanently removes an agent and its configuration.

Endpoint

DELETE /v1/agents/{agent_id}

Parameters

Parameter	Type	Required	Description
agent_id	string	Yes	Unique identifier of the agent to delete

Authentication

Requires a valid API key or user authentication token.

Response

Returns a success message when the agent is deleted.

Response Format

{
  "message": "Agent deleted successfully"
}

Example Request

curl -X DELETE "https://api.krosai.com/v1/agents/a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
  -H "Authorization: Bearer YOUR_API_KEY"

Error Responses

Status Code	Description
401	Unauthorized - Invalid or missing API key
403	Forbidden - Not authorized to delete this agent
404	Not Found - Agent with the specified ID does not exist
500	Internal Server Error

Notes

• This action cannot be undone.

• Active voice sessions with this agent will be terminated.

• Historical conversation data associated with this agent will remain accessible.

• Knowledge bases linked to this agent are not deleted.