Poll an async job's status
GET /v1/jobs/{job_id}
GET
/v1/jobs/{job_id}
Poll the status of an async job the agent enqueued (currently the domain-offboard teardown returned by DELETE /v1/domains/{domain}). Status is terminal on succeeded, failed, or cancelled. Tenant-scoped: another customer’s (or an unknown) job id is a 404.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ” job_id
required
string
Responses
Section titled “ Responses ”Ok
object
object
required
string
Example
job id
required
string
type
required
string
status
required
string
created_at
required
string format: date-time
updated_at
required
string format: date-time
finished_at
string format: date-time
Missing or invalid credential.
The canonical error envelope. error is a stable machine code.
object
error
required
Stable error code (e.g. unauthorized, forbidden, not_found, invalid, quota_exceeded, rate_limited).
string
Example
forbidden message
Human-readable detail (never leaks internals).
string
Example
missing required scopeResource not found.
The canonical error envelope. error is a stable machine code.
object
error
required
Stable error code (e.g. unauthorized, forbidden, not_found, invalid, quota_exceeded, rate_limited).
string
Example
forbidden message
Human-readable detail (never leaks internals).
string
Example
missing required scope