Skip to main content
POST
Resume a paused build
It continues as the same job and uses no extra quota.
  • Ask the user first: resuming is their decision.
  • A build paused on a question resumes only when its question is answered (POST /v1/jobs/{id}/answers).
  • A pause past its pause.expires_at has ended the build.
  • Callers: an API key, an integration’s API key, an MCP OAuth token or a Dashboard session.
  • Permission: jobs:cancel.
  • Effect: Creates or changes something.
  • Errors: not_found, not_paused, pause_expired, and the errors any request can get.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required

a job ID: job_ and 32 lowercase hex digits

Example:

"job_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190"

Response

The build, queued again

id
string
required

a job ID: job_ and 32 lowercase hex digits

Example:

"job_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190"

type
enum<string>
required
Available options:
run,
build
status
enum<string>
required
Available options:
queued,
running,
needs_input,
paused,
succeeded,
failed,
cancelled
tool_id
string | null
required
input_request
object | null
required
result
any
required
result_status
enum<string> | null
required
Available options:
available,
delivered,
expired
result_expires_at
string | null
required

a string to be decoded into a Date

write_status
enum<string> | null
required

Whether a write tool's run, or a write build, changed the website. Null for a read, or while a repair is still working on a run's write that may have applied: the repair may still complete it, and once it ends this says what happened

Available options:
not_attempted,
may_have_applied,
applied,
not_applied
login_save
object | null
required
error
object | null
required
message
string | null
required
maintenance
object | null
required
build
object | null
required
watch_url
string
required
created_at
string
required

a string to be decoded into a Date

updated_at
string
required

a string to be decoded into a Date

completed_at
string | null
required

a string to be decoded into a Date

pause
object
result_file
object | null
result_preview
any
write_progress
enum<string> | null
Available options:
no_change,
signed_in_only,
may_have_submitted,
submitted
stop_reason
enum<string>

Why a job told to stop stops, present while it stops (status running) and once it ended cancelled: cancel_requested when a cancel of this job arrived (from its caller, the account's owner or Pomerado support), access_revoked when the access that started it was revoked (its app's connection, API key, session or access to its saved login), account_deleted, or logins_unavailable when the account's saved logins became unavailable. Absent otherwise, and from an older backend

Available options:
cancel_requested,
access_revoked,
account_deleted,
logins_unavailable
stopped_after
string

A write that succeeded with the website's refusal after an earlier step: that step's name. The website may have kept something from it, as message says

site_url
string | null

The website's https origin the job was asked for: a build's site_url, or the site of the tool a run runs

site_name
string | null

The site's name: its tool's integration's; null until the job has a tool, such as a build that hasn't published yet

task
string | null

A build's task, or a requested change, as it was sent; null for a run and a job accepted before Pomerado kept tasks

tool_name
string | null

The name of the tool tool_id names, as GET /v1/tools shows it

waiting_since
string | null

When the question input_request asks was asked; null when the job asks none

answered_questions
object[]

The questions the job asked and its member answered, oldest first; a secret, login or code shows only that it was answered

warnings
object[]

What to tell the person about a build or requested change, as is, or, on the answer that accepted a run, about its call. Absent when there is none

tip
string