> ## Documentation Index > Fetch the complete documentation index at: https://docs.pomerado.ai/llms.txt > Use this file to discover all available pages before exploring further. # Resume a paused build > Resume a paused build whose pause.resume_by is resume. > [accordion] Details > > 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`](https://docs.pomerado.ai/errors#not_found), [`not_paused`](https://docs.pomerado.ai/errors#not_paused), [`pause_expired`](https://docs.pomerado.ai/errors#pause_expired), and the [errors any request can get](https://docs.pomerado.ai/errors.md). ## OpenAPI ````yaml /api-reference/openapi.json post /v1/jobs/{id}/resume openapi: 3.1.0 info: title: Pomerado API version: '1' description: >- Run and build website tools, follow their jobs, and manage logins, API keys and webhooks. Authenticate with a Pomerado API key (pom_…), an MCP OAuth token or a Dashboard session as a Bearer token. servers: - url: https://api.pomerado.ai security: [] tags: - name: account x-group: Account - name: api_keys x-group: API keys - name: connected_apps x-group: Connected apps - name: usage x-group: Usage - name: quota x-group: Quota - name: billing x-group: Billing - name: integrations x-group: Integrations - name: connect x-group: Connect - name: code x-group: Code - name: logins x-group: Saved logins - name: two_factor x-group: 2FA - name: login_access x-group: Login access - name: tools x-group: Tools - name: webhooks x-group: Webhooks - name: runs x-group: Runs - name: builds x-group: Builds - name: jobs x-group: Jobs - name: suggestions x-group: Suggestions - name: audit x-group: Audit - name: files x-group: Files - name: team x-group: Team - name: sso x-group: Single sign-on - name: issue_reports x-group: Problem reports paths: /v1/jobs/{id}/resume: post: tags: - jobs summary: Resume a paused build description: Resume a paused build whose pause.resume_by is resume. operationId: jobs.resume parameters: - name: id in: path required: true description: 'a job ID: job_ and 32 lowercase hex digits' schema: type: string examples: - job_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190 responses: '202': description: The build, queued again content: application/json: schema: $ref: '#/components/schemas/Job' '400': description: invalid_request content: application/json: schema: $ref: '#/components/schemas/Error' '401': description: unauthorized, reauthentication_required content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: forbidden content: application/json: schema: $ref: '#/components/schemas/Error' '404': description: not_found content: application/json: schema: $ref: '#/components/schemas/Error' '409': description: not_paused, pause_expired content: application/json: schema: $ref: '#/components/schemas/Error' '410': description: moved_to_team content: application/json: schema: $ref: '#/components/schemas/Error' '500': description: internal_error content: application/json: schema: $ref: '#/components/schemas/Error' '503': description: temporarily_unavailable content: application/json: schema: $ref: '#/components/schemas/Error' security: - bearer: [] components: schemas: Job: type: object required: - id - type - status - tool_id - input_request - result - result_status - result_expires_at - write_status - login_save - error - message - maintenance - build - watch_url - created_at - updated_at - completed_at properties: id: $ref: '#/components/schemas/job_id' type: type: string enum: - run - build status: type: string enum: - queued - running - needs_input - paused - succeeded - failed - cancelled tool_id: anyOf: - type: string - type: 'null' input_request: anyOf: - $ref: '#/components/schemas/InputRequest' - type: 'null' pause: $ref: '#/components/schemas/JobPause' result: $id: /schemas/unknown result_file: anyOf: - $ref: '#/components/schemas/ResultFile' - type: 'null' result_preview: $id: /schemas/unknown result_status: anyOf: - type: string enum: - available - delivered - expired - type: 'null' result_expires_at: anyOf: - $ref: '#/components/schemas/Date' - type: 'null' write_status: anyOf: - type: string enum: - not_attempted - may_have_applied - applied - not_applied - type: 'null' description: >- 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 write_progress: anyOf: - type: string enum: - no_change - signed_in_only - may_have_submitted - submitted - type: 'null' login_save: anyOf: - type: object required: - status - login_id - reason properties: status: type: string enum: - saved - not_saved - failed login_id: anyOf: - type: string - type: 'null' reason: anyOf: - type: string - type: 'null' missing: type: string enum: - logins:manage description: >- With reason account_lacks_manage, consent_lacks_manage or grant_lacks_manage: the permission the login's save lacked. grant_hint: type: string description: What to grant so a login answered for a job is saved. additionalProperties: false - type: 'null' error: anyOf: - $ref: '#/components/schemas/Error' - type: 'null' message: anyOf: - type: string - type: 'null' stop_reason: type: string enum: - cancel_requested - access_revoked - account_deleted - logins_unavailable description: >- 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 stopped_after: type: string description: >- 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 maintenance: anyOf: - type: object required: - status - result_recovered - message - deadline_at properties: status: type: string enum: - repairing - repaired - incomplete result_recovered: type: boolean message: type: string deadline_at: anyOf: - type: string - type: 'null' now: $ref: '#/components/schemas/JobMaintenanceNow' waiting_for_repair: type: boolean enum: - true description: >- Present, as true, while the run waits behind another repair of its tool, which runs first. Each time a repair publishes a fixed tool, Pomerado runs the task again on it, and repairs the tool for this run if it still fails. Absent otherwise, and from an older backend change_in_progress: type: boolean enum: - true description: >- Present, as true, with waiting_for_repair while the repair the run waits behind is a change to the tool that someone requested. When the change publishes, Pomerado runs the task again on the changed tool; deadline_at leaves the change its time to finish. Absent otherwise, and from an older backend input_refusal: $ref: '#/components/schemas/JobMaintenanceInputRefusal' additionalProperties: false - type: 'null' build: anyOf: - $ref: '#/components/schemas/JobBuild' - type: 'null' site_url: anyOf: - type: string - type: 'null' description: >- 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: anyOf: - type: string - type: 'null' description: >- 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: anyOf: - type: string - type: 'null' description: >- 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: anyOf: - type: string - type: 'null' description: The name of the tool tool_id names, as GET /v1/tools shows it waiting_since: anyOf: - type: string - type: 'null' description: >- When the question input_request asks was asked; null when the job asks none answered_questions: type: array items: $ref: '#/components/schemas/JobAnsweredQuestion' description: >- The questions the job asked and its member answered, oldest first; a secret, login or code shows only that it was answered warnings: type: array items: $ref: '#/components/schemas/JobWarning' description: >- 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 watch_url: type: string tip: type: string created_at: $ref: '#/components/schemas/Date' updated_at: $ref: '#/components/schemas/Date' completed_at: anyOf: - $ref: '#/components/schemas/Date' - type: 'null' additionalProperties: false Error: type: object required: - error properties: error: type: object required: - code - message - retryable - docs_url properties: code: type: string message: type: string retryable: type: boolean docs_url: type: string details: type: object required: [] properties: {} additionalProperties: $id: /schemas/unknown additionalProperties: false additionalProperties: false job_id: type: string description: 'a job ID: job_ and 32 lowercase hex digits' examples: - job_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190 InputRequest: type: object required: - id - expires_at - answer_url - message - questions properties: id: type: string description: 'An input request ID: req_ and 32 lowercase hex digits' examples: - req_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190 pattern: ^req_[0-9a-f]{32}$ expires_at: type: string answer_url: type: string message: type: string questions: type: array items: $ref: '#/components/schemas/Question' login_save: type: object required: - allowed - missing - grant_hint properties: allowed: type: boolean enum: - false missing: type: string enum: - logins:manage description: The permission the login's save would lack. grant_hint: type: string description: What to grant before the login is entered, so it is saved. additionalProperties: false description: >- Present when the login this job asks for would be used for this job only, because this client or the account role lacks logins:manage. grant_hint says what to grant to save it. Absent when the login can be saved. additionalProperties: false JobPause: type: object required: - reason - paused_at - expires_at - resume_by properties: reason: type: string enum: - question_expired - sign_in_expired - owner - credentials_rejected paused_at: $ref: '#/components/schemas/Date' expires_at: $ref: '#/components/schemas/Date' resume_by: type: string enum: - answer - resume - sign_in additionalProperties: false ResultFile: type: object required: - id - name - media_type - size - sha256 - download_url - expires_at properties: id: type: string name: type: string media_type: type: string size: type: number sha256: type: string download_url: type: string expires_at: type: string additionalProperties: false Date: type: string description: a string to be decoded into a Date JobMaintenanceNow: type: object required: - label - started_at properties: label: type: string description: >- One line for the user saying what the repair is doing now: repairing, testing the fix or publishing it started_at: anyOf: - type: string - type: 'null' description: >- When the repair's current step started (ISO 8601 UTC); null when unknown additionalProperties: false description: >- What the repair is doing now while the run waits for it. Absent otherwise, and from an older backend JobMaintenanceInputRefusal: type: object required: - reason properties: reason: anyOf: - type: string - type: 'null' description: >- The tool's own reason for refusing the value. Null from a status-only read, or when Pomerado can't read it additionalProperties: false description: >- Present while the repair checks a value in the input that the tool refused. It finds whether the input or the tool is wrong. Absent otherwise, and from an older backend JobBuild: type: object required: - integration_id - stage - stages - eta - example_result - existing_tool_id - change - recorded properties: integration_id: anyOf: - $ref: '#/components/schemas/integration_id' - type: 'null' stage: type: string enum: - queued - checking_login - exploring - building - publishing stages: type: array items: type: object required: - key - label - status - started_at - completed_at properties: key: type: string enum: - queued - checking_login - exploring - building - publishing label: type: string status: type: string enum: - done - active - pending started_at: anyOf: - type: string - type: 'null' completed_at: anyOf: - type: string - type: 'null' additionalProperties: false now: anyOf: - $ref: '#/components/schemas/JobBuildNow' - type: 'null' description: What the build is doing now; null once it has ended eta: type: 'null' description: >- No longer provided: always null. Pomerado doesn't estimate how long a build takes example_result: $id: /schemas/unknown existing_tool_id: anyOf: - type: string - type: 'null' change: anyOf: - $ref: '#/components/schemas/JobChange' - type: 'null' recorded: type: boolean description: >- Whether the build's browser was recorded. A Business account watches the recording on the build page, or reads there why it was removed exploration: $ref: '#/components/schemas/JobBuildExploration' additionalProperties: false JobAnsweredQuestion: type: object required: - request_id - question_id - type - prompt - options - selected - other - note - text - confirmed - answered - value_hidden - asked_at - answered_at properties: request_id: type: string question_id: type: string type: type: string prompt: type: string options: anyOf: - type: array items: type: string - type: 'null' description: The offered options' labels, for a choice; null otherwise selected: type: array items: type: string description: The labels picked other: anyOf: - type: string - type: 'null' description: The member's own answer instead of, or beside, the offered options note: anyOf: - type: string - type: 'null' text: anyOf: - type: string - type: 'null' description: A text answer, or the text a confirmation sent confirmed: anyOf: - type: boolean - type: 'null' answered: type: boolean description: False for an optional question left unanswered value_hidden: type: boolean description: >- True for a secret, a login, a code or a saved login's choice: it was answered, and its value is never shown asked_at: anyOf: - type: string - type: 'null' answered_at: anyOf: - type: string - type: 'null' additionalProperties: false JobWarning: type: object required: - code - message properties: code: type: string enum: - non_us_site - extreme_test_mode - login_not_needed message: type: string additionalProperties: false Question: anyOf: - type: object required: - id - prompt - type - options - allow_other - allow_note properties: id: type: string prompt: type: string type: type: string enum: - choice options: type: array items: type: object required: - id - label properties: id: type: string label: type: string additionalProperties: false allow_other: type: boolean allow_note: type: boolean additionalProperties: false - type: object required: - id - prompt - type - options - min_selections - max_selections - allow_other - allow_note properties: id: type: string prompt: type: string type: type: string enum: - multi_choice options: type: array items: type: object required: - id - label properties: id: type: string label: type: string additionalProperties: false min_selections: $ref: '#/components/schemas/Int' max_selections: $ref: '#/components/schemas/Int' allow_other: type: boolean allow_note: type: boolean additionalProperties: false - type: object required: - id - prompt - type - max_length properties: id: type: string prompt: type: string type: type: string enum: - text max_length: anyOf: - $ref: '#/components/schemas/Int' - type: 'null' additionalProperties: false - type: object required: - id - prompt - type - follow_up properties: id: type: string prompt: type: string type: type: string enum: - confirm follow_up: anyOf: - type: object required: - prompt properties: prompt: type: string additionalProperties: false - type: 'null' additionalProperties: false - type: object required: - id - prompt - type - kind properties: id: type: string prompt: type: string type: type: string enum: - secret kind: type: string enum: - one_time_code - authenticator_code - private_text additionalProperties: false - type: object required: - id - prompt - type - site_url - fields - reason - username_masked - can_save properties: id: type: string prompt: type: string type: type: string enum: - login site_url: type: string fields: type: array items: type: string enum: - username - email - phone - account_number - password reason: type: string enum: - missing - rejected - expired username_masked: anyOf: - type: string - type: 'null' can_save: type: boolean additionalProperties: false integration_id: type: string description: 'an integration ID: int_ and 32 lowercase hex digits' examples: - int_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190 JobBuildNow: type: object required: - label - started_at properties: label: type: string description: >- One line for the user saying what the build is doing now, such as its step on the site, a test round's progress or that it waits for an answer. It changes as the build moves on started_at: anyOf: - type: string - type: 'null' description: When this line started (ISO 8601 UTC); null when unknown additionalProperties: false JobChange: type: object required: - revision_id - previous_revision_id - write_started properties: revision_id: anyOf: - type: string - type: 'null' previous_revision_id: anyOf: - type: string - type: 'null' write_started: type: boolean items: type: array items: $ref: '#/components/schemas/JobChangeItem' description: >- Once the change published, each part of its request and whether the change did it, with why for a part it didn't do. Absent before it publishes, when its repair recorded none, and from an older backend additionalProperties: false JobBuildExploration: type: object required: - status - rows_run - rows_planned - drafts_used properties: status: type: string enum: - awaiting_script - exploring - folding - verifying - publishing - incomplete - failed - published rows_run: type: integer description: The answer sets the host ran on practice drafts so far rows_planned: type: integer description: The answer sets it planned drafts_used: type: integer description: The practice drafts it saved on the account, at most five additionalProperties: false description: >- An extreme test-mode build's exploration of the form on practice drafts before it publishes; absent on every other build and before it starts Int: type: integer description: an integer JobChangeItem: type: object required: - item - status properties: item: type: string description: >- The part as the request names it, such as 2 or b, or 1 for a request that names no parts status: type: string enum: - done - not_done reason: type: string description: Why the change didn't do this part additionalProperties: false securitySchemes: bearer: type: http scheme: bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.