Explain why a job is not running.

When dequeue is a policy decision, “it is available but not running” has a specific, knowable cause. Without this, a job held back by a misconfigured rate class is indistinguishable from a slow worker — which is the failure mode that makes operators distrust a limiter and turn it off.

GET /jobs/{id}/admission

Error

A valid request URL is required to generate request examples

200

{
  "admissible": true,
  "blocked_by": "rate_class",
  "detail": {},
  "estimated_admission_ms": 123
}

Path Parameters

id · string · required

Response

200 - application/json

Current admission decision and blocking policy details.

admissible · boolean · required

blocked_by · enum<string> | null

The policy currently preventing admission. Null means no policy is blocking the job: it may already be running, be pending promotion, or have reached a terminal state. Use detail.state to distinguish those lifecycle cases.

Available options: rate_class, concurrency_limit, fairness, quarantine, schedule, queue_paused, null

detail · object

State of the blocking policy — tokens left, position in the partition queue, crash count.

estimated_admission_ms · integer | null

Estimated wait when a time-based estimate can be calculated. Null means no estimate is available; it does not by itself mean the condition requires operator action.