Skip to main content
DELETE
Delete stream
Tears down a Stream, drops its retained frames, and releases its LiveKit room. Call this as soon as you’re done with a session — don’t rely on the lease timeout if you can help it. After deletion, the stream_id can no longer be referenced from /chat/completions.

Authorizations

Authorization
string
header
required

Every public HTTP request requires Authorization: Bearer <api_key>, except GET /models and the public /billing/pricing endpoints.

  • 401 means the key is missing, unknown, or revoked.
  • 403 means the key is valid but cannot access the requested resource.
  • The publish token returned by POST /streams is only for publishing media to LiveKit. It does not replace the API key for HTTP calls.

Headers

X-Overshoot-Region
enum<string>

Optional hint to route the request to the region that owns the stream. If the request reaches the wrong region the API returns 409 with a region_error body.

Available options:
us-west1,
us-central1

Path Parameters

stream_id
string<uuid>
required

UUID returned by POST /streams.

Response

Delete acknowledged.

id
string<uuid>
required
deleted
boolean
required
Example:

true