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

{
  "success": true
}
Starts a call for a given conversation and agent. Conversations are unique by the combination of 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 started

​
Error Responses

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

{
  "success": true
}