Projects / Jobs

Get an upload job's status

The state of one upload job, the one /upload/complete returned.

The job record is written when processing starts, not when the upload returns, and when many uploads are queued that can take minutes. Until then, a job_id you got from an upload answers 404 with detail Job not found: keep polling it. Project not found is final.

Poll it every 5–10 seconds until status is final:

statusmeaning
PENDINGqueued, not started
RUNNINGbeing read; progress is 0–100
SUCCEEDEDdone; read the sheet with GET /v1/blueprints/{blueprint_id}
FAILEDcould not be read; see error_code and error_message
CANCELLEDstopped by POST …/cancel
ABANDONEDstopped by the system, for example after a timeout
get/v1/projects/{project_id}/jobs/{job_id}

Request

  • Base URL: https://api.kamai.io (the document declares no server; this is the origin it was published from)
  • URL: https://api.kamai.io/v1/projects/{project_id}/jobs/{job_id}
  • Auth: HTTP bearer

Path parameters

project_idstring required
job_idstring required

Response

Successful Response

messagestring

Changes

No recorded changes to this operation across all 1 revision of this API.