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.
Last updated