> ## Documentation Index
> Fetch the complete documentation index at: https://www.agentvoice.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Agents

## Initiate a Call

```http theme={null}
POST https://api.agentvoice.com/api/agents/call
```

Initiates a phone call from an agent to a contact.

**Request Headers**:

```http theme={null}
Content-Type: application/json
x-api-key: your-api-key
x-organization-id: your-organization-id
```

**Request Body**:

```json theme={null}
{
  "agentId": "uuid-of-the-agent",
  "phoneNumber": "+1XXXXXXXXXX",
  "notes": "Optional notes for context in this call"
}
```

**Required Parameters**:

* agentId: The UUID of the agent that will make the call
* phoneNumber: Phone number in the format +1XXXXXXXXXX

**Optional Parameters**:

* notes: Additional context for the call

**Example Response**:

```json theme={null}
{
  "message": "Call initiated successfully",
  "callId": "b7f2d8e1-6c3a-4d5b-9e8f-1a2b3c4d5e6f",
  "agentName": "Sales Assistant",
  "contactName": "John Doe",
  "phoneNumber": "+15551234567"
}
```

The contact must have a valid phone number in their profile. The call is initiated immediately upon successful request processing.