place.stream.playback.getVideoBlob
Fetch a content-addressed MUXL playback blob by CID. Serves either a primary fMP4 archive or a per-track init segment — both are CID-addressed and indistinguishable from the endpoint's point of view. HTTP `Range` headers are honored; HLS media playlists generated by getVideoPlaylist reference this endpoint with `EXT-X-BYTERANGE` to serve segments out of the primary blob. The `did` identifies the owning account for egress accounting: the blob itself is content-addressed and owner-agnostic, so the caller carries the attribution.
Details · query
| Kind | query |
|---|---|
| Authority | playback.stream.place |
| Indexed |
Checks
Validunlimited-stringdefs.main.parameters.properties.cidNo maxLength, maxGraphemes or format limits this string.unlimited-stringdefs.main.parameters.properties.sidNo maxLength, maxGraphemes or format limits this string.
{
"$type": "com.atproto.lexicon.schema",
"defs": {
"main": {
"description": "Fetch a content-addressed MUXL playback blob by CID. Serves either a primary fMP4 archive or a per-track init segment — both are CID-addressed and indistinguishable from the endpoint's point of view. HTTP `Range` headers are honored; HLS media playlists generated by getVideoPlaylist reference this endpoint with `EXT-X-BYTERANGE` to serve segments out of the primary blob. The `did` identifies the owning account for egress accounting: the blob itself is content-addressed and owner-agnostic, so the caller carries the attribution.",
"errors": [
{
"description": "This node doesn't have the requested CID. The caller should consult place.stream.media.origin records to find a node that does.",
"name": "BlobNotFound"
}
],
"output": {
"encoding": "video/mp4"
},
"parameters": {
"properties": {
"cid": {
"description": "BLAKE-3 BDASL CID of the requested blob.",
"type": "string"
},
"did": {
"description": "DID of the account that owns the record this blob is being served for. Used for egress/usage accounting, not for access control — the blob is served purely by CID.",
"format": "did",
"type": "string"
},
"sid": {
"description": "Opaque playback session identifier, propagated unmodified from the media playlist that referenced this blob. Logged for view-count correlation; not used for access control.",
"type": "string"
}
},
"required": [
"did",
"cid"
],
"type": "params"
},
"type": "query"
}
},
"id": "place.stream.playback.getVideoBlob",
"lexicon": 1
}