Streams

Watch a past stretch of a stream

POST/streams/{id}/catchup/preview/

write Change: creates or edits. Scopes

An address to watch minutes (up to 1440) from start of a channel with catch-up, as MPEG-TS (url) or HLS (hls_url). It counts as a viewer under your own name until you close it with DELETE.

Path parameters

  • idstring (uuid)required

    The stream's id.

Body

  • startstring (date-time)required

    With its time zone.

  • minutesintegerrequired

Response

200 OK

  • urlstringrequired
  • hls_urlstringrequired
  • session_idstringrequired
  • serverstringrequired

Errors

  • 400 Something sent is not valid. Each field that is wrong is named with what is wrong.
  • 401 No credential, or one that is wrong, expired or revoked.
  • 403 The account, or the key's or app's scopes, may not do this.
  • 404 Nothing with this id, or nothing the account can see.
  • 409 That stretch is not recorded.
  • 429 Slow down: wait the seconds in the Retry-After header, then try again.
  • 503 The recording server is not available.

What each error means