Transcoder
Transcoder is a tool used to convert data from one format to another, particularly in the context of multimedia files like audio, video, or images. It helps in converting media from one codec or container format to another, enabling compatibility with different devices, platforms, or media players.
Verified against app.web.cloud.sabay.com (commit bcd97ff4) and the testing
gateway schema on 2026-11-16.
GraphQL Gateway
All Transcoder operations go through a single GraphQL endpoint:
https://cloud-gateway.sabay.com/graphql
Authentication
Every request must carry both headers (see Authentication):
| Header | Value |
|---|---|
service-code | cloud_user |
Authorization | Bearer {token} |
Replace {token} with your own access token. Never commit tokens to source
control.
How the console uses this service
The app.web.cloud.sabay.com UI only lists transcoders. Creating and
editing transcoders happens in the separate Stream console, not in the
cloud console. The other operations on these pages exist in the gateway schema
but are not called by the cloud console.
- The Transcoder page (
/storage/transcoder,src/pages/storage/transcoder.tsx) finds the user'scloud_s3_transcodersubscription withsb_listSubscription(see Subscriptions), then callss3_listTranscoderwithpager: { limit: 1, page: 1 }only to showpagination.total("Total Transcoders"). The query is skipped when the subscription isPENDING_SUSPENDorSUSPENDED. - Subscription cards (
src/components/subscriptions/service-info.tsx) calls3_listTranscoderwithpager: { page: 1, limit: 3 }to show transcoder names as badges. s3_listTranscoderis the only transcoder operation the UI calls. "Add Transcoder" opens{live_stream_console_url}/dashboard/transcoder/create/{subscriptionId}and the dashboard card links to{live_stream_console_url}/dashboard/transcoder.live_stream_console_urliswindow.RUNTIME_STREAM_CONSOLE_URL, defaulting tohttps://stream-dash.testing.sabay.com(src/constants/constants.ts). The same console hosts the Streaming and Live Streaming dashboards.
Real-time events
The project defines the container_transcoderActionReceived subscription
(src/modules/run-app/subscription/useTranscoderActionReceived.ts), but the UI
does not currently subscribe to it. See
Real-time Events.
Reference
| Section | Contents |
|---|---|
| Transcoders | Create, list, inspect, update and remove transcoders; look a transcoder up by bucket |
| History & Streaming URLs | Transcode history, streaming URL generation, and deleting or reprocessing transcoded videos |