Quickstart

curl -X POST https://api.ryvo.so/v1/calls \
  -H "Authorization: Bearer ryvo_live_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "agent_id": "agent_8801kpabc123",
    "to": "+5215555550100",
    "metadata": {
      "lead_name": "Juan García",
      "deal_id": "OPP-42"
    }
  }'

const response = await fetch("https://api.ryvo.so/v1/calls", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.RYVO_API_KEY}`,
    "Content-Type": "application/json",
    "Idempotency-Key": crypto.randomUUID(),
  },
  body: JSON.stringify({
    agent_id: "agent_8801kpabc123",
    to: "+5215555550100",
    metadata: { lead_name: "Juan García", deal_id: "OPP-42" },
  }),
})

const call = await response.json()
console.log(call.id) // call_conv_01abcdef

import os, uuid, requests

response = requests.post(
    "https://api.ryvo.so/v1/calls",
    headers={
        "Authorization": f"Bearer {os.environ['RYVO_API_KEY']}",
        "Content-Type": "application/json",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={
        "agent_id": "agent_8801kpabc123",
        "to": "+5215555550100",
        "metadata": {"lead_name": "Juan García", "deal_id": "OPP-42"},
    },
)

call = response.json()
print(call["id"])  # call_conv_01abcdef