Submit a batch inference job

Submits a batch of queries for asynchronous processing. Returns immediately with a job ID that can be used to track progress and retrieve results…

POST /api/v1/jobs/batch-infer

cURL

curl --request POST \
  --url 'https://api.nsr.stateset.com/api/v1/jobs/batch-infer' \
  --header "X-API-Key: $STATESET_NSR_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "include_explanation": true,
  "inputs": [
    "string"
  ],
  "max_depth": 1
}'

202

{
  "job_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "status": "pending",
  "total_items": 1
}

Submits a batch of queries for asynchronous processing. Returns immediately with a job ID that can be used to track progress and retrieve results. Use Cases

• Processing large datasets that exceed single-request timeouts
• Running inference on multiple queries in parallel
• Background processing without blocking the client Example

curl -X POST 'https://api.nsr.stateset.com/api/v1/jobs/batch-infer' \
-H 'X-API-Key: your-api-key' \
-H 'Content-Type: application/json' \
-d '{'inputs': ['query 1', 'query 2', 'query 3'], 'max_depth': 5}'

Required scope: write

Request body

BatchInferRequest

include_explanation · boolean

Include explanations

inputs · string[] · required

List of input queries

max_depth · integer

Maximum reasoning depth

Response

JobSubmitResponse

job_id · string · required

Job identifier for tracking

status · JobStatus · required

total_items · integer · required

Estimated items to process

Status codes

Code	Meaning
202	Job submitted successfully
400	Invalid request - no inputs or too many items
401	Unauthorized — missing or invalid credentials
403	Forbidden — the key/token lacks the required scope
429	Rate limited — see Retry-After / X-RateLimit-Reset
503	Service unavailable - job queue full

cURL

curl --request POST \
  --url 'https://api.nsr.stateset.com/api/v1/jobs/batch-infer' \
  --header "X-API-Key: $STATESET_NSR_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "include_explanation": true,
  "inputs": [
    "string"
  ],
  "max_depth": 1
}'

202

{
  "job_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "status": "pending",
  "total_items": 1
}