MYLO Calls

Place outbound Nepali reminder calls from your agent and track each call from queued to completed.

POST https://api.sagea.space/mylo/calls

Provide the destination in E.164 format, pick the agent voice, and optionally schedule the call for later.

Authentication

Send Authorization: Bearer $SAGEA_API_KEY on every request. Get a key

Parameters

Parameter	Type	Required	Description
`to`	string	Yes	Destination in E.164 format such as `+97798XXXXXXXX`
`agent_id`	string	Yes	Agent identifier such as `support_np` or `reminder_np`
`scheduled_at`	string	No	ISO-8601 time to queue the call for later delivery
`from_caller_id`	string	No	Verified caller ID shown to the recipient
`language`	string	No	BCP-47 code, defaults to `ne-NP` for Nepali reminders
`metadata`	object	No	Custom key-value pairs echoed in status and webhooks

Use scheduled_at for Kathmandu clinic reminders a day before the appointment window.

Set from_caller_id to your verified Kathmandu business number to improve pickup rates.

Store booking IDs in metadata so transcripts and billing reconcile without extra lookups.

curl -X POST https://api.sagea.space/mylo/calls \
  -H "Authorization: Bearer $SAGEA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+97798XXXXXXXX",
    "agent_id": "reminder_np",
    "scheduled_at": "2026-09-16T09:00:00+05:45",
    "from_caller_id": "+977014445566",
    "language": "ne-NP"
  }'

Check call progress with the returned call_id:

curl https://api.sagea.space/mylo/calls/mylo_call_4fT8kN2pR6sD \
  -H "Authorization: Bearer $SAGEA_API_KEY"

The reminder script confirms the Kathmandu appointment, offers rescheduling, and quotes any NPR 500 visit fee.

Response

A successful place returns 201 with the call handle and initial queue status.

{
  "call_id": "mylo_call_4fT8kN2pR6sD",
  "status": "queued",
  "to": "+97798XXXXXXXX",
  "agent_id": "reminder_np",
  "scheduled_at": "2026-09-16T09:00:00+05:45",
  "from_caller_id": "+977014445566"
}

Status moves through queued, in-progress, then terminal completed or failed.

A GET on the call ID returns the same object with updated status plus duration_seconds when finished.

Errors

Status	Code	Fix
422	`invalid_phone`	Send E.164 format starting with country code
429	`rate_limit_exceeded`	Slow dial rate and spread scheduled calls
404	`call_not_found`	Check the call ID spelling and account scope
401	`unauthorized`	Verify `SAGEA_API_KEY` and header formatting

Limits

10 calls per second per key, 5000 scheduled calls queued max, 15 minute max call duration.