`GET /v1/requests`

Read the selected owned resource or current workflow state without starting a new generation.

Request example#

curl 'https://platform.tongai.io/v1/requests' \  -H "Authorization: Bearer $TONG_API_KEY"

Configuration

curl --version

Authentication#

Use a server-side API key for your account, or OAuth for each customer’s account. Never send keys in prompts or tool arguments.

logs:read

Parameters#

fromstringOptional

ISO 8601 date and time, for example 2026-10-22T09:00:00Z.

tostringOptional

ISO 8601 date and time, for example 2026-10-22T09:00:00Z.

channelstringOptional

Allowed values"api""mcp"

credential_idstringOptional

A 24-character hexadecimal ID.

toolstringOptional

Minimum length: 1 characters.

Maximum length: 100 characters.

modelstringOptional

Choose a public Tong model ID from current discovery.

Minimum length: 1 characters.

Maximum length: 150 characters.

categorystringOptional

Minimum length: 1 characters.

Maximum length: 60 characters.

statestringOptional

Allowed values"accepted""running""needs_review""paused""reconciling""succeeded""failed""cancelled"

searchstringOptional

Maximum length: 150 characters.

activitystringOptional

Allowed values"creative""all"

outcomestringOptional

Allowed values"success""error""pending""cancelled"

beforestringOptional

A UUID, for example e8aa0a87-6cd9-42eb-975a-b72bf43218c8.

limitintegerOptional

Minimum: 1.

Maximum: 100.

Default: 40.

Request body#

This endpoint has no request body.

Response schema#

Response

JSON

{}

`HTTP 200`

application/json

object

Errors and limits#

HTTP	Error	Recovery
`400`	Invalid request`REQUEST_INVALID`	Correct the fields identified by the error before trying again.
`401`	Invalid credential`CREDENTIAL_INVALID`	Check the credential, its expiry and whether it has been revoked.
`402`	Insufficient credits`INSUFFICIENT_CREDITS`	Add credits to the account that owns the credential, then continue the saved work.
`403`	Permission denied`SCOPE_REQUIRED`	Use a credential with the required scopes and access to the selected resource.
`404`	Resource unavailable`RESOURCE_UNAVAILABLE`	Check the resource ID and that it belongs to the authorized account.
`409`	Intent conflict`IDEMPOTENCY_CONFLICT`	Reuse an intent only with its original request. Use a new UUID for a different action.
`429`	Rate limited`RATE_LIMITED`	Wait for Retry-After before retrying the same intended request.
`503`	Temporarily unavailable`DEPENDENCY_UNAVAILABLE`	Wait for Retry-After and retry with the same intent. Check the saved operation after a timeout.

AuthenticationAPI keys charge the account that owns the key. OAuth lets each connected user use their own credits.Errors and rate limitsUnderstand error responses, retry safely and recover from failed generations.Requests and logsAn accepted request is not a finished generation. Track the saved job until its output is ready.