> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloudcruise.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Unpause runs

> Lifts a pause so held runs can start. Requires the Owner or Member workspace role.

With `pause_resource` set to `run_window`, this is **Run now** for a [run window](/concepts/run-window): it lifts the closed window of each listed workflow and starts its held runs. The lift also covers runs submitted while it is active, and lasts until the window next opens, or until it is edited or removed. Workflows whose window is already open are skipped. A manual pause is never lifted this way.

With `pause_resource` set to `workflow`, it removes the manual pause on each listed workflow.



## OpenAPI

````yaml run-api/run-api.yaml post /runs/unpause
openapi: 3.1.0
info:
  title: CloudCruise Run API
  version: 0.1.0
  description: >-
    Endpoints for managing workflow executions, user interactions, and
    retrieving execution results.
servers:
  - url: https://api.cloudcruise.com
    description: CloudCruise Platform Production API Server
security:
  - AuthScheme: []
paths:
  /runs/unpause:
    post:
      summary: Unpause runs
      description: >-
        Lifts a pause so held runs can start. Requires the Owner or Member
        workspace role.


        With `pause_resource` set to `run_window`, this is **Run now** for a
        [run window](/concepts/run-window): it lifts the closed window of each
        listed workflow and starts its held runs. The lift also covers runs
        submitted while it is active, and lasts until the window next opens, or
        until it is edited or removed. Workflows whose window is already open
        are skipped. A manual pause is never lifted this way.


        With `pause_resource` set to `workflow`, it removes the manual pause on
        each listed workflow.
      operationId: unpause_runs
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - pause_resource
                - resource_ids
              properties:
                pause_resource:
                  type: string
                  enum:
                    - run_window
                    - workflow
                  description: What kind of hold to lift
                resource_ids:
                  type: array
                  items:
                    type: string
                    format: uuid
                  description: Workflow IDs
            example:
              pause_resource: run_window
              resource_ids:
                - 11223344-5566-7788-9900-112233445566
      responses:
        '200':
          description: The pause was lifted
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  resumedRuns:
                    type: integer
                    description: Number of held runs moved back to the queue
                  skippedResourceGroups:
                    type: array
                    items:
                      type: string
                    description: >-
                      Worker groups that were busy and could not be processed.
                      Their runs stay held, so repeat the request.
                  errors:
                    type: array
                    items:
                      type: string
        '401':
          description: Unauthorized, or a workflow belongs to another workspace
        '404':
          description: A workflow was not found
components:
  securitySchemes:
    AuthScheme:
      type: apiKey
      name: cc-key
      in: header
      description: >-
        API key-based authentication. Provide your CloudCruise API key in the
        cc-key header.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.