curl -X POST https://api.ringyo.ai/v1/calls \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "+14155551234",
    "agent_id": "agent_abc123",
    "metadata": {
      "customer_id": "cust_456",
      "campaign": "follow_up"
    }
  }'

const response = await fetch('https://api.ringyo.ai/v1/calls', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    phone_number: '+14155551234',
    agent_id: 'agent_abc123',
    metadata: {
      customer_id: 'cust_456',
      campaign: 'follow_up'
    }
  })
});

const call = await response.json();

import requests

response = requests.post(
    'https://api.ringyo.ai/v1/calls',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json',
    },
    json={
        'phone_number': '+14155551234',
        'agent_id': 'agent_abc123',
        'metadata': {
            'customer_id': 'cust_456',
            'campaign': 'follow_up'
        }
    }
)

call = response.json()

{
  "id": "call_xyz789",
  "status": "queued",
  "phone_number": "+14155551234",
  "from_number": "+18005551234",
  "agent_id": "agent_abc123",
  "metadata": {
    "customer_id": "cust_456",
    "campaign": "follow_up"
  },
  "record": true,
  "created_at": "2024-01-15T10:30:00Z"
}

{
  "error": {
    "code": "invalid_phone_number",
    "message": "Phone number must be in E.164 format"
  }
}

{
  "error": {
    "code": "insufficient_credits",
    "message": "Your account has insufficient credits for this call"
  }
}

{
  "error": {
    "code": "agent_not_found",
    "message": "The specified agent does not exist"
  }
}