> ## Documentation Index > Fetch the complete documentation index at: https://docs.freyavoice.ai/llms.txt > Use this file to discover all available pages before exploring further. # Initiate call > Initiates an outbound call. Requires phoneNumber, callerNumber, and workspaceId. Add campaignId to trigger the campaign call flow. Routes via Asterisk ARI or FreeSWITCH ESL based on phone number trunk config. ## OpenAPI ````yaml https://staging-app.freyavoice.ai/api/openapi.json post /call openapi: 3.1.0 info: title: Freyavoice API version: 2.0.0 description: >- Production API for managing calls and campaigns. **Authentication**: All endpoints require a bearer token issued by Freyavoice. **Response Format**: All responses are wrapped in a standard envelope: ```json { "success": true, "data": { "message": "Success", "result": { /* endpoint-specific data */ } } } ``` Error responses follow the same format with `success: false`: ```json { "success": false, "data": { "message": "Error description", "result": null } } ``` contact: name: Freyavoice Support email: support@freyavoice.com servers: - url: https://app.freyavoice.ai/api/v2 description: Production security: [] tags: - name: Agents description: Manage AI agents - name: Analytics description: Call analytics and metrics - name: API Keys description: API key management - name: Audio description: Audio transcription and speech synthesis - name: Calls description: Call management and history - name: Call Recordings description: Call recording management - name: Call Tags description: Call tagging and categorization - name: Campaigns description: Campaign management - name: Chat description: Stateful text chat with agents and workflows - name: Custom description: Custom convenience endpoints - name: Export description: Data export - name: Insights description: Structured data field definitions - name: Agent Insights description: Agent-to-field assignments - name: Integrations description: Third-party integrations - name: Personas description: Simulation personas for agent testing - name: Phone Numbers description: Phone number management - name: Phone Aliases description: Workspace phone book (phone-number to label mappings) - name: Suppression List description: Workspace do-not-call (DNC) list; numbers blocked from outbound dialing - name: Feedbacks description: Feedback tracking - name: Feedback Assignees description: Feedback assignment - name: Feedback Comments description: Feedback comments - name: Feedback References description: Feedback cross-references to other entities - name: Feedback Status Config description: Feedback status configuration - name: Reviews description: Call reviews - name: Review Assignees description: Review assignment - name: Simulations description: Agent simulation testing - name: Simulation Iterations description: Simulation iteration history - name: Unit Tests description: Behavioural unit tests for agents and workflows - name: Branches description: Branches (proposed changes) of an agent or workflow version line - name: Webhooks description: Webhook configuration - name: Versions description: Version history and rollback for agents and workflows - name: Workflows description: Workflow management - name: Workspaces description: Workspace management - name: Workspace Credits description: Workspace credit balance - name: Workspace Invitations description: Workspace invitations - name: Workspace Logs description: Workspace activity logs - name: Workspace Members description: Workspace member management - name: Workspace Roles description: Custom roles and permissions per workspace - name: Permissions description: Permission catalog (used by role + API-key UIs) paths: /call: post: tags: - Calls summary: Initiate call description: >- Initiates an outbound call. Requires phoneNumber, callerNumber, and workspaceId. Add campaignId to trigger the campaign call flow. Routes via Asterisk ARI or FreeSWITCH ESL based on phone number trunk config. operationId: initiateCall requestBody: content: application/json: schema: type: object properties: phoneNumber: type: string description: Customer/destination phone number callerNumber: type: string description: >- Caller ID phone number (used to look up SIP/trunk config). Required for regular calls; campaign calls derive it from the campaign workspaceId: type: string format: uuid description: Workspace ID campaignId: type: string format: uuid description: Campaign ID (presence triggers campaign call flow) properties: type: object additionalProperties: {} description: Custom properties to pass to the agent attemptNumber: type: integer exclusiveMinimum: 0 description: >- Campaign attempt number (1 = initial call); surfaced to the agent as 0-based call.retry_number externalCallId: type: string minLength: 1 maxLength: 255 description: External call ID for client-side tracking assistantId: type: string format: uuid description: Override campaign assistant ID entityVersionId: type: string format: uuid description: >- Version ID of the entity (agent/workflow) active during the call skipE164Normalization: type: boolean description: >- Skip E.164 normalization of the phone number (default: false) required: - phoneNumber - workspaceId responses: '200': description: Call initiated content: application/json: schema: type: object properties: success: type: boolean enum: - true data: type: object properties: message: type: string result: type: object properties: success: type: boolean callId: type: string jobUuid: type: string job_uuid: type: string message: type: string error: type: string required: - success required: - message - result required: - success - data '400': description: Validation error content: application/json: schema: type: object properties: success: type: boolean enum: - false data: type: object properties: message: type: string result: {} required: - message required: - success - data '401': description: Missing or invalid token content: application/json: schema: type: object properties: success: type: boolean enum: - false data: type: object properties: message: type: string result: {} required: - message required: - success - data '403': description: Workspace ID mismatch or insufficient permissions content: application/json: schema: type: object properties: success: type: boolean enum: - false data: type: object properties: message: type: string result: {} required: - message required: - success - data '500': description: Server error content: application/json: schema: type: object properties: success: type: boolean enum: - false data: type: object properties: message: type: string result: {} required: - message required: - success - data security: - bearerAuth: [] components: securitySchemes: bearerAuth: type: http scheme: bearer ````