Skip to content

Pause jobs of one type

POST
/api/v1/admin/jobs/{kind}/pause
curl --request POST \
--url https://example.com/api/v1/admin/jobs/example/pause \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "reason": "example" }'

Pauses the jobs of one type. It requires a signed-in User with the admin scope and the admin or owner Role. It can return 400 if the request is invalid, 401 if the session is missing or expired, 403 if access is denied, 404 if the requested item does not exist and 503 if the service is temporarily unavailable. Route: /api/v1/admin/jobs/{kind}/pause. Inputs: kind. A recent account assertion is required. Do not automatically replay this operation after an uncertain result.

kind
required
string
Media typeapplication/json
object
reason
required
string
Examplegenerated
{
"reason": "example"
}
Media typeapplication/json
object
kind
required
string
paused
required
boolean
paused_at
string | null
reason
string | null
Examplegenerated
{
"kind": "example",
"paused": true,
"paused_at": "example",
"reason": "example"
}