Skip to content

Set a job type's concurrency cap

PUT
/admin/jobs/concurrency/{type}

Upsert one per-type cap (#401). cap of 0 clears it (uncapped). Takes effect on the next restart (the Pool loads caps at boot). Gated on system.admin.

type
required
string

The job type, e.g. preview.video.

object
cap
required

Max concurrent; 0 clears the cap (uncapped).

integer
<= 64

Cap saved.

Malformed request

object
error
required

Human-readable error summary

string
Example
the request could not be completed

Authentication required, missing, or invalid

object
error
required

Human-readable error summary

string
Example
the request could not be completed
Example
{
"error": "authentication required: sign in and retry with a valid session or API token"
}

Authenticated but missing required capabilities

object
error
required

Human-readable error summary

string
Example
the request could not be completed