████████████████████████████████████████████████
              ████████████████████████████████████████████████
              ████████████████████████████████████████████████
              ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀████████▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
                                  ████████
                                  ████████
                                 ██████████
                                 ██████████
                                ████████████
                                ████████████
                               ██████████████
                               ██████████████
                              ████████████████
                              ████████████████
                             ██████████████████
                              ████████████████
                               ██████████████
                                ████████████
                                 ██████████
                                  ████████
                                   ██████
                                    ████
                                     ██
                                      ▾


                          T E L E P H O N E . O R G

                  the future of telecommunications
                AI voice-to-voice communications, today

                          https://telephone.org


  ─────────────────────────────────────────────────────────────────────
   API quick reference
  ─────────────────────────────────────────────────────────────────────

   Authenticate
     PUT  /v2/user_auth
     Body { "data": { "credentials":  "<md5(username:password)>",
                      "account_name": "<your-account-name>" } }
     Returns { "auth_token", "data": { "account_id", "owner_id" } }

   Authenticated requests
     Send your token in the request header:
       X-Auth-Token: <auth_token>

   Common read endpoints
     GET  /v2/accounts/{account_id}
     GET  /v2/accounts/{account_id}/devices
     GET  /v2/accounts/{account_id}/devices/{device_id}
     GET  /v2/accounts/{account_id}/users/{user_id}
     GET  /v2/accounts/{account_id}/users/{user_id}/devices
     GET  /v2/accounts/{account_id}/callflows
     GET  /v2/accounts/{account_id}/voicemails

   Call control
     POST /v2/accounts/{account_id}/channels                 (dial)
     DEL  /v2/accounts/{account_id}/channels/{channel_id}    (hang up)
     POST /v2/accounts/{account_id}/conferences/{id}/participants

   Real-time event stream
     Connect via the events websocket; subscribe to bindings such as
     call.CHANNEL_ANSWER.*  call.CHANNEL_DESTROY.*  qubicle.recipient

   IDs are 32-character hex; tokens are JWTs with a one-hour exp.
   Rate limits return HTTP 429 with a Retry-After header.

  ─────────────────────────────────────────────────────────────────────