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

# Pause Segment Endpoint

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

Pause sending by transitioning `outreach → listening`.

Only legal from `outreach`. Other statuses return 409 — the frontend
gates the button on status so this is a safety net for direct API callers.
After the transition we also flip the session stop flag so any live
sub-agent on this segment halts on the next ~5s poll tick.

## Path parameters

- `segment_id` string, required

## Cookies

- `ex_access` string, nullable
- `ex_org` 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)