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

# Resume Run

> Puts the run's held calls back on the dispatch queue and returns it to RUNNING.

Puts a paused run's held calls back on the dispatch queue.

## What comes back

Exactly what [pause](/api-reference/runs/pause-run) held, plus anything attached while the run was paused. Nothing is dropped, and **nobody is called twice** — a contact already reached during the running window has a call behind them and is not re-queued.

```json theme={null}
{ "status": "RUNNING", "affectedCalls": 30 }
```

`affectedCalls` is how many calls were restored.

## Only from PAUSED

Resuming a run that is not paused is a `422`. In particular there is no resume from `CANCELLED`, which is terminal.

## Error Scenarios

* **404 Not Found**: the run does not exist, or belongs to another company
* **422 Unprocessable Entity**: the run is not paused
* **403 Forbidden**: the API key does not hold `write:runs`

## Related Resources

<CardGroup cols={2}>
  <Card title="Pause Run" icon="pause" href="/api-reference/runs/pause-run">
    What resume undoes
  </Card>

  <Card title="Get Run" icon="layer-group" href="/api-reference/runs/get-run">
    Watch it dial again
  </Card>
</CardGroup>


## OpenAPI

````yaml POST /runs/{id}/resume
openapi: 3.0.0
info:
  title: InstaView API
  description: |-
    InstaView API Documentation

    ## Authentication

    All endpoints require API key authentication using Bearer token:
    ```
    Authorization: Bearer sk_your_api_key_here
    ```

    ## API Key Management

    The API Key module provides comprehensive key management for:
    - **Direct Client Keys**: Company-scoped keys for your applications
    - **ATS Partner Keys**: Resource-scoped keys for ATS integrations

    ### Key Features
    - HMAC-SHA256 hashing for API key storage
    - Configurable rate limiting
    - Comprehensive audit logging
    - Company-level isolation
    - Resource scoping for ATS partners
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.instaview.sk
    description: Production API Gateway
security: []
tags: []
paths:
  /runs/{id}/resume:
    post:
      tags:
        - Runs
      summary: Resume a paused run
      description: >-
        Puts the run's held calls back on the dispatch queue and returns it to
        RUNNING.
      operationId: PublicRunsController_resumeRun_v1
      parameters:
        - name: id
          required: true
          in: path
          schema:
            type: string
            format: uuid
        - name: companyId
          required: false
          in: query
          description: >-
            Required for ATS API keys to specify which company to access.
            Ignored for standard company API keys.
          schema:
            type: string
      responses:
        '201':
          description: Transition applied
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicRunLifecycleDto'
        '422':
          description: >-
            Unprocessable Entity - the run is not in a status this transition is
            legal from.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - bearer: []
components:
  schemas:
    PublicRunLifecycleDto:
      type: object
      properties:
        status:
          type: string
          description: The run's status after the transition
          enum:
            - DRAFT
            - SCHEDULED
            - RUNNING
            - PAUSED
            - COMPLETED
            - CANCELLED
          example: RUNNING
        affectedCalls:
          type: number
          description: >-
            How many of the run's calls this request moved: queued by a launch,
            withdrawn by a pause, restored by a resume, closed out by a cancel.
            Not calls placed - a 2xx means queued, not dialled.
          example: 42
      required:
        - status
        - affectedCalls
    ErrorResponse:
      type: object
      properties:
        statusCode:
          type: integer
          example: 400
        message:
          type: string
          example: Validation failed
        error:
          type: string
          example: Bad Request
      required:
        - statusCode
        - message
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      description: API key for authentication using Bearer scheme

````