Provision phone number
POST
Retry provisioning one number: attach it to the connection's trunk and ensure the dispatch rule. Answers with the number, active or failed with a statusReason — a failure is its state, not a failed request.
Access: workspace_admin · API key phone_numbers:write
api-keyheader
AuthorizationBearer <sk_waylo_<lookup><secret><checksum>>id*stringSuccess
application/json- response
id*stringworkspaceId*stringconnectionId*stringconnectionName*stringprovider*"twilio"Value in
"twilio"e164*stringproviderNumberId*stringname*string|nullagentId*|Format
uuidagentName*string|nullstatus*stringValue in
"activating""active""failed"statusReason*string|nullactive*booleancreatedByUserId*|Format
uuidcreatedByUserName*string|nullupdatedByUserId*|Format
uuidupdatedByUserName*string|nullcreatedAt*stringFormat
date-timeupdatedAt*stringFormat
date-timecurl -X POST 'https://api.poc.app.waylovoice.ai/phone-numbers/string/provision' \ -H 'Authorization: Bearer sk_waylo_...'Example Response
{ "id": "string", "workspaceId": "string", "connectionId": "string", "connectionName": "string", "provider": "twilio", "e164": "string", "providerNumberId": "string", "name": "string", "agentId": "bc309ecf-5f66-4057-93c5-6611cc9cb7b2", "agentName": "string", "status": "activating", "statusReason": "string", "active": true, "createdByUserId": "4d2aef9a-17b0-44e6-902e-616812033620", "createdByUserName": "string", "updatedByUserId": "b38eaad7-8efa-49e7-b0aa-619916a3821e", "updatedByUserName": "string", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z"}List phone numbers GET
Numbers in one workspace, offset-paginated. **Access:** workspace_viewer · API key `phone_numbers:read`
Update phone number PATCH
Rename it, assign or unassign its agent (`agentId: null`), or retire and restore it with `active`. Retiring detaches it at the carrier, where it falls back to its own routing; restoring re-proves ownership and attaches it again. **Access:** workspace_admin · API key `phone_numbers:write`