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
api-keyheader
AuthorizationBearer <sk_waylo_<lookup><secret><checksum>>id*stringapplication/json- body
name?|Length
1 <= length <= 100agentId?|Format
uuidactive?booleanUpdated
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 PATCH 'https://api.poc.app.waylovoice.ai/phone-numbers/string' \ -H 'Authorization: Bearer sk_waylo_...' \ -H 'Content-Type: application/json' \ -d '{}'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"}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`
List presets GET
The WayloAI presets an agent can run, with each preset's tools and default feedback. **Access:** authenticated · any API key