Poll an Agent Run
Fetch an Agent run submitted by post_exa_agent_runs, by its jobId.
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
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
The job id returned by the submit call.
Response
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).
Unique AIsa job identifier. Use it to poll, list, or cancel the job.
"iaj_01HZY8Q2M4K7N9V3T6W1X0B2C3"
Always "integration_async_job".
"integration_async_job"
The submit endpoint this job belongs to.
"/apis/v1/exa/agent/runs"
Customer-facing lifecycle status. queued and running are non-terminal; completed, failed, and cancelled are terminal.
queued, running, completed, failed, cancelled When the job was accepted.
When the job reached a terminal status. Null while the job is still queued or running.
Job result payload. Present only once status is completed. For Agent Runs this is the structured research result.
True when the result has been retained past its retention window and is no longer retrievable.
Present when status is failed. Null otherwise.