---
title: "Admin Transition Sequence"
method: POST
path: "/api/v1/admin/sequences/{sequence_id}/transition"
tags: ["admin"]
---

# Admin Transition Sequence

`POST /api/v1/admin/sequences/{sequence_id}/transition`

## Request

- Base URL: `https://api.nudgelink.co` (the document declares no server; this is the origin it was published from)
- URL: `https://api.nudgelink.co/api/v1/admin/sequences/{sequence_id}/transition`
- Auth: HTTP bearer

Pause / resume / retry a sequence. Takes ``SELECT ... FOR UPDATE`` to
avoid racing the Celery worker. Transitions are validated (only an active
sequence can be paused/retried; only a paused one resumed) and each is
audited as ``admin.sequence.<action>``.

## Path parameters

- `sequence_id` string, uuid, required

## Request body

- SequenceTransitionRequest
  - `action` 'pause' | 'resume' | 'retry' | 'confirm_sent' | 'confirm_not_sent', required
  - `reason` string, required

## Response `200`

Successful Response

- SequenceTransitionResponse
  - `id` string, uuid, required
  - `status` string, required
  - `next_action_at` string, date-time, nullable, required
  - `pause_reason` string, nullable, required

## Other responses

- `422`: Validation Error

---

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