Skip to main content
POST
/
api
/
v1
/
call
/
stop
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"
    }
  }'

{
  "success": true
}
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.
This is a beta endpoint and not yet recommended for production use.

​
Request Body

​
conversation_id
string
required
The unique identifier for the conversation
​
agent_email
string
required
The email address of the agent handling the call
​
metadata
object
Additional metadata to associate with the call

​
Response

​
success
boolean
Indicates if the call was successfully stopped

​
Error Responses

​
error
string
Error message when the user does not exist or conversation is not found
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"
    }
  }'

{
  "success": true
}