Skip to main content
DELETE

​
Overview

Deletes a stream. If the stream is live, processing stops and outputs are finalised; a scheduled stream is cancelled. The stream’s status becomes 4 (ended). Deleting does not erase the stream’s history: you can still call GET /stream/{stream_id} afterwards to read its final state. Streams stop on their own at their end_time; use this endpoint to end one earlier.
A deleted stream cannot be restarted. To run the same setup again, create a new stream with the same payload, or use flows as your endpoints so encoders and viewers keep the same URLs across runs.

​
Errors

  • 404 - No stream with this ID belongs to your team.
  • 422 - Invalid stream_id.

Authorizations

​
x-api-key
string
header
required

The x-api-key is a custom header required for authenticating requests to our API. Include this header in your request with the appropriate API key value to securely access our endpoints. You can find your API key(s) in the 'API' section of our studio website.

Path Parameters

​
stream_id
integer
required

Identifier of the stream to delete.

Response

Deletion confirmation.

The response is of type Delete Stream Response · object.

Last modified on July 24, 2026