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

# Pause Outbound Calls

> Pauses outbound calls for a user. Non-staff API users may only pause their own calls; staff users may target any user. By default, the user's outbound calling is paused until the unpause endpoint is called. Set `only_existing_leads` to true to asynchronously pause only leads that already exist while leaving future leads unaffected.



## OpenAPI

````yaml /Sela_API.yaml post /api/users/{id}/pause-calls/
openapi: 3.0.3
info:
  title: Sela API
  version: 1.0.2
  description: >-
    Create and manage leads, configure outbound webhook subscriptions, and use
    customer-specific lead ingestion workflows. Unless an endpoint says
    otherwise, authenticate with `Authorization: Token <api-key>`.
servers:
  - url: https://api.trysela.com/
    description: Production API
security: []
tags:
  - name: Leads
    description: Create, retrieve, update, and schedule customer leads.
  - name: Call Control
    description: Pause or resume outbound calling for an API user.
  - name: Lead Types
    description: >-
      Discover lead categories and the public metadata fields accepted for each
      one.
  - name: Webhooks
    description: >-
      Manage subscriptions that deliver lead and call events to customer
      systems.
  - name: Lead Ingestion
    description: >-
      Submit provider-specific lead payloads through ingestion URLs configured
      by Sela.
  - name: File Ingestion
    description: Request temporary upload URLs for configured CSV ingestion sources.
paths:
  /api/users/{id}/pause-calls/:
    post:
      tags:
        - Call Control
      summary: Pause Outbound Calls
      description: >-
        Pauses outbound calls for a user. Non-staff API users may only pause
        their own calls; staff users may target any user. By default, the user's
        outbound calling is paused until the unpause endpoint is called. Set
        `only_existing_leads` to true to asynchronously pause only leads that
        already exist while leaving future leads unaffected.
      operationId: users_pause_calls_create
      parameters:
        - in: path
          name: id
          schema:
            type: string
            pattern: ^\d+$
          required: true
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PauseCallsRequest'
            examples:
              PauseAllOutboundCalls:
                value:
                  only_existing_leads: false
                summary: Pause all outbound calls
              PauseExistingLeadsOnly:
                value:
                  only_existing_leads: true
                summary: Pause existing leads only
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/PauseCallsRequest'
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/PauseCallsRequest'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserCallControlResponse'
              examples:
                CallsPaused:
                  value:
                    status: success
                  summary: Calls paused
          description: Pause request accepted.
        '400':
          description: Invalid request body.
        '401':
          description: API token is missing or invalid.
        '404':
          description: User not found or not accessible.
      security:
        - tokenAuth: []
      x-codeSamples:
        - lang: curl
          label: PauseAllOutboundCalls
          source: |-
            curl --request POST \
              --url https://api.trysela.com/api/users/<user-id>/pause-calls/ \
              --header 'Authorization: Token <api-key>' \
              --header 'Content-Type: application/json' \
              --data '{
                "only_existing_leads": false
              }'
        - lang: curl
          label: PauseExistingLeadsOnly
          source: |-
            curl --request POST \
              --url https://api.trysela.com/api/users/<user-id>/pause-calls/ \
              --header 'Authorization: Token <api-key>' \
              --header 'Content-Type: application/json' \
              --data '{
                "only_existing_leads": true
              }'
components:
  schemas:
    PauseCallsRequest:
      type: object
      properties:
        only_existing_leads:
          type: boolean
          default: false
          description: >-
            When false, pause outbound calls for this user until explicitly
            unpaused. When true, asynchronously pause only the user's existing
            leads without pausing future leads.
    UserCallControlResponse:
      type: object
      properties:
        status:
          type: string
          description: Indicates that the pause or unpause request was accepted.
      required:
        - status
  securitySchemes:
    tokenAuth:
      type: apiKey
      in: header
      name: Authorization
      description: Token-based authentication with required prefix "Token"

````