> ## 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.

# Pause Run

> Stops the run dialling. Calls already queued are withdrawn, and anything the dispatcher had already picked up is refused before it is placed. The work is held rather than discarded: resume puts back exactly what pause held, and a contact already reached is not called again.

Stops a running run from dialling, reversibly.

## Pause is a real stop

* **Nothing further is dialled**, including calls already queued when you paused. They are withdrawn from the dispatch queue, and anything the dispatcher had already picked up is refused at the call itself.
* **The work is held, not discarded.** The conversations stay in place. [Resume](/api-reference/runs/resume-run) puts back exactly what pause held.
* **A contact already reached is not called again.** Resume restores only the conversations that were never dialled.
* **A contact [attached](/api-reference/runs/attach-run-contacts) while paused is not called either.** They join the held work and go out on resume.

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

`affectedCalls` is how many queued calls were withdrawn.

## Only from RUNNING

Pausing a draft, a completed run or a cancelled one is a `422`. A draft has nothing queued to stop.

## Error Scenarios

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

## Related Resources

<CardGroup cols={2}>
  <Card title="Resume Run" icon="play" href="/api-reference/runs/resume-run">
    Put the held calls back
  </Card>

  <Card title="Cancel Run" icon="ban" href="/api-reference/runs/cancel-run">
    Stop it for good instead
  </Card>
</CardGroup>


## OpenAPI

````yaml POST /runs/{id}/pause
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}/pause:
    post:
      tags:
        - Runs
      summary: Pause a run
      description: >-
        Stops the run dialling. Calls already queued are withdrawn, and anything
        the dispatcher had already picked up is refused before it is placed. The
        work is held rather than discarded: resume puts back exactly what pause
        held, and a contact already reached is not called again.
      operationId: PublicRunsController_pauseRun_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

````