API · Streams
Managed Streams API
Configure stream servers with Dashboard endpoints. Encoders publish and viewers play directly on the server's media host.
Choose an API
| Surface | Base URL | Credential | Use |
|---|---|---|---|
| Dashboard API | https://api.hubfly.space/api/v1 | Dashboard bearer token | Servers, inputs, channels, destinations, mixers, schedules, recordings, keys, webhooks, domains, live control and usage. |
| Ingest | rtmps://<slug>.live.hubfly.app:443/live, SRT, WHIP, Icecast | The input's stream key | Encoders and browsers publishing media. See OBS and encoders. |
| Playback | https://<slug>.live.hubfly.app/hls/…, /whep/…, /embed/… | None, or a playback token for token channels | Players and viewers. See playback security. |
Endpoint groups
These groups cover 86 Dashboard endpoints. Server lifecycle uses the managed instance routes shared with Managed Databases and Realtime; stream routes live under /projects/:projectId/managed/instances/:instanceId/stream.
Resources, revisions and secrets
- Every resource has an
id, aname,createdAt,updatedAtand arevision. Send therevisionback on update; a stale one returns409 STREAM_REVISION_CONFLICT. - Validation errors are
422 STREAM_INVALIDwithdetails: [{path, code, message}], for examplechannels[0].encodingwithladder_required. - Secrets are write-only. Inputs return
keyHints, destinations astreamKeyHint; playback keys and webhooks return their secret once, when created or rotated. - A resource still used by another cannot be deleted:
409 STREAM_IN_USElists what refers to it. - Routes that need the media node right away (live status, control, stats, events) return
503 STREAM_NODE_UNAVAILABLEwhen it does not answer. Configuration changes are saved either way and reach the node when it answers again.
Asynchronous operations
Create, start, stop, resize and delete return an operationId. Poll GET /api/v1/projects/:projectId/managed/instances/:instanceId/operations/:operationId until it ends. Create and resize repeat the hourly speed price as quotedHourlyTotal, from GET /api/v1/managed/streams/price. Speed changes apply live, without interrupting streams.
Stream keys
Permissions
| Permission | Allows |
|---|---|
stream:read | See everything except secrets: servers, resources, live status, events, stats, usage, deliveries. |
stream:operate | Live control (go live, scenes, destinations, recordings), clips, studio control tokens and test playback tokens. |
stream:admin | Lifecycle and speed, every create, update and delete, revealing and rotating secrets, bindings, domains and storage links. |
Organization owners and admins have all three; viewers and developers have stream:read. A scoped token must hold the exact permission a route requires. See authentication and errors.