---
title: "Remove a person from a sequence"
method: POST
path: "/public/v1/sequences/{sequenceId}/recipients/{instanceId}/remove"
tags: ["Sequences"]
---

# Remove a person from a sequence

`POST /public/v1/sequences/{sequenceId}/recipients/{instanceId}/remove`

Stops the sequence for one enrolled person and leaves the instance in status `REMOVED`. Requires a USER API key. `note` is an optional free-text comment persisted alongside the removal and surfaced in the recipient timeline.

## Path parameters

- `sequenceId` number, nullable
- `instanceId` number, nullable

## Request body

- object
  - `note` string

## Response `200`

Instance removed

- object
  - `id` number, required
  - `accountId` number, required
  - `sequenceId` number, required
  - `personRowId` string, required
  - `snapshotId` string, required
  - `sourceSnapshotId` string, nullable
  - `snapshotPinnedAt` string, nullable
  - `currentNodeId` string, nullable, required
  - `status` 'ACTIVE' | 'WAITING' | 'PAUSED' | 'COMPLETED' | 'EXITED' | 'FAILED' | 'REMOVED', required
  - `blockedOn` 'NONE' | 'TIME' | 'TASK_COMPLETION' | 'REPLY' | 'MEETING' | 'MANUAL' | 'WORKFLOW_COMPLETION', required
  - `nextExecutionAt` string, nullable, required
  - `enrolledByUserId` number, required
  - `senderConnectedAccountId` number, nullable, required
  - `startedAt` string, nullable, required
  - `lastAdvancedAt` string, nullable, required
  - `exitedAt` string, nullable, required
  - `completedAt` string, nullable, required
  - `pausedAt` string, nullable, required
  - `removedAt` string, nullable, required
  - `exitReason` string, nullable, required
  - `exitNote` string, nullable, required
  - `exitedByUserId` number, nullable, required
  - `failureReason` string, nullable, required
  - `failureCode` string, nullable, required
  - `createdAt` string, nullable, required
  - `updatedAt` string, nullable, required
  - `enrolledByUser` object
    - `id` number, required
    - `firstName` string, required
    - `lastName` string, required
    - `email` string, email, required
    - `avatar` string, nullable
  - `exitedByUser` object, nullable
    - `id` number, required
    - `firstName` string, required
    - `lastName` string, required
    - `email` string, email, required
    - `avatar` string, nullable

## Changes

- **2026-10-03** `666cd9efa9f3` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/getfrontline/apis/public-api/changes/public/v1/sequences/:sequenceId/recipients/:instanceId/remove/post.md)

---

[API](https://skmtc.dev/getfrontline/apis/public-api.md) · [All operations](https://skmtc.dev/getfrontline/apis/public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getfrontline/apis/public-api/revisions/666cd9efa9f3?raw)