Agents

Create, configure, and manage your AI voice agents via the Boltcall API.

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

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": "[phone]",
      "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

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

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

curl -X DELETE https://api.boltcall.org/v1/agents/agent_def456 \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{ "deleted": true }