Get team job

Why `/team-jobs/`, not `/jobs/`

Team jobs live under /team-jobs/:jobId, a different path from the agent job endpoints at /jobs/:jobId. This is deliberate: /jobs/:jobId is already registered for agent async jobs, and a server can't register two different handlers for the same method and path. /team-jobs/:jobId avoids that collision while keeping the same resource-scoped-job convention the agent path already uses.

Returns the current state of an async job created by POST /run-async.

GET /api/v1/team-jobs/{jobId}

Path parameters

Parameter	Type	Description
`jobId`	string (UUID)	The job ID returned by `run-async`.

Response

200 OK

{
  "jobId": "9c4e2a1b-...",
  "teamId": "3f9c...",
  "status": "completed",
  "createdAt": 1732550123,
  "startedAt": 1732550124,
  "completedAt": 1732550131,
  "result": {
    "content": "...",
    "sessionId": "...",
    "userId": "...",
    "metrics": {
      "inputTokens": 12,
      "outputTokens": 9,
      "latencyMs": 842,
      "model": null,
      "failoverUsed": false
    },
    "messages": null
  },
  "error": null
}

Field	Description
`status`	`queued`, `running`, `completed`, `failed`, `timeout`, or `cancelled`.
`startedAt` / `completedAt`	Unix timestamps (seconds), or `null` until reached.
`result`	The run's result — only populated when `status` is `completed`. `null` for every other status, including while it's still running. Same `content`/`sessionId`/`userId`/`metrics`/`messages` shape as `/run-sync`'s response — `messages` is `null` unless the original request set `include_messages: true`.
`error`	The failure message — only populated when `status` is `failed` or `timeout`. `null` otherwise.

Keep polling while status is queued or running; stop once it's completed, failed, timeout, or cancelled. See Recommended polling interval.

Errors

Status	`error`	When
`404`	`job_not_found`	No job with that ID exists for your organization or your key's project. This includes jobs that exist but belong to a different tenant — Elizon returns `404`, not `403`, so a job ID never confirms another tenant's job exists.

Example

curl https://api.elizon.ai/api/v1/team-jobs/9c4e2a1b-... \
  -H "X-API-Key: elz_your_key_here"

To cancel a job, see Cancel team job.