---
title: "Transition Segment Endpoint"
method: POST
path: "/api/agent-chat/segments/{segment_id}/transition"
tags: ["Agent Chat"]
---

# Transition Segment Endpoint

`POST /api/agent-chat/segments/{segment_id}/transition`

Explicit transition, e.g. the 'Start campaign' button flipping
review → outreach. Invalid transitions return 409.

Transitions *into* `outreach` (from `review` or `listening`) are
gated by the same `Email Affordability Gate` used in /resume and
/launch — entering the sending state with no funds would just
stall on the first per-send precheck. Other targets (e.g.
cancellation paths) pass through unchanged.

## Path parameters

- `segment_id` string, required

## Cookies

- `ex_access` string, nullable
- `ex_org` string, nullable

## Request body

- TransitionRequest
  - `to` 'discovery' | 'review' | 'outreach' | 'listening' | 'archived' | 'error', required
  - `reason` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

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