managed-service

API reference descriptions are provided in English to preserve the exact published contract.

GETRead hosted portfolio containment and termination noticesmanagedService.containment.list
GETGet hosted WhatsApp exit progressmanagedService.wabas.exit.list
POSTRequest a free hosted-number exit and complete customer-data exportmanagedService.wabas.exit.create
POSTRequest a hosted-exit prepaid balance refund or transfermanagedService.wabas.exit.balanceRequest
POSTRetry a failed or expired hosted-exit exportmanagedService.wabas.exit.export
POSTConfirm receipt of the hosted exit exportmanagedService.wabas.exit.exportReceived

Read hosted portfolio containment and termination notices

GET/v1/accounts/{AC}/managed-service/containment

managedService.containment.listSDK operation getV1AccountsByAcManagedServiceContainment

Required scope: accounts:read.

GET /v1/accounts/{AC}/managed-service/containment

curl "https://api.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/managed-service/containment" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21"

Responses

Get hosted WhatsApp exit progress

GET/v1/accounts/{AC}/managed-service/wabas/{WB}/exit

managedService.wabas.exit.listSDK operation getV1AccountsByAcManagedServiceWabasByWbExit

Financial balance details require billing:read. Otherwise balance contains only state=unavailable, available=false and reason=BILLING_READ_REQUIRED; no amounts, instructions or provider references are returned.

Required scope: accounts:read.

Parameters

WBstring (WB… SID)Required

GET /v1/accounts/{AC}/managed-service/wabas/{WB}/exit

curl "https://api.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/managed-service/wabas/WB.../exit" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21"

Responses

Request a free hosted-number exit and complete customer-data export

POST/v1/accounts/{AC}/managed-service/wabas/{WB}/exit

managedService.wabas.exit.createSDK operation postV1AccountsByAcManagedServiceWabasByWbExit

When balanceRequest is REFUND or TRANSFER, billing:write is also required. NONE or an omitted balanceRequest does not require that financial instruction scope.

Required scope: accounts:write.Additionally, every one of these scopes is required: accounts:write, exports:create, media:read, messages:read, contacts:read, contacts:read_identifiers, templates:read, conversations:read.Idempotency-Key required

Parameters

WBstring (WB… SID)Required

Request body

stepUpTokenstringRequired
balanceRequestenum
NONEREFUNDTRANSFER

POST /v1/accounts/{AC}/managed-service/wabas/{WB}/exit

curl -X POST "https://api.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/managed-service/wabas/WB.../exit" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "stepUpToken": "string"
}'

Responses

Request a hosted-exit prepaid balance refund or transfer

POST/v1/accounts/{AC}/managed-service/wabas/{WB}/exit/balance-request

managedService.wabas.exit.balanceRequestSDK operation postV1AccountsByAcManagedServiceWabasByWbExitBalanceRequest

Required scope: accounts:write.Additionally, every one of these scopes is required: accounts:write, billing:write.Idempotency-Key required

Parameters

WBstring (WB… SID)Required

Request body

kindenumRequired
REFUNDTRANSFER
amountMinorstring (pattern ^[1-9][0-9]{0,17}$)
destinationWalletIdstring (uuid)
sourceWalletIdstring (uuid)

POST /v1/accounts/{AC}/managed-service/wabas/{WB}/exit/balance-request

curl -X POST "https://api.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/managed-service/wabas/WB.../exit/balance-request" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "kind": "REFUND"
}'

Responses

Retry a failed or expired hosted-exit export

POST/v1/accounts/{AC}/managed-service/wabas/{WB}/exit/export

managedService.wabas.exit.exportSDK operation postV1AccountsByAcManagedServiceWabasByWbExitExport

Parameters

WBstring (WB… SID)Required

Request body

stepUpTokenstringRequired

POST /v1/accounts/{AC}/managed-service/wabas/{WB}/exit/export

curl -X POST "https://api.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/managed-service/wabas/WB.../exit/export" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "stepUpToken": "string"
}'

Responses

Confirm receipt of the hosted exit export

POST/v1/accounts/{AC}/managed-service/wabas/{WB}/exit/export-received

managedService.wabas.exit.exportReceivedSDK operation postV1AccountsByAcManagedServiceWabasByWbExitExportReceived

Required scope: accounts:write.Additionally, every one of these scopes is required: accounts:write, exports:create.Idempotency-Key required

Parameters

WBstring (WB… SID)Required

Request body

receivedtrueRequired

POST /v1/accounts/{AC}/managed-service/wabas/{WB}/exit/export-received

curl -X POST "https://api.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/managed-service/wabas/WB.../exit/export-received" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "received": "string"
}'

Responses