---
title: "Cancel sequence enrollments"
method: POST
path: "/sequences/{sequenceId}/enrollments/cancel"
tags: ["Sequences"]
---

# Cancel sequence enrollments

`POST /sequences/{sequenceId}/enrollments/cancel`

Cancels active or waiting enrollments in one sequence by subscriber ID or by matching stored entry event property values.

## Path parameters

- `sequenceId` string, required

## Request body

- SequenceEnrollmentCancelRequest — Provide exactly one target: subscriberId or fieldValues.
  - `subscriberId` string — Subscriber ID to cancel in this sequence.
  - `fieldPath` string — Dot-path inside the token's stored entry event properties. If omitted, the sequence enrollmentFieldPath is used.
  - `fieldValues` string[] — Entry field values to match.
  - `dryRun` boolean — When true, returns matching enrollments without cancelling them. Field-value targeting defaults to dry run unless explicitly false.
  - `reason` string — Optional reason stored on cancelled enrollment tokens.

## Response `200`

Enrollment cancellation completed or dry-run matches returned

- SequenceEnrollmentCancelResponse
  - `success` boolean
  - `sequenceId` string
  - `dryRun` boolean
  - `target` object
  - `matchedCount` number
  - `cancelledCount` number
  - `enrollments` object[]
    - `tokenId` string
    - `subscriberId` string
    - `subscriberEmail` string, nullable
    - `status` string
    - `enrollmentKey` string
  - `hasMore` boolean
  - `message` string

## Other responses

- `400` — Validation error
- `401` — Unauthorized
- `403` — No company selected
- `404` — Sequence or subscriber not found

## Changes

- **2026-05-07** `c21889189dc9` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/sequenzy/apis/sequenzy-api/changes/sequences/:sequenceId/enrollments/cancel/post.md)

---

[API](https://skmtc.dev/sequenzy/apis/sequenzy-api.md) · [All operations](https://skmtc.dev/sequenzy/apis/sequenzy-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sequenzy/sequenzy-api/revisions/d7ea66dede72/schema)