---
title: "Force stop a channel (will force stop all connected engines and rtsp-pull ingests)"
method: POST
path: "/channels/{id}/force-stop"
tags: ["Channels"]
---

# Force stop a channel (will force stop all connected engines and rtsp-pull ingests)

`POST /channels/{id}/force-stop`

## Request

- Base URL: `https://api.theo.live/v2`
- URL: `https://api.theo.live/v2/channels/{id}/force-stop`
- Auth: HTTP basic

Stops all connected engines and all connected rtsp-pull ingests of the channel immediately, skipping the graceful shutdown: the engines are torn down right away without closing their playlists first, so viewers may see playback fail instead of the stream ending cleanly. Works from any non-stopped state, including while engines are `stopping` after a regular stop. Engines report `stopping` until the teardown has completed (usually a few seconds), then `stopped`. Prefer `POST /channels/{id}/stop` unless the engines have to be gone immediately.

## Path parameters

- `id` string, required: Channel ID

## Response `204`

Channel force stopped

## Changes

- **2026-10-16** `accc3bdd84d3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/dolby/apis/theolive-api/changes/channels/:id/force-stop/post.md)

---

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