Jobs - Exo

What this family does

Every asynchronous route in the API produces a job, and every job resolves to the same Job shape here. That is what makes this family the one place to watch background work, rather than three per-family status endpoints. Jobs are keyset-paginated newest first. The result block on a finished job reports what the work produced: nodesCreated, edgesCreated, domainsDetected.

Routes

Method	Path	Scope	What it does
`GET`	`/v1/jobs`	`read`	List jobs
`GET`	`/v1/jobs/{job_id}`	`read`	Get a job
`POST`	`/v1/jobs/{job_id}/cancel`	`write`	Cancel a pending job

The shape of a call

Poll a job.

curl https://api.get-exo.com/v1/jobs/b1f0c6d2-8a44-4b21-9a1e-6d1f0c6d28a441a8 \
  -H "X-Exo-API-Key: $EXO_KEY"

import httpx

response = httpx.get(
    "https://api.get-exo.com/v1/jobs/b1f0c6d2-8a44-4b21-9a1e-6d1f0c6d28a441a8",
    headers={"X-Exo-API-Key": EXO_KEY},
)
job = response.json()

const response = await fetch("https://api.get-exo.com/v1/jobs/b1f0c6d2-8a44-4b21-9a1e-6d1f0c6d28a441a8", {
  headers: { "X-Exo-API-Key": process.env.EXO_KEY! },
});
const job = await response.json();

The response:

{
  "id": "b1f0c6d2-8a44-4b21-9a1e-6d1f0c6d28a441a8",
  "jobType": "ingest",
  "status": "succeeded",
  "createdAt": "2026-07-14T09:12:03Z",
  "completedAt": "2026-07-14T09:12:47Z",
  "error": null,
  "result": { "nodesCreated": 1, "edgesCreated": 3, "domainsDetected": 1 }
}

Traps

done surfaces as succeeded. The internal status vocabulary is mapped to a public one. Read succeeded, failed, canceled, running and pending. Another member’s job is 404, not 403. Jobs cannot be probed. An admin key sees the whole organization; every other key sees its own jobs plus those of provisioned subjects. Cancel only reaches pending work. A job the worker has claimed returns 409 job_not_cancelable. Cancellation never interrupts work in flight.

API reference

Base URL, authentication, and the conventions every route shares.

Errors

The problem envelope and the full code catalogue.

​What this family does

​Routes

​The shape of a call

​Traps

​Related