SautiDesk
SautiDesk API
Workspace configuration

Set a number's call routing

PUT
/v1/desk/numbers/{id}/routing

Sets where a number's calls go: to a queue (queue_id) or to the phone menu (menu_id), chosen by kind.

Requires: desk.admin scope, workspace owner or admin.

Authorization

bearerAuth
AuthorizationBearer <token>

A SautiDesk API key. An owner or admin makes it under Settings in SautiDesk for a named person and picks the scopes. The key is shown once. Send it as Authorization: Bearer <key>. It acts as that person and as nobody else.

In: header

Path Parameters

id*string

The number's id (a UUID).

Request Body

application/json

Response

OK

Example

{  "id": "3f2b8c1e-5a4d-4e7b-9c10-2d6a8e4f1b37",  "e164": "+254712345678",  "label": "Amina Wanjiru",  "status": "open",  "monthly_minor": 1,  "currency": "KES",  "kind": "billing",  "queue_id": "c70c2d37-4d65-4ba4-9843-5e8aaf2dae40",  "menu_id": "af4f7978-1d4f-478d-9661-0c5affcaa9e2",  "desk": false,  "needs_attention": false,  "sms": false}
FieldTypeDescription
idrequiredstring (uuid)
e164requiredstring
labelrequiredstringA short name to recognise it by.
statusrequiredstringThe status to set.
monthly_minorrequiredinteger
currencyrequiredstringThe currency code of the money in this report, for example KES. Write money figures with it. Left out when the report has no money.
kindstringWhat kind it is.
queue_idstring (uuid) | nullThe id of the queue that receives what arrives here.
menu_idstring (uuid) | nullThe id of the phone menu to answer with.
deskrequiredboolean
needs_attentionboolean
smsrequiredboolean
curl -X PUT "https://api.sautidesk.com/v1/desk/numbers/string/routing" \  -H "Content-Type: application/json" \  -d '{    "kind": "billing",    "queue_id": "c70c2d37-4d65-4ba4-9843-5e8aaf2dae40",    "menu_id": "af4f7978-1d4f-478d-9661-0c5affcaa9e2"  }'