Skip to main content
Agents are the AI voice personas that answer calls, engage leads, and book appointments on behalf of your business. Each agent has a voice, a greeting, and an optional system prompt that shapes its behavior.

​
List agents

​
page
integer
Page number. Default: 1.
​
limit
integer
Number of results per page. Default: 20, max: 100.
curl https://api.boltcall.org/v1/agents \
  -H "Authorization: Bearer YOUR_API_KEY"
Response
{
  "data": [
    {
      "id": "agent_abc123",
      "name": "Front Desk Agent",
      "voice_id": "voice_sarah",
      "status": "active",
      "phone_number": "+1234567890",
      "created_at": "2025-01-15T08:30:00Z"
    }
  ],
  "meta": { "page": 1, "limit": 20, "total": 3 }
}

​
Create an agent

​
name
string
required
Display name for the agent.
​
voice_id
string
required
The voice to use. See the Voice Library in your dashboard for available IDs.
​
greeting
string
Custom greeting the agent speaks when a call connects.
​
prompt
string
System prompt or persona instructions that guide the agent’s behavior.
​
knowledge_base_id
string
ID of a knowledge base to link to this agent. See Knowledge base.
curl -X POST https://api.boltcall.org/v1/agents \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "After-Hours Agent",
    "voice_id": "voice_james",
    "greeting": "Thanks for calling! How can I help you today?",
    "prompt": "You are a friendly receptionist for a dental practice..."
  }'
Response
{
  "id": "agent_def456",
  "name": "After-Hours Agent",
  "voice_id": "voice_james",
  "status": "active",
  "created_at": "2025-03-20T14:00:00Z"
}

​
Update an agent

Updates one or more fields on an existing agent. Only the fields you include are changed. Path parameter
​
agent_id
string
required
The ID of the agent to update.
Body
​
name
string
Updated display name.
​
greeting
string
Updated greeting message.
​
status
string
Set to "active" or "paused". A paused agent will not answer calls.
curl -X PATCH https://api.boltcall.org/v1/agents/agent_def456 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "After-Hours Agent v2",
    "status": "active"
  }'
Response
{
  "id": "agent_def456",
  "name": "After-Hours Agent v2",
  "status": "active",
  "updated_at": "2025-03-21T10:00:00Z"
}

​
Delete an agent

Permanently deletes an agent. This cannot be undone. Path parameter
​
agent_id
string
required
The ID of the agent to delete.
Deleting an agent is irreversible. Any phone numbers assigned to the agent will be unlinked, and call history is retained but the agent can no longer be restored.
curl -X DELETE https://api.boltcall.org/v1/agents/agent_def456 \
  -H "Authorization: Bearer YOUR_API_KEY"
Response
{ "deleted": true }