WayloAIWaylo Docs
APIReferenceTelephony connections

Update connection

PATCH
/telephony-connections/{id}

Rename it, rotate its credentials (config, checked against the carrier first), or retire and restore it with active. Retiring deletes the Waylo trunk and is refused while active numbers use the connection; restoring provisions a new one.

Access: tenant_admin · API key telephony:write

Authorization

api-key
headerAuthorizationBearer <sk_waylo_<lookup><secret><checksum>>

Path Parameters

id*string

Header Parameters

Authorization*string

Your API key.

Request Body

application/json
  1. body
name?string
Length1 <= length <= 100
config?
active?boolean

Response Body

Updated

application/json
  1. response
id*string
name*string
status*string
Value in"activating""active""failed"
statusReason*string|null
active*boolean
numberCount*number
createdByUserId*|
Formatuuid
createdByUserName*string|null
updatedByUserId*|
Formatuuid
updatedByUserName*string|null
createdAt*string
Formatdate-time
updatedAt*string
Formatdate-time
provider*"twilio"
Value in"twilio"
config*
Example Request
curl -X PATCH 'https://api.poc.app.waylovoice.ai/telephony-connections/string' \  -H 'Authorization: Bearer sk_waylo_...' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response
{  "id": "string",  "name": "string",  "status": "activating",  "statusReason": "string",  "active": true,  "numberCount": 0,  "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",  "provider": "twilio",  "config": {    "accountSid": "string",    "apiKeySid": "string",    "trunkSid": "string"  }}

Resync connection POST

Re-apply the trunk, its origination URIs, every active number and the dispatch rule. The retry for a connection or number left `failed`, and the repair after the gateways change. A step that fails again leaves its row `failed` with a `statusReason`, not a failed request. **Access:** tenant_admin · API key `telephony:write`

Create tool POST

Define a tool in a workspace. `type` decides the shape of `config`, and an unknown `config` key is refused. For `api_request` the URL must be HTTPS; unknown `{{variables}}` and a credential outside the workspace are rejected here, not on a live call. A name is unique in its workspace, and a model-facing name reserved by the API is refused (400). **Access:** workspace_admin · API key `tools:write`