Hubfly spaceDocs
Console

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

SurfaceBase URLCredentialUse
Dashboard APIhttps://api.hubfly.space/api/v1Dashboard bearer tokenServers, inputs, channels, destinations, mixers, schedules, recordings, keys, webhooks, domains, live control and usage.
Ingestrtmps://<slug>.live.hubfly.app:443/live, SRT, WHIP, IcecastThe input's stream keyEncoders and browsers publishing media. See OBS and encoders.
Playbackhttps://<slug>.live.hubfly.app/hls/…, /whep/…, /embed/…None, or a playback token for token channelsPlayers 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, a name, createdAt, updatedAt and a revision. Send the revision back on update; a stale one returns 409 STREAM_REVISION_CONFLICT.
  • Validation errors are 422 STREAM_INVALID with details: [{path, code, message}], for example channels[0].encoding with ladder_required.
  • Secrets are write-only. Inputs return keyHints, destinations a streamKeyHint; playback keys and webhooks return their secret once, when created or rotated.
  • A resource still used by another cannot be deleted: 409 STREAM_IN_USE lists what refers to it.
  • Routes that need the media node right away (live status, control, stats, events) return 503 STREAM_NODE_UNAVAILABLE when 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

Input keys let anyone publish to your server. They are shown once when an input is created or a key rotated, and later only through an explicit reveal. Keep them in your encoder, never in client code.

Permissions

PermissionAllows
stream:readSee everything except secrets: servers, resources, live status, events, stats, usage, deliveries.
stream:operateLive control (go live, scenes, destinations, recordings), clips, studio control tokens and test playback tokens.
stream:adminLifecycle 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.

Something unclear or out of date? Emailsupport@hubfly.spaceBack to top