# Stop an engine

```
POST 
/engines/:id/stop
```

Stops the engine gracefully: its playlists are closed so that viewers see the stream end, after which the engine is torn down. The engine reports `stopping` until the teardown has completed (typically 10–20 seconds), then `stopped`. Calling this endpoint again while the engine is `stopping` force stops it: the engine is torn down immediately. An engine in `error` is always force stopped. The engine can only be started again once it is `stopped`.

## Request

## Responses

**204**

Engine stopped