> ## 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.

# Stop Call

> Stops a call for a given conversation and agent.

Stops a call for a given conversation and agent.

Note that this can fail either from the user not matching an active Reddy user or from failing the lookup of the conversation. Conversations are unique by the 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 stopped
</ResponseField>

## Error Responses

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

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

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