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

# Start Call

> Starts a call for a given conversation and agent.

Starts a call for a given conversation and agent.

Conversations are unique by the combination of user and conversation ID together.

<Warning>
  This is a beta endpoint and not yet recommended for production use.
</Warning>

## Request Body

<ParamField body="conversation_id" type="string" required>
  The unique identifier for the conversation
</ParamField>

<ParamField body="agent_email" type="string" required>
  The email address of the agent handling the call
</ParamField>

<ParamField body="metadata" type="object" optional>
  Additional metadata to associate with the call
</ParamField>

## Response

<ResponseField name="success" type="boolean">
  Indicates if the call was successfully started
</ResponseField>

## Error Responses

<ResponseField name="error" type="string">
  Error message when the user does not exist
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST 'https://app.reddy.io/api/v1/call/start' \
    -H 'Authorization: Bearer your_api_key' \
    -H 'Content-Type: application/json' \
    -d '{
      "conversation_id": "12345",
      "agent_email": "agent@company.com",
      "metadata": {
        "source": "inbound",
        "queue": "support"
      }
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "success": true
  }
  ```
</ResponseExample>