`POST /v1/requests/exports`

Usa los campos de solicitud y permisos documentados para este endpoint HTTP.

Ejemplo de solicitud#

curl -X POST 'https://platform.tongai.io/v1/requests/exports' \  -H "Authorization: Bearer $TONG_API_KEY" \  -H "Content-Type: application/json" \  -H "Idempotency-Key: 45be69f1-c266-4a09-a82c-bf3c6303eb03" \  -d '{}'

Configuración

curl --version

Autenticación#

Usa una clave API en tu servidor para tu cuenta, u OAuth para la cuenta de cada cliente. Nunca envíes claves en instrucciones ni argumentos.

logs:read

Parámetros#

Idempotency-KeystringObligatorio

Un UUID, por ejemplo e8aa0a87-6cd9-42eb-975a-b72bf43218c8.

Cuerpo de solicitud#

application/json

fromstringOpcional

Fecha y hora ISO 8601, por ejemplo 2026-10-22T09:00:00Z.

tostringOpcional

Fecha y hora ISO 8601, por ejemplo 2026-10-22T09:00:00Z.

channelstringOpcional

Valores permitidos"api""mcp"

credential_idstringOpcional

Un ID hexadecimal de 24 caracteres.

toolstringOpcional

Longitud mínima: 1 caracteres.

Longitud máxima: 100 caracteres.

modelstringOpcional

Elige un ID de modelo público de Tong del descubrimiento actual.

Longitud mínima: 1 caracteres.

Longitud máxima: 150 caracteres.

categorystringOpcional

Longitud mínima: 1 caracteres.

Longitud máxima: 60 caracteres.

statestringOpcional

Valores permitidos"accepted""running""needs_review""paused""reconciling""succeeded""failed""cancelled"

searchstringOpcional

Longitud máxima: 150 caracteres.

activitystringOpcional

Valores permitidos"creative""all"

outcomestringOpcional

Valores permitidos"success""error""pending""cancelled"

beforestringOpcional

Un UUID, por ejemplo e8aa0a87-6cd9-42eb-975a-b72bf43218c8.

limitintegerOpcional

Mínimo: 1.

Máximo: 100.

Valor predeterminado: 40.

Esquema de respuesta#

Respuesta

JSON

{}

`HTTP 202`

application/json

idstringOpcional

Un UUID, por ejemplo e8aa0a87-6cd9-42eb-975a-b72bf43218c8.

statusJSONOpcional

Valores permitidos"queued""running""ready""failed"

rowsintegerOpcional

expires_atstringOpcional

Fecha y hora ISO 8601, por ejemplo 2026-10-22T09:00:00Z.

Errores y límites#

HTTP	Error	Recuperación
`400`	Solicitud no válida`REQUEST_INVALID`	Corrige los campos indicados por el error antes de reintentar.
`401`	Credencial no válida`CREDENTIAL_INVALID`	Comprueba la credencial, su vencimiento y si fue revocada.
`402`	Créditos insuficientes`INSUFFICIENT_CREDITS`	Añade créditos a la cuenta de la credencial y continúa el trabajo guardado.
`403`	Permiso denegado`SCOPE_REQUIRED`	Usa una credencial con los permisos necesarios y acceso al recurso seleccionado.
`404`	Recurso no disponible`RESOURCE_UNAVAILABLE`	Comprueba el ID del recurso y que pertenezca a la cuenta autorizada.
`409`	Conflicto de intención`IDEMPOTENCY_CONFLICT`	Reutiliza una intención solo con su solicitud original. Usa un nuevo UUID para otra acción.
`429`	Límite de solicitudes alcanzado`RATE_LIMITED`	Espera el intervalo de Retry-After antes de reintentar la misma solicitud.
`503`	No disponible temporalmente`DEPENDENCY_UNAVAILABLE`	Espera Retry-After y reintenta con la misma intención. Consulta la operación guardada tras un tiempo de espera.

AutenticaciónLas claves API cobran a la cuenta propietaria. OAuth permite a cada usuario conectado usar sus créditos.Errores y límites de solicitudesComprende los errores, reintenta de forma segura y recupera generaciones fallidas.Solicitudes y registrosUna solicitud aceptada no es una generación terminada. Sigue el trabajo hasta que el resultado esté listo.