---
title: "Pause or resume an existing sequence"
method: PATCH
path: "/sequences/{id}/status"
tags: ["Sequences"]
---

# Pause or resume an existing sequence

`PATCH /sequences/{id}/status`

## Request

- Base URL: `https://app.pumpgtm.com/api/v1`
- URL: `https://app.pumpgtm.com/api/v1/sequences/{id}/status`
- Auth: HTTP bearer

Affects every lead in this sequence. active may enable sending, subject to existing approval, billing, budget and provider controls. paused halts future sequence work; already dispatched actions cannot be recalled. Does not edit or approve content. 400 { error: "status must be one of active, paused, draft" } for any other value; 404 { error: "sequence not found" } outside this workspace; 409 { ok: false, error: sequence_approval_required | archived_sequence_is_read_only } when the change is refused.

## Path parameters

- `id` string, uuid, required

## Headers

- `X-PumpGTM-Client` string, uuid
- `X-PumpGTM-User` string

## Request body

- object
  - `status` 'active' | 'paused' | 'draft', required

## Response `200`

Successful response. Read outcome fields; success does not imply delivery.

- object
  - `ok` unknown, required
  - `sequenceId` string, uuid, required
  - `previousStatus` 'draft' | 'active' | 'paused' | 'archived', required
  - `status` 'active' | 'paused' | 'draft', required

## Other responses

- `400`: { error: "status must be one of active, paused, draft" }
- `401`: Missing, invalid or revoked key
- `403`: Workspace mismatch, channel or feature disabled; for partner keys also enterprise_required and user_disabled
- `404`: { error: "sequence not found" }
- `409`: { ok: false, error: "sequence_approval_required" | "archived_sequence_is_read_only" }; nothing changed
- `429`: Rate limit; respect Retry-After when provided
- `500`: internal_error: an unexpected failure on our side; retry, then contact PumpGTM
- `503`: Dependency unavailable; identity may be unknown

## Changes

- **2026-10-12** `06d2e4d0e84b`: 8 info
  - the response property `error` became required for the status `400`
  - the response property `error` became required for the status `401`
  - the response property `error` became required for the status `403`
  - the response property `error` became required for the status `404`
  - …4 more
- **2026-10-12** `08c80059d483`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/pumpgtm/apis/pumpgtm-api/changes/sequences/:id/status/patch.md)

---

[API](https://skmtc.dev/pumpgtm/apis/pumpgtm-api.md) - [All operations](https://skmtc.dev/pumpgtm/apis/pumpgtm-api/llms.txt) - [OpenAPI document](https://skmtc.dev/pumpgtm/apis/pumpgtm-api/revisions/06d2e4d0e84b?raw)