Poll an Agent Run

Fetch an Agent run submitted by post_exa_agent_runs, by its jobId.

GET https://api.aisa.one/apis/v1/exa/agent/runs/{jobId}

Poll a research Agent run.

cURL

curl --request GET \
  --url https://api.aisa.one/apis/v1/exa/agent/runs/{jobId} \
  --header 'Authorization: Bearer <token>'

200

{
  "id": "iaj_01HZY8Q2M4K7N9V3T6W1X0B2C3",
  "object": "integration_async_job",
  "endpoint": "/apis/v1/exa/agent/runs",
  "createdAt": "2023-11-07T05:31:56Z",
  "completedAt": "2023-11-07T05:31:56Z",
  "pricing": {
    "currency": "USD",
    "authorizedMicrosUSD": 123,
    "finalMicrosUSD": 123,
    "billingMode": "flat_per_call"
  },
  "output": "<unknown>",
  "outputExpired": true,
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

Fetch an Agent run submitted by post_exa_agent_runs, by its jobId. Returns the same envelope — id, status, createdAt, completedAt, pricing, output, error. Repeat until status is completed, failed or cancelled; on success output carries text, structured and grounding. Reads a run only; it cannot start one.

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

jobId · string · required

The job id returned by the submit call.

Response

200 - application/json

The current state of the research run.

An asynchronous integration job. Returned by the submit call (HTTP 202) and by the poll/detail call. Poll the job by its id until status is a terminal value (completed, failed, or cancelled).

id · string

Unique AIsa job identifier. Use it to poll, list, or cancel the job.

Example:

"iaj_01HZY8Q2M4K7N9V3T6W1X0B2C3"

object · string

Always "integration_async_job".

Example:

"integration_async_job"

endpoint · string

The submit endpoint this job belongs to.

Example:

"/apis/v1/exa/agent/runs"

status · enum<string>

Customer-facing lifecycle status. queued and running are non-terminal; completed, failed, and cancelled are terminal.

Available options: queued, running, completed, failed, cancelled

createdAt · string<date-time>

When the job was accepted.

completedAt · string<date-time> | null

When the job reached a terminal status. Null while the job is still queued or running.

pricing · object

Show child attributes

output · any | null

Job result payload. Present only once status is completed. For Agent Runs this is the structured research result.

outputExpired · boolean

True when the result has been retained past its retention window and is no longer retrievable.

error · object | null

Present when status is failed. Null otherwise.

Show child attributes