Operations

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

GETList asynchronous operationsoperations.list
GETFetch an asynchronous operationoperations.retrieve
POSTCancel an asynchronous operationoperations.cancel
GETList per-item operation resultsoperations.children.list
GETFetch a completed operation resultoperations.result.list
POSTRetry an asynchronous operationoperations.retry
POSTRetry an asynchronous operationoperations.retryRows

List asynchronous operations

GET/v1/accounts/{AC}/operations

operations.listSDK operation getV1AccountsByAcOperations

Required scope: operations:read.Paginated

Parameters

limitinteger (1–100)query
cursorstring (max 2048 chars)query
sortenumquery
createdAt-createdAt
typestring (max 64 chars)query
statestring (max 64 chars)query

GET /v1/accounts/{AC}/operations

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

Responses

Fetch an asynchronous operation

GET/v1/accounts/{AC}/operations/{OP}

operations.retrieveSDK operation getV1AccountsByAcOperationsByOp

Required scope: operations:read.

Parameters

OPstring (OP… SID)Required

GET /v1/accounts/{AC}/operations/{OP}

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

Responses

Cancel an asynchronous operation

POST/v1/accounts/{AC}/operations/{OP}/cancel

operations.cancelSDK operation postV1AccountsByAcOperationsByOpCancel

Required scope: operations:write.Idempotency-Key required

Parameters

OPstring (OP… SID)Required

POST /v1/accounts/{AC}/operations/{OP}/cancel

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

Responses

List per-item operation results

GET/v1/accounts/{AC}/operations/{OP}/children

operations.children.listSDK operation getV1AccountsByAcOperationsByOpChildren

Required scope: operations:read.Paginated

Parameters

OPstring (OP… SID)Required
limitinteger (1–100)query
cursorstring (max 2048 chars)query

GET /v1/accounts/{AC}/operations/{OP}/children

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

Responses

Fetch a completed operation result

GET/v1/accounts/{AC}/operations/{OP}/result

operations.result.listSDK operation getV1AccountsByAcOperationsByOpResult

Required scope: operations:read.

Parameters

OPstring (OP… SID)Required

GET /v1/accounts/{AC}/operations/{OP}/result

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

Responses

Retry an asynchronous operation

POST/v1/accounts/{AC}/operations/{OP}/retry

operations.retrySDK operation postV1AccountsByAcOperationsByOpRetry

Required scope: operations:write.Idempotency-Key required

Parameters

OPstring (OP… SID)Required

POST /v1/accounts/{AC}/operations/{OP}/retry

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

Responses

Retry an asynchronous operation

POST/v1/accounts/{AC}/operations/{OP}/retry-rows

operations.retryRowsSDK operation postV1AccountsByAcOperationsByOpRetryRows

Required scope: operations:write.Idempotency-Key required

Parameters

OPstring (OP… SID)Required

Request body

rowNumbersinteger (1–)[]Required

POST /v1/accounts/{AC}/operations/{OP}/retry-rows

curl -X POST "https://api.staging.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/operations/OP.../retry-rows" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "rowNumbers": []
}'

Responses