Start Call

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
}

POST

api

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
}

Overview Stop Call

API documentation

Call Endpoints

Product Endpoints

Miscellaneous Endpoints

Live Endpoints

Request Body

Response

Error Responses

​Request Body

​Response

​Error Responses

Request Body

Response

Error Responses