Skip to main content
PATCH
Extend a Domain pause's scheduled resume

Authorizations

X-API-Key
string
header
required

Path Parameters

tenancy_id
string
required
pause_id
string
required

Body

application/json

Push a pause's scheduled resume further out.

Provide duration_seconds (relative to now) or an absolute expires_at — at least one is required. Extension is forward-only: a hold can never be silently shortened, only released and re-opened.

duration_seconds
integer | null
Required range: 1 <= x <= 604800
expires_at
string<date-time> | null

Response

Successful Response

One hold on dispatch — an admin hold or an automatic backoff.

Both kinds share this one shape, so a single listing shows everything currently holding dispatch. scope says how much is held and the matching target field (tenancy_id, lane, bucket, or batch_id) says exactly what. cause is the machine-readable origin (admin_request for a human hold, the provider fault tag for an automatic backoff) and reason is the human note, if any. A released pause keeps its record: released_at and released_by complete the audit trail, and extensions lists every time a scheduled resume was pushed out.

id
string
required
scope
string
required
tenancy_id
string | null
required
bucket
string | null
required
lane
string | null
required
batch_id
string | null
required
status
string
required
cause
string
required
reason
string | null
required
created_by
string
required
created_at
string<date-time>
required
expires_at
string<date-time> | null
required
released_at
string<date-time> | null
required
released_by
string | null
required
extensions
Extensions · object[]
required