Jobs

Poll async job status

Poll the status of a background job started by a long-running endpoint (v0.9.8+).

Status values:

  • queued — job is registered, worker starting soon
  • running — worker is executing (MCP polling in progress)
  • completed — result is available at resultUrl
  • error — worker failed; see error field

Polling strategy: start polling 5 s after submission, then every 10–30 s. Most jobs complete within 8–12 minutes.

get/api/jobs/:jobId/status

Request

  • Base URL: https://api.cernion.de
  • URL: https://api.cernion.de/api/jobs/:jobId/status
  • Auth: none declared

Path parameters

jobIdstring required
Example:a3f8b2c1-...

Job UUID returned by the 202 response

Query parameters

tokenstring

Optional Cernion MCP token as URL query parameter. If provided, it overrides CERNION_TOKEN for this request. Prefer Authorization Bearer header in production to reduce token exposure in URLs/logs.

Response

Job status record

jobIdstring
servicestring

Originating service name

actionstring

Originating action name

status'queued' | 'running' | 'recovery_pending' | 'completed' | 'error'
createdAtstring date-time
updatedAtstring date-time
completedAtstring date-time nullable
errorstring nullable
locationstring

URL of this status endpoint (for polling)

resultUrlstring nullable

Result URL — only set when status is "completed"

Changes

No recorded changes to this operation across all 2 revisions of this API.