`POST /v1/requests/exports`

Use os campos e permissões documentados para este endpoint HTTP.

Exemplo de solicitação#

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 '{}'

Configuração

curl --version

Autenticação#

Use uma chave API no servidor para sua conta, ou OAuth para a conta de cada cliente. Nunca envie chaves em prompts ou argumentos.

logs:read

Parâmetros#

Idempotency-KeystringObrigatório

Um UUID, por exemplo e8aa0a87-6cd9-42eb-975a-b72bf43218c8.

Corpo da solicitação#

application/json

fromstringOpcional

Data e hora ISO 8601, por exemplo 2026-10-22T09:00:00Z.

tostringOpcional

Data e hora ISO 8601, por exemplo 2026-10-22T09:00:00Z.

channelstringOpcional

Valores permitidos"api""mcp"

credential_idstringOpcional

Um ID hexadecimal de 24 caracteres.

toolstringOpcional

Comprimento mínimo: 1 caracteres.

Comprimento máximo: 100 caracteres.

modelstringOpcional

Escolha um ID de modelo público Tong da descoberta atual.

Comprimento mínimo: 1 caracteres.

Comprimento máximo: 150 caracteres.

categorystringOpcional

Comprimento mínimo: 1 caracteres.

Comprimento máximo: 60 caracteres.

statestringOpcional

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

searchstringOpcional

Comprimento máximo: 150 caracteres.

activitystringOpcional

Valores permitidos"creative""all"

outcomestringOpcional

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

beforestringOpcional

Um UUID, por exemplo e8aa0a87-6cd9-42eb-975a-b72bf43218c8.

limitintegerOpcional

Mínimo: 1.

Máximo: 100.

Padrão: 40.

Esquema de resposta#

Resposta

JSON

{}

`HTTP 202`

application/json

idstringOpcional

Um UUID, por exemplo e8aa0a87-6cd9-42eb-975a-b72bf43218c8.

statusJSONOpcional

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

rowsintegerOpcional

expires_atstringOpcional

Data e hora ISO 8601, por exemplo 2026-10-22T09:00:00Z.

Erros e limites#

HTTP	Erro	Recuperação
`400`	Solicitação inválida`REQUEST_INVALID`	Corrija os campos indicados pelo erro antes de tentar novamente.
`401`	Credencial inválida`CREDENTIAL_INVALID`	Verifique a credencial, a validade e se foi revogada.
`402`	Créditos insuficientes`INSUFFICIENT_CREDITS`	Adicione créditos à conta da credencial e continue o trabalho salvo.
`403`	Permissão negada`SCOPE_REQUIRED`	Use uma credencial com os escopos necessários e acesso ao recurso selecionado.
`404`	Recurso indisponível`RESOURCE_UNAVAILABLE`	Verifique o ID do recurso e se pertence à conta autorizada.
`409`	Conflito de intenção`IDEMPOTENCY_CONFLICT`	Reutilize uma intenção apenas com a solicitação original. Use um novo UUID para outra ação.
`429`	Limite de requisições atingido`RATE_LIMITED`	Aguarde o prazo de Retry-After antes de repetir a mesma solicitação.
`503`	Temporariamente indisponível`DEPENDENCY_UNAVAILABLE`	Aguarde Retry-After e repita com a mesma intenção. Verifique a operação salva após um tempo limite.

AutenticaçãoAs chaves de API cobram da conta proprietária. O OAuth permite que cada usuário conectado use seus créditos.Erros e limites de requisiçõesEntenda os erros, tente novamente com segurança e recupere gerações com falha.Solicitações e registrosUma solicitação aceita não é uma geração concluída. Acompanhe o trabalho até o resultado estar pronto.