curl -X GET https://api.ansa.so/agents \
-H "Authorization: Bearer your-api-key"
{
"data": [
{
"id": "agent_xxx",
"name": "Support Bot",
"slug": "support-bot",
"model": "claude-sonnet-4-20250514",
"createdAt": "2024-01-15T10:00:00Z"
}
]
}
API Reference
Agents
Manage your AI agents
GET
/
agents
curl -X GET https://api.ansa.so/agents \
-H "Authorization: Bearer your-api-key"
{
"data": [
{
"id": "agent_xxx",
"name": "Support Bot",
"slug": "support-bot",
"model": "claude-sonnet-4-20250514",
"createdAt": "2024-01-15T10:00:00Z"
}
]
}
List Agents
Get all agents for the authenticated user.curl -X GET https://api.ansa.so/agents \
-H "Authorization: Bearer your-api-key"
{
"data": [
{
"id": "agent_xxx",
"name": "Support Bot",
"slug": "support-bot",
"model": "claude-sonnet-4-20250514",
"createdAt": "2024-01-15T10:00:00Z"
}
]
}
Get Agent
string
required
The agent ID
GET /agents/:id
curl -X GET https://api.ansa.so/agents/agent_xxx \
-H "Authorization: Bearer your-api-key"
{
"data": {
"id": "agent_xxx",
"name": "Support Bot",
"slug": "support-bot",
"model": "claude-sonnet-4-20250514",
"temperature": 50,
"systemPrompt": "You are a helpful support agent.",
"createdAt": "2024-01-15T10:00:00Z",
"updatedAt": "2024-01-20T14:30:00Z"
}
}
Create Agent
POST /agents
string
required
Agent display name
string
AI model ID (default: claude-sonnet-4-20250514)
string
Instructions for the agent
number
Response creativity (0-100)
curl -X POST https://api.ansa.so/agents \
-H "Authorization: Bearer your-api-key" \
-H "Content-Type: application/json" \
-d '{
"name": "Sales Bot",
"model": "claude-sonnet-4-20250514",
"systemPrompt": "You are a sales assistant.",
"temperature": 40
}'
{
"data": {
"id": "agent_yyy",
"name": "Sales Bot",
"slug": "sales-bot",
"model": "claude-sonnet-4-20250514",
"temperature": 40,
"systemPrompt": "You are a sales assistant.",
"createdAt": "2024-01-22T09:00:00Z"
}
}
Update Agent
PATCH /agents/:id
curl -X PATCH https://api.ansa.so/agents/agent_xxx \
-H "Authorization: Bearer your-api-key" \
-H "Content-Type: application/json" \
-d '{
"name": "Updated Name",
"temperature": 60
}'
Delete Agent
DELETE /agents/:id
This permanently deletes the agent and all associated data including conversations, documents, and tools.
curl -X DELETE https://api.ansa.so/agents/agent_xxx \
-H "Authorization: Bearer your-api-key"
⌘I