get_analyst_job
Read-only
Check the status and result of an ask_analyst job by job_id. Get the finished brief, structured summary, and quality flags after processing completes.
Instructions
Fetch the status and result of an ask_analyst run by job_id. Job status is ONLY "processing" (still running — poll again in ~10-20s), "done" (with the finished brief and meta.tokens), or "error". When done, result_quality.status ("complete" | "partial", with any issues[]) reports whether the structured output is fully populated — this is SEPARATE from the job status (a done job can carry a partial result). Free of token charges — the run itself is charged once on completion. A job is visible only to the API key owner that created it.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| job_id | Yes | The job_id returned by ask_analyst. | |
| response_format | No | "full" (default) returns the prose brief alongside the structured result. "compact" omits the prose brief and returns only the structured result — which still carries the assembled structured_summary — so a re-fetch costs materially fewer context tokens. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| meta | No | Query echo, token charge/balance (meta.tokens), and pagination where applicable. | |
| brief | No | ||
| error | No | Failure reason when status is "error". | |
| job_id | No | ||
| status | No | "processing" | "done" | "error". | |
| message | No | ||
| progress | No | Pipeline progress while the job is processing. completed_steps reaches total_steps ONLY when status is "done". | |
| created_at | No | ||
| updated_at | No |