Support

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

GETList delegated support-access grantssupportAccess.list
POSTCreate single-use customer consent for delegated support accesssupportAccess.consents
GETQuarterly delegated-access reviewsupportAccess.review.list
GETGet a delegated support-access grantsupportAccess.retrieve
POSTEnd delegated support accesssupportAccess.end
GETList support cases for the customer accountsupportCases.list
POSTOpen a support casesupportCases.create
GETGet a support case and its related audit trailsupportCases.retrieve
POSTClose a support casesupportCases.close
POSTReply to a support casesupportCases.messages
GETRead separately quoted post-Assisted Meta labor; ticket intake is freesupportCases.metaLabor.list
POSTAccept one exact additional Meta labor quote without starting or charging worksupportCases.metaLabor.accept
POSTReopen a resolved or closed support casesupportCases.reopen

List delegated support-access grants

GET/v1/accounts/{AC}/support-access

supportAccess.listSDK operation getV1AccountsByAcSupportAccess

Required scope: any one of support_access:grant, audit:read.Paginated

Parameters

stateenumquery
activehistoryall
limitinteger (1–100)query
cursorstring (max 2048 chars)query

GET /v1/accounts/{AC}/support-access

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

Responses

Create single-use customer consent for delegated support access

POST/v1/accounts/{AC}/support-access/consents

supportAccess.consentsSDK operation postV1AccountsByAcSupportAccessConsents

Required scope: support_access:grant.Idempotency-Key required

Request body

caseRefstring (max 128 chars)Required
scopesstring (max 64 chars)[]Required
stepUpTokenstring (max 256 chars)Required

POST /v1/accounts/{AC}/support-access/consents

curl -X POST "https://api.staging.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/support-access/consents" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "caseRef": "string",
  "scopes": [],
  "stepUpToken": "string"
}'

Responses

Quarterly delegated-access review

GET/v1/accounts/{AC}/support-access/review

supportAccess.review.listSDK operation getV1AccountsByAcSupportAccessReview

Required scope: audit:read.

GET /v1/accounts/{AC}/support-access/review

curl "https://api.staging.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/support-access/review" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21"

Responses

Get a delegated support-access grant

GET/v1/accounts/{AC}/support-access/{grantId}

supportAccess.retrieveSDK operation getV1AccountsByAcSupportAccessByGrantid

Required scope: any one of support_access:grant, audit:read.

Parameters

grantIdstring (uuid)Required

GET /v1/accounts/{AC}/support-access/{grantId}

curl "https://api.staging.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/support-access/grantId..." \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21"

Responses

End delegated support access

POST/v1/accounts/{AC}/support-access/{grantId}/end

supportAccess.endSDK operation postV1AccountsByAcSupportAccessByGrantidEnd

Required scope: any one of support_access:grant, support_access:request.Idempotency-Key required

Parameters

grantIdstring (uuid)Required

POST /v1/accounts/{AC}/support-access/{grantId}/end

curl -X POST "https://api.staging.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/support-access/grantId.../end" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21" \
  -H "Idempotency-Key: $(uuidgen)"

Responses

List support cases for the customer account

GET/v1/accounts/{AC}/support-cases

supportCases.listSDK operation getV1AccountsByAcSupportCases

Required scope: any one of support_access:grant, audit:read.Paginated

Parameters

limitinteger (1–100)query
cursorstring (max 2048 chars)query

GET /v1/accounts/{AC}/support-cases

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

Responses

Open a support case

POST/v1/accounts/{AC}/support-cases

supportCases.createSDK operation postV1AccountsByAcSupportCases

Required scope: support_access:grant.Idempotency-Key required

Request body

kindenumRequired
AMBIGUOUS_SENDBILLINGIDENTITYMETA_ASSETPRIVACYINCIDENTGENERAL
priorityenumRequired
P0P1P2P3
summarystring (max 500 chars)Required
resourceRefstring (max 128 chars)

POST /v1/accounts/{AC}/support-cases

curl -X POST "https://api.staging.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/support-cases" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "kind": "AMBIGUOUS_SEND",
  "priority": "P0",
  "summary": "string"
}'

Responses

Get a support case and its related audit trail

GET/v1/accounts/{AC}/support-cases/{CS}

supportCases.retrieveSDK operation getV1AccountsByAcSupportCasesByCs

Required scope: any one of support_access:grant, audit:read.

Parameters

CSstring (CS… SID)Required

GET /v1/accounts/{AC}/support-cases/{CS}

curl "https://api.staging.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/support-cases/CS..." \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21"

Responses

Close a support case

POST/v1/accounts/{AC}/support-cases/{CS}/close

supportCases.closeSDK operation postV1AccountsByAcSupportCasesByCsClose

Required scope: support_access:grant.Idempotency-Key required

Parameters

CSstring (CS… SID)Required

Request body

bodystring (max 5000 chars)

POST /v1/accounts/{AC}/support-cases/{CS}/close

curl -X POST "https://api.staging.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/support-cases/CS.../close" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21" \
  -H "Idempotency-Key: $(uuidgen)"

Responses

Reply to a support case

POST/v1/accounts/{AC}/support-cases/{CS}/messages

supportCases.messagesSDK operation postV1AccountsByAcSupportCasesByCsMessages

Required scope: support_access:grant.Idempotency-Key required

Parameters

CSstring (CS… SID)Required

Request body

bodystring (max 5000 chars)Required

POST /v1/accounts/{AC}/support-cases/{CS}/messages

curl -X POST "https://api.staging.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/support-cases/CS.../messages" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "body": "string"
}'

Responses

Read separately quoted post-Assisted Meta labor; ticket intake is free

GET/v1/accounts/{AC}/support-cases/{CS}/meta-labor

supportCases.metaLabor.listSDK operation getV1AccountsByAcSupportCasesByCsMetaLabor

Required scope: any one of support_access:grant, audit:read.

Parameters

CSstring (CS… SID)Required

GET /v1/accounts/{AC}/support-cases/{CS}/meta-labor

curl "https://api.staging.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/support-cases/CS.../meta-labor" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21"

Responses

Accept one exact additional Meta labor quote without starting or charging work

POST/v1/accounts/{AC}/support-cases/{CS}/meta-labor/{quoteId}/accept

supportCases.metaLabor.acceptSDK operation postV1AccountsByAcSupportCasesByCsMetaLaborByQuoteidAccept

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

Parameters

CSstring (CS… SID)Required
quoteIdstring (uuid)Required

Request body

acceptFeetrueRequired
amountMinorstring (pattern ^[0-9]+$)Required
currencystringRequired
feeVersioninteger (1–)Required
scaleinteger (0–9)Required

POST /v1/accounts/{AC}/support-cases/{CS}/meta-labor/{quoteId}/accept

curl -X POST "https://api.staging.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/support-cases/CS.../meta-labor/quoteId.../accept" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "acceptFee": "string",
  "amountMinor": "string",
  "currency": "string",
  "feeVersion": 1,
  "scale": 0
}'

Responses

Reopen a resolved or closed support case

POST/v1/accounts/{AC}/support-cases/{CS}/reopen

supportCases.reopenSDK operation postV1AccountsByAcSupportCasesByCsReopen

Required scope: support_access:grant.Idempotency-Key required

Parameters

CSstring (CS… SID)Required

Request body

bodystring (max 5000 chars)

POST /v1/accounts/{AC}/support-cases/{CS}/reopen

curl -X POST "https://api.staging.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/support-cases/CS.../reopen" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21" \
  -H "Idempotency-Key: $(uuidgen)"

Responses