Enqueue an async document agent job

Create a long-running document agent job. Returns immediately with a job_id — use GET /document/agent/jobs/ to poll for the result or GET /document/agent/jobs//stream for live SSE updates.

Recommended for production workloads, batch evaluation pipelines, or anything that may run longer than ~10 minutes. The job runs on a background worker pool with 30-minute hard timeout, per-user concurrency caps, and automatic refunds on failure.

POST /document/agent/jobs

Enqueue an async document agent job

cURL

curl --request POST \
  --url https://apigcp.trynia.ai/v2/document/agent/jobs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "<string>",
  "source_id": "<string>",
  "source_ids": [
    "<string>"
  ],
  "json_schema": {},
  "model": "claude-opus-4-7",
  "thinking_enabled": true,
  "thinking_budget": 10000,
  "stream": false
}
'

200

{
  "job_id": "<string>",
  "status": "<string>",
  "created_at": "<string>",
  "message": "<string>"
}

Authorizations

Authorization · string · header · required

API key must be provided in the Authorization header

Body

application/json

Request for the v2 document/agent endpoint.

query · string · required

Question to ask about the document(s)

Required string length: 1 - 10000

source_id · string | null

Data source ID of a single indexed document

source_ids · string[] | null

List of data source IDs for multi-document queries (max 50)

Maximum array length: 50

json_schema · Json Schema · object

JSON Schema for structured output

model · string · default: claude-opus-4-7

Model to use (claude-opus-4-7, claude-sonnet-4-5-20250929, etc.)

thinking_enabled · boolean · default: true

Enable extended thinking

thinking_budget · integer · default: 10000

Token budget for thinking (ignored for adaptive models like Opus 4.7)

Required range: 1000 <= x <= 50000

stream · boolean · default: false

Stream response as SSE events

Response

200

application/json

Successful Response

Returned by POST /document/agent/jobs.

job_id · string · required

Workflow run id — pass to GET/stream/cancel endpoints

status · string · required

Initial status — usually 'queued'

created_at · string · required

message · string · required