Poll a bulk job for state, summary and per-record outcomes

GET 
/v2/jobs/:jobId

Works for both incident-bulk and event-bulk jobs (the job id is opaque and self-routing). Job lifecycle: queued, then running, then a terminal completed or failed. Poll until the state is terminal. A failed state means the job itself could not run to completion; per-record problems inside a job that completes surface as outcome: failed records instead, so check both levels. Use outcome=failed to triage failed records.

Records are returned with cursor-based pagination: pass page_info.next_cursor from one page as the cursor parameter of the next, until has_more is false.

Request

Responses

200

Current job state and a page of per-record outcomes.

401

UNAUTHORIZED: missing or invalid bearer token, or wrong token type for a write route.

403

Access denied. Possible codes are ACCESS_DENIED, TWO_WAY_DISABLED, MODULE_ACCESS_DENIED, INCIDENT_ARCHIVED, org/user inactive, or integration configuration inactive.

404

Target entity (or job) not found in the token's org tree.

429

RATE_LIMIT_EXCEEDED: the per-token budget is exhausted. Back off per the Retry-After header.

Response Headers

Retry-After

Seconds to wait before retrying.