General Documentation
Agents
Agent Executions
Test Suites
Projects
WhatsApp Conversations
Customers
WhatsApp Configs
Agent Test Chats
Conversation Assignments
WhatsApp Templates
WhatsApp Contact Notes
Agent Snapshots
Agents
Create a new agent
Creates a new agent with default graph structure
POST
/
agents
Copy
curl --request POST \
--url https://app.kapso.ai/api/v1/agents \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '{
"agent": {
"name": "New Customer Support Agent",
"system_prompt": "You are a helpful customer support assistant."
}
}'
Copy
{
"data": {
"id": "agent-123abc",
"name": "Customer Support Agent",
"description": "Handles initial customer support queries",
"project_id": "project-456def",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}
}
Authorizations
API key required for all endpoints
Body
application/json
Response
201
application/json
Agent created successfully
The response is of type object
.
Copy
curl --request POST \
--url https://app.kapso.ai/api/v1/agents \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '{
"agent": {
"name": "New Customer Support Agent",
"system_prompt": "You are a helpful customer support assistant."
}
}'
Copy
{
"data": {
"id": "agent-123abc",
"name": "Customer Support Agent",
"description": "Handles initial customer support queries",
"project_id": "project-456def",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}
}
Assistant
Responses are generated using AI and may contain mistakes.