[{"data":1,"prerenderedAt":1161},["ShallowReactive",2],{"navigation_docs_en":3,"-en-how-tos-start-stream-via-api":408,"-en-how-tos-start-stream-via-api-surround":1156},[4,25,74,124,238,253,313,342,388],{"title":5,"path":6,"stem":7,"children":8,"page":24},"Getting Started","\u002Fen\u002Fgetting-started","en\u002F1.getting-started",[9,14,19],{"title":10,"path":11,"stem":12,"icon":13},"Introduction","\u002Fen\u002Fgetting-started\u002Fintroduction","en\u002F1.getting-started\u002F1.introduction","i-lucide-house",{"title":15,"path":16,"stem":17,"icon":18},"Quickstart","\u002Fen\u002Fgetting-started\u002Fquickstart","en\u002F1.getting-started\u002F2.quickstart","i-lucide-rocket",{"title":20,"path":21,"stem":22,"icon":23},"Concepts","\u002Fen\u002Fgetting-started\u002Fconcepts","en\u002F1.getting-started\u002F3.concepts","i-lucide-book-open",false,{"title":26,"path":27,"stem":28,"children":29,"page":24},"Live Production","\u002Fen\u002Flive-production","en\u002F2.live-production",[30,35,55,60],{"title":31,"path":32,"stem":33,"icon":34},"On air","\u002Fen\u002Flive-production\u002Fon-air","en\u002F2.live-production\u002F1.on-air","i-lucide-radio",{"title":36,"path":37,"stem":38,"children":39,"page":24},"Live Streams","\u002Fen\u002Flive-production\u002Flive-streams","en\u002F2.live-production\u002F2.live-streams",[40,45,50],{"title":41,"path":42,"stem":43,"icon":44},"Overview","\u002Fen\u002Flive-production\u002Flive-streams\u002Foverview","en\u002F2.live-production\u002F2.live-streams\u002F1.overview","i-lucide-list",{"title":46,"path":47,"stem":48,"icon":49},"Options","\u002Fen\u002Flive-production\u002Flive-streams\u002Flive-stream-options","en\u002F2.live-production\u002F2.live-streams\u002F2.live-stream-options","i-lucide-file-text",{"title":51,"path":52,"stem":53,"icon":54},"Start and stop","\u002Fen\u002Flive-production\u002Flive-streams\u002Fstart-stop","en\u002F2.live-production\u002F2.live-streams\u002F3.start-stop","i-lucide-play-circle",{"title":56,"path":57,"stem":58,"icon":59},"Scheduler","\u002Fen\u002Flive-production\u002Fscheduler","en\u002F2.live-production\u002F3.scheduler","i-lucide-calendar-clock",{"title":61,"path":62,"stem":63,"children":64,"page":24},"Recordings","\u002Fen\u002Flive-production\u002Frecordings","en\u002F2.live-production\u002F4.recordings",[65,69],{"title":41,"path":66,"stem":67,"icon":68},"\u002Fen\u002Flive-production\u002Frecordings\u002Foverview","en\u002F2.live-production\u002F4.recordings\u002F1.overview","i-lucide-circle-dot",{"title":70,"path":71,"stem":72,"icon":73},"Editor","\u002Fen\u002Flive-production\u002Frecordings\u002Feditor","en\u002F2.live-production\u002F4.recordings\u002F2.editor","i-lucide-scissors",{"title":75,"path":76,"stem":77,"children":78,"page":24},"Configuration","\u002Fen\u002Fconfiguration","en\u002F3.configuration",[79,93,98,111],{"title":80,"path":81,"stem":82,"children":83,"page":24},"Devices","\u002Fen\u002Fconfiguration\u002Fdevices","en\u002F3.configuration\u002F1.devices",[84,88],{"title":80,"path":85,"stem":86,"icon":87},"\u002Fen\u002Fconfiguration\u002Fdevices\u002Fdevices","en\u002F3.configuration\u002F1.devices\u002F1.devices","i-lucide-server",{"title":89,"path":90,"stem":91,"icon":92},"Groups","\u002Fen\u002Fconfiguration\u002Fdevices\u002Fgroups","en\u002F3.configuration\u002F1.devices\u002F2.groups","i-lucide-network",{"title":94,"path":95,"stem":96,"icon":97},"Sources","\u002Fen\u002Fconfiguration\u002Fsources","en\u002F3.configuration\u002F2.sources","i-lucide-cable",{"title":99,"path":100,"stem":101,"children":102,"page":24},"Encodings","\u002Fen\u002Fconfiguration\u002Fencodings","en\u002F3.configuration\u002F3.encodings",[103,107],{"title":99,"path":104,"stem":105,"icon":106},"\u002Fen\u002Fconfiguration\u002Fencodings\u002Fprofiles","en\u002F3.configuration\u002F3.encodings\u002F1.profiles","i-lucide-sliders-horizontal",{"title":89,"path":108,"stem":109,"icon":110},"\u002Fen\u002Fconfiguration\u002Fencodings\u002Fgroups","en\u002F3.configuration\u002F3.encodings\u002F2.groups","i-lucide-layers",{"title":112,"path":113,"stem":114,"children":115,"page":24},"Destinations","\u002Fen\u002Fconfiguration\u002Fdestinations","en\u002F3.configuration\u002F4.destinations",[116,120],{"title":112,"path":117,"stem":118,"icon":119},"\u002Fen\u002Fconfiguration\u002Fdestinations\u002Fdestinations","en\u002F3.configuration\u002F4.destinations\u002F1.destinations","i-lucide-send",{"title":89,"path":121,"stem":122,"icon":123},"\u002Fen\u002Fconfiguration\u002Fdestinations\u002Fpublishing-groups","en\u002F3.configuration\u002F4.destinations\u002F2.publishing-groups","i-lucide-share-2",{"title":125,"path":126,"stem":127,"children":128,"page":24},"Settings","\u002Fen\u002Fsettings","en\u002F4.settings",[129,142,147,163,179],{"title":130,"path":131,"stem":132,"children":133,"page":24},"Users","\u002Fen\u002Fsettings\u002Fusers","en\u002F4.settings\u002F1.users",[134,138],{"title":130,"path":135,"stem":136,"icon":137},"\u002Fen\u002Fsettings\u002Fusers\u002Fusers","en\u002F4.settings\u002F1.users\u002F1.users","i-lucide-user",{"title":89,"path":139,"stem":140,"icon":141},"\u002Fen\u002Fsettings\u002Fusers\u002Fuser-groups","en\u002F4.settings\u002F1.users\u002F2.user-groups","i-lucide-users",{"title":143,"path":144,"stem":145,"icon":146},"Security","\u002Fen\u002Fsettings\u002Fsecurity","en\u002F4.settings\u002F2.security","i-lucide-shield",{"title":148,"icon":149,"path":150,"stem":151,"children":152,"page":24},"Assets","i-lucide-image","\u002Fen\u002Fsettings\u002Fassets","en\u002F4.settings\u002F3.assets",[153,158],{"title":154,"path":155,"stem":156,"icon":157},"Logos","\u002Fen\u002Fsettings\u002Fassets\u002Flogos","en\u002F4.settings\u002F3.assets\u002F1.logos","i-lucide-images",{"title":159,"path":160,"stem":161,"icon":162},"Files","\u002Fen\u002Fsettings\u002Fassets\u002Ffiles","en\u002F4.settings\u002F3.assets\u002F2.files","i-lucide-clapperboard",{"title":164,"icon":165,"path":166,"stem":167,"children":168,"page":24},"External Storage","i-lucide-folder-cog","\u002Fen\u002Fsettings\u002Fexternal-storage","en\u002F4.settings\u002F4.external-storage",[169,174],{"title":170,"path":171,"stem":172,"icon":173},"Remote Folders","\u002Fen\u002Fsettings\u002Fexternal-storage\u002Fremote-folders","en\u002F4.settings\u002F4.external-storage\u002F1.remote-folders","i-lucide-folder-archive",{"title":175,"path":176,"stem":177,"icon":178},"Target Folders","\u002Fen\u002Fsettings\u002Fexternal-storage\u002Ftarget-folders","en\u002F4.settings\u002F4.external-storage\u002F2.target-folders","i-lucide-folder-up",{"title":180,"path":181,"stem":182,"children":183,"page":24},"Integrations","\u002Fen\u002Fsettings\u002Fintegrations","en\u002F4.settings\u002F5.integrations",[184,188,193,207],{"title":41,"path":185,"stem":186,"icon":187},"\u002Fen\u002Fsettings\u002Fintegrations\u002Foverview","en\u002F4.settings\u002F5.integrations\u002F1.overview","i-lucide-plug",{"title":189,"path":190,"stem":191,"icon":192},"MediaCopilot","\u002Fen\u002Fsettings\u002Fintegrations\u002Fmediacopilot","en\u002F4.settings\u002F5.integrations\u002F2.mediacopilot","i-lucide-sparkles",{"title":194,"icon":195,"path":196,"stem":197,"children":198,"page":24},"C21 Live Cloud","i-lucide-cloud","\u002Fen\u002Fsettings\u002Fintegrations\u002Fc21livecloud","en\u002F4.settings\u002F5.integrations\u002F3.c21livecloud",[199,202],{"title":41,"path":200,"stem":201,"icon":195},"\u002Fen\u002Fsettings\u002Fintegrations\u002Fc21livecloud\u002Foverview","en\u002F4.settings\u002F5.integrations\u002F3.c21livecloud\u002F1.overview",{"title":203,"path":204,"stem":205,"icon":206},"Accounts","\u002Fen\u002Fsettings\u002Fintegrations\u002Fc21livecloud\u002Faccounts","en\u002F4.settings\u002F5.integrations\u002F3.c21livecloud\u002F2.accounts","i-lucide-key-round",{"title":208,"icon":146,"path":209,"stem":210,"children":211,"page":24},"DRM Providers","\u002Fen\u002Fsettings\u002Fintegrations\u002Fdrm","en\u002F4.settings\u002F5.integrations\u002F4.drm",[212,216,220,224,228,233],{"title":41,"path":213,"stem":214,"icon":215},"\u002Fen\u002Fsettings\u002Fintegrations\u002Fdrm\u002Foverview","en\u002F4.settings\u002F5.integrations\u002F4.drm\u002F1.overview","i-lucide-shield-check",{"title":217,"path":218,"stem":219,"icon":146},"Widevine","\u002Fen\u002Fsettings\u002Fintegrations\u002Fdrm\u002Fwidevine","en\u002F4.settings\u002F5.integrations\u002F4.drm\u002F2.widevine",{"title":221,"path":222,"stem":223,"icon":146},"PlayReady","\u002Fen\u002Fsettings\u002Fintegrations\u002Fdrm\u002Fplayready","en\u002F4.settings\u002F5.integrations\u002F4.drm\u002F3.playready",{"title":225,"path":226,"stem":227,"icon":146},"FairPlay","\u002Fen\u002Fsettings\u002Fintegrations\u002Fdrm\u002Ffairplay","en\u002F4.settings\u002F5.integrations\u002F4.drm\u002F4.fairplay",{"title":229,"path":230,"stem":231,"icon":232},"Providers","\u002Fen\u002Fsettings\u002Fintegrations\u002Fdrm\u002Fproviders","en\u002F4.settings\u002F5.integrations\u002F4.drm\u002F5.providers","i-lucide-shield-half",{"title":234,"path":235,"stem":236,"icon":237},"Workflow","\u002Fen\u002Fsettings\u002Fintegrations\u002Fdrm\u002Fworkflow","en\u002F4.settings\u002F5.integrations\u002F4.drm\u002F6.workflow","i-lucide-workflow",{"title":239,"path":240,"stem":241,"children":242,"page":24},"System Status","\u002Fen\u002Fsystem-status","en\u002F5.system-status",[243,248],{"title":244,"path":245,"stem":246,"icon":247},"Commands","\u002Fen\u002Fsystem-status\u002Fcommands","en\u002F5.system-status\u002F1.commands","i-lucide-square-terminal",{"title":249,"path":250,"stem":251,"icon":252},"Logs","\u002Fen\u002Fsystem-status\u002Flogs","en\u002F5.system-status\u002F2.logs","i-lucide-scroll-text",{"title":254,"path":255,"stem":256,"children":257,"page":24},"How Tos","\u002Fen\u002Fhow-tos","en\u002F6.how-tos",[258,263,268,273,277,281,285,290,294,299,304,309],{"title":259,"path":260,"stem":261,"icon":262},"Start and stop a Live stream","\u002Fen\u002Fhow-tos\u002Fstart-stream-via-api","en\u002F6.how-tos\u002F1.start-stream-via-api","i-lucide-terminal",{"title":264,"path":265,"stem":266,"icon":267},"Ingest a YouTube Live broadcast","\u002Fen\u002Fhow-tos\u002Fingest-youtube-live","en\u002F6.how-tos\u002F10.ingest-youtube-live","i-lucide-youtube",{"title":269,"path":270,"stem":271,"icon":272},"Source Synchronized Encoding (SSE) — bit-identical redundancy","\u002Fen\u002Fhow-tos\u002Fsource-synchronized-encoding","en\u002F6.how-tos\u002F11.source-synchronized-encoding","i-lucide-copy-check",{"title":274,"path":275,"stem":276,"icon":34},"Broadcast radio as video","\u002Fen\u002Fhow-tos\u002Fbroadcast-radio-as-video","en\u002F6.how-tos\u002F12.broadcast-radio-as-video",{"title":278,"path":279,"stem":280,"icon":215},"Protect a Live stream with multi-DRM","\u002Fen\u002Fhow-tos\u002Fmulti-drm-destination","en\u002F6.how-tos\u002F2.multi-drm-destination",{"title":282,"path":283,"stem":284,"icon":59},"Schedule a weekly recurring broadcast","\u002Fen\u002Fhow-tos\u002Fweekly-recurring-broadcast","en\u002F6.how-tos\u002F3.weekly-recurring-broadcast",{"title":286,"path":287,"stem":288,"icon":289},"Cut a clip in the Editor and send it to MediaCopilot","\u002Fen\u002Fhow-tos\u002Fexport-recording-to-mediacopilot","en\u002F6.how-tos\u002F4.export-recording-to-mediacopilot","i-lucide-upload-cloud",{"title":291,"path":292,"stem":293,"icon":149},"Apply a logo overlay to a running Live stream","\u002Fen\u002Fhow-tos\u002Fapply-logo-overlay","en\u002F6.how-tos\u002F5.apply-logo-overlay",{"title":295,"path":296,"stem":297,"icon":298},"Black out or replace the program on a running Live stream","\u002Fen\u002Fhow-tos\u002Fbroadcast-blackout","en\u002F6.how-tos\u002F6.broadcast-blackout","i-lucide-square",{"title":300,"path":301,"stem":302,"icon":303},"Switch the source of a running Live stream","\u002Fen\u002Fhow-tos\u002Fruntime-source-switch","en\u002F6.how-tos\u002F7.runtime-source-switch","i-lucide-repeat-2",{"title":305,"path":306,"stem":307,"icon":308},"Toggle a Publishing mid-broadcast","\u002Fen\u002Fhow-tos\u002Ftoggle-publishing-mid-broadcast","en\u002F6.how-tos\u002F8.toggle-publishing-mid-broadcast","i-lucide-toggle-right",{"title":310,"path":311,"stem":312,"icon":34},"Contribute a live signal to MediaCopilot Live","\u002Fen\u002Fhow-tos\u002Fcontribute-to-mediacopilot-live","en\u002F6.how-tos\u002F9.contribute-to-mediacopilot-live",{"title":314,"path":315,"stem":316,"children":317,"page":24},"Installation","\u002Fen\u002Finstallation","en\u002F7.installation",[318,323,328,333,338],{"title":319,"path":320,"stem":321,"icon":322},"Prepare the host","\u002Fen\u002Finstallation\u002Fprepare-host","en\u002F7.installation\u002F1.prepare-host","i-lucide-server-cog",{"title":324,"path":325,"stem":326,"icon":327},"Install C21 Live Control","\u002Fen\u002Finstallation\u002Fcontrol","en\u002F7.installation\u002F2.control","i-lucide-cloud-download",{"title":329,"path":330,"stem":331,"icon":332},"Install C21 Live Encoder","\u002Fen\u002Finstallation\u002Fencoder","en\u002F7.installation\u002F3.encoder","i-lucide-cpu",{"title":334,"path":335,"stem":336,"icon":337},"Updates","\u002Fen\u002Finstallation\u002Fupdates","en\u002F7.installation\u002F4.updates","i-lucide-refresh-cw",{"title":339,"path":340,"stem":341,"icon":206},"Licenses","\u002Fen\u002Finstallation\u002Flicenses","en\u002F7.installation\u002F5.licenses",{"title":343,"path":344,"stem":345,"children":346,"page":24},"Developers","\u002Fen\u002Fdevelopers","en\u002F8.developers",[347,351,369],{"title":41,"path":348,"stem":349,"icon":350},"\u002Fen\u002Fdevelopers\u002Foverview","en\u002F8.developers\u002F1.overview","i-lucide-code",{"title":352,"icon":350,"path":353,"stem":354,"children":355,"page":24},"API","\u002Fen\u002Fdevelopers\u002Fapi","en\u002F8.developers\u002F2.api",[356,359,364],{"title":41,"path":357,"stem":358,"icon":350},"\u002Fen\u002Fdevelopers\u002Fapi\u002Foverview","en\u002F8.developers\u002F2.api\u002F1.overview",{"title":360,"path":361,"stem":362,"icon":363},"Authentication","\u002Fen\u002Fdevelopers\u002Fapi\u002Fauthentication","en\u002F8.developers\u002F2.api\u002F2.authentication","i-lucide-key",{"title":365,"path":366,"stem":367,"icon":368},"Pagination and Errors","\u002Fen\u002Fdevelopers\u002Fapi\u002Fpagination-errors","en\u002F8.developers\u002F2.api\u002F3.pagination-errors","i-lucide-list-ordered",{"title":370,"icon":371,"path":372,"stem":373,"children":374,"page":24},"MCP Server","i-lucide-bot","\u002Fen\u002Fdevelopers\u002Fmcp-server","en\u002F8.developers\u002F3.mcp-server",[375,378,383],{"title":41,"path":376,"stem":377,"icon":371},"\u002Fen\u002Fdevelopers\u002Fmcp-server\u002Foverview","en\u002F8.developers\u002F3.mcp-server\u002F1.overview",{"title":379,"path":380,"stem":381,"icon":382},"Tools","\u002Fen\u002Fdevelopers\u002Fmcp-server\u002Ftools","en\u002F8.developers\u002F3.mcp-server\u002F2.tools","i-lucide-wrench",{"title":384,"path":385,"stem":386,"icon":387},"Examples","\u002Fen\u002Fdevelopers\u002Fmcp-server\u002Fexamples","en\u002F8.developers\u002F3.mcp-server\u002F3.examples","i-lucide-play",{"title":389,"path":390,"stem":391,"children":392,"page":24},"Resources","\u002Fen\u002Fresources","en\u002F9.resources",[393,398,403],{"title":394,"path":395,"stem":396,"icon":397},"Links","\u002Fen\u002Fresources\u002Flinks","en\u002F9.resources\u002F1.links","i-lucide-link",{"title":399,"path":400,"stem":401,"icon":402},"Release Notes","\u002Fen\u002Fresources\u002Frelease-notes","en\u002F9.resources\u002F2.release-notes","i-lucide-clipboard-list",{"title":404,"path":405,"stem":406,"icon":407},"Glossary","\u002Fen\u002Fresources\u002Fglossary","en\u002F9.resources\u002F3.glossary","i-lucide-book-a",{"id":409,"title":259,"body":410,"description":1149,"extension":1150,"links":1151,"meta":1152,"navigation":1153,"path":260,"seo":1154,"stem":261,"__hash__":1155},"docs_en\u002Fen\u002F6.how-tos\u002F1.start-stream-via-api.md",{"type":411,"value":412,"toc":1132},"minimark",[413,421,424,429,436,440,487,491,503,603,607,614,711,718,721,770,787,866,875,879,909,915,988,991,1023,1031,1035,1066,1070,1095,1109,1119,1128],[414,415,416,420],"p",{},[417,418,419],"strong",{},"Available in:"," UI · API",[414,422,423],{},"Use this how-to to start a configured Live stream on the right encoder and stop it again. Both the UI and the public API drive the same backend — pick the surface that fits your caller.",[425,426,428],"h2",{"id":427},"when-to-use-this","When to use this",[414,430,431,432,435],{},"When a service, an external scheduler, an automation script or an operator needs to bring a Live stream on air. For supervised, calendar-driven starts use the ",[433,434,56],"a",{"href":57}," instead.",[425,437,439],{"id":438},"prerequisites","Prerequisites",[441,442,443,457,468,478],"ul",{},[444,445,446,447,451,452,456],"li",{},"The numeric identifier of a Live stream that has already been configured (Channel, Encoding and Destination bound). Read it from the ",[448,449,450],"em",{},"Live streams"," list or from ",[453,454,455],"code",{},"GET \u002Fc21apiv2\u002Flivestreams",".",[444,458,459,460,463,464,467],{},"A user with the ",[417,461,462],{},"Operator"," or ",[417,465,466],{},"System Administrator"," role. Both roles can start and stop Live streams.",[444,469,470,471,474,475,456],{},"For API callers: a valid API token issued from ",[448,472,473],{},"Preferences → API tokens",". See ",[433,476,477],{"href":361},"API → Authentication",[444,479,480,481,484,485,456],{},"A valid ",[417,482,483],{},"C21 Live Control"," product license on the instance. See ",[433,486,339],{"href":340},[425,488,490],{"id":489},"via-ui","Via UI",[414,492,493,494,463,497,499,500,502],{},"Navigation: ",[417,495,496],{},"Live streams → \u003Cname>",[417,498,31],{},". Selecting a row in ",[433,501,31],{"href":32}," exposes the Start \u002F Stop buttons in the toolbar.",[504,505,506,511,519,523,538,542,549,555,572,576,579],"steps",{},[507,508,510],"h3",{"id":509},"open-the-live-stream","Open the Live stream",[414,512,513,514,516,517,456],{},"On the ",[448,515,450],{}," list (left rail), pick the row of the Live stream to bring on air; or, if it is already running, open ",[433,518,31],{"href":32},[507,520,522],{"id":521},"click-start","Click Start",[414,524,525,526,529,530,533,534,537],{},"The toolbar's Start button opens the ",[448,527,528],{},"Start with options"," dialog. Pick the ",[417,531,532],{},"Encoder group"," and the ",[417,535,536],{},"Preferred encoder","; the picker remembers the last selection on this device (a single-encoder shop only sees the picker once).",[507,539,541],{"id":540},"confirm","Confirm",[414,543,544,545,548],{},"The UI presents the ",[448,546,547],{},"Start Live stream"," dialog:",[550,551,552],"blockquote",{},[414,553,554],{},"Do you want to start this Live stream?",[414,556,557,558,560,561,564,565,567,568,571],{},"Primary action: ",[448,559,547],{},". Secondary action: ",[448,562,563],{},"Cancel",". On confirm, the row appears on ",[433,566,31],{"href":32}," and transitions to ",[448,569,570],{},"Live"," within a few seconds.",[507,573,575],{"id":574},"stop","Stop",[414,577,578],{},"Click the Stop button. The dialog copy depends on whether the broadcast was started manually or by the Scheduler:",[441,580,581,590],{},[444,582,583,586,587],{},[417,584,585],{},"Regular:"," ",[448,588,589],{},"\"Do you want to stop this Live stream?\"",[444,591,592,586,595,598,599,602],{},[417,593,594],{},"Scheduled:",[448,596,597],{},"\"Do you want to stop this Scheduled Live stream?\""," with the second line ",[448,600,601],{},"\"The associated Schedule will be deleted.\""," — confirming also removes the active Schedule.",[425,604,606],{"id":605},"via-api","Via API",[414,608,609,610,613],{},"The lifecycle of a Live stream lives at ",[453,611,612],{},"\u002Fc21apiv2\u002Flivestreams\u002F{livestreamId}",":",[615,616,617,633],"table",{},[618,619,620],"thead",{},[621,622,623,627,630],"tr",{},[624,625,626],"th",{},"Action",[624,628,629],{},"Method + path",[624,631,632],{},"operationId",[634,635,636,652,667,682,697],"tbody",{},[621,637,638,642,647],{},[639,640,641],"td",{},"Start configuration preconditions",[639,643,644],{},[453,645,646],{},"GET \u002Fc21apiv2\u002Flivestreams\u002F{livestreamId}\u002Fstart\u002Fconfig",[639,648,649],{},[453,650,651],{},"getLivestreamStartConfig",[621,653,654,657,662],{},[639,655,656],{},"Start",[639,658,659],{},[453,660,661],{},"POST \u002Fc21apiv2\u002Flivestreams\u002F{livestreamId}\u002Fstart",[639,663,664],{},[453,665,666],{},"startLivestream",[621,668,669,672,677],{},[639,670,671],{},"Status",[639,673,674],{},[453,675,676],{},"GET \u002Fc21apiv2\u002Flivestreams\u002F{livestreamId}\u002Fstatus",[639,678,679],{},[453,680,681],{},"getLivestreamStatus",[621,683,684,687,692],{},[639,685,686],{},"Detail",[639,688,689],{},[453,690,691],{},"GET \u002Fc21apiv2\u002Flivestreams\u002F{livestreamId}",[639,693,694],{},[453,695,696],{},"getLivestreamById",[621,698,699,701,706],{},[639,700,575],{},[639,702,703],{},[453,704,705],{},"POST \u002Fc21apiv2\u002Flivestreams\u002F{livestreamId}\u002Fstop",[639,707,708],{},[453,709,710],{},"stopLivestream",[414,712,713,714,717],{},"Pass the API token in the standard bearer header — ",[453,715,716],{},"Authorization: Bearer \u003CYOUR_API_TOKEN>"," — for every call.",[507,719,656],{"id":720},"start",[722,723,728],"pre",{"className":724,"code":725,"language":726,"meta":727,"style":727},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","curl -s \"https:\u002F\u002F\u003Cyour-host>\u002Fc21apiv2\u002Flivestreams\u002F\u003ClivestreamId>\u002Fstart\u002Fconfig\" \\\n  -H \"Authorization: Bearer \u003CYOUR_API_TOKEN>\"\n","bash","",[453,729,730,757],{"__ignoreMap":727},[731,732,735,739,743,747,750,753],"span",{"class":733,"line":734},"line",1,[731,736,738],{"class":737},"sBMFI","curl",[731,740,742],{"class":741},"sfazB"," -s",[731,744,746],{"class":745},"sMK4o"," \"",[731,748,749],{"class":741},"https:\u002F\u002F\u003Cyour-host>\u002Fc21apiv2\u002Flivestreams\u002F\u003ClivestreamId>\u002Fstart\u002Fconfig",[731,751,752],{"class":745},"\"",[731,754,756],{"class":755},"sTEyZ"," \\\n",[731,758,760,763,765,767],{"class":733,"line":759},2,[731,761,762],{"class":741},"  -H",[731,764,746],{"class":745},[731,766,716],{"class":741},[731,768,769],{"class":745},"\"\n",[414,771,772,774,775,778,779,782,783,786],{},[453,773,651],{}," returns the last saved ",[453,776,777],{},"startConfig[]",", the preferred encoder group and the ",[453,780,781],{},"startAllowed"," boolean. ",[453,784,785],{},"startAllowed = false"," means the Live stream is missing a bound Channel, Encoding or Destination.",[722,788,790],{"className":724,"code":789,"language":726,"meta":727,"style":727},"curl -X POST \"https:\u002F\u002F\u003Cyour-host>\u002Fc21apiv2\u002Flivestreams\u002F\u003ClivestreamId>\u002Fstart\" \\\n  -H \"Authorization: Bearer \u003CYOUR_API_TOKEN>\" \\\n  -H \"Idempotency-Key: \u003Cunique-key-per-logical-start>\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{ \"idEncoderGroup\": \u003Cfrom-config-response>, \"startConfig\": [] }'\n",[453,791,792,811,823,837,851],{"__ignoreMap":727},[731,793,794,796,799,802,804,807,809],{"class":733,"line":734},[731,795,738],{"class":737},[731,797,798],{"class":741}," -X",[731,800,801],{"class":741}," POST",[731,803,746],{"class":745},[731,805,806],{"class":741},"https:\u002F\u002F\u003Cyour-host>\u002Fc21apiv2\u002Flivestreams\u002F\u003ClivestreamId>\u002Fstart",[731,808,752],{"class":745},[731,810,756],{"class":755},[731,812,813,815,817,819,821],{"class":733,"line":759},[731,814,762],{"class":741},[731,816,746],{"class":745},[731,818,716],{"class":741},[731,820,752],{"class":745},[731,822,756],{"class":755},[731,824,826,828,830,833,835],{"class":733,"line":825},3,[731,827,762],{"class":741},[731,829,746],{"class":745},[731,831,832],{"class":741},"Idempotency-Key: \u003Cunique-key-per-logical-start>",[731,834,752],{"class":745},[731,836,756],{"class":755},[731,838,840,842,844,847,849],{"class":733,"line":839},4,[731,841,762],{"class":741},[731,843,746],{"class":745},[731,845,846],{"class":741},"Content-Type: application\u002Fjson",[731,848,752],{"class":745},[731,850,756],{"class":755},[731,852,854,857,860,863],{"class":733,"line":853},5,[731,855,856],{"class":741},"  -d",[731,858,859],{"class":745}," '",[731,861,862],{"class":741},"{ \"idEncoderGroup\": \u003Cfrom-config-response>, \"startConfig\": [] }",[731,864,865],{"class":745},"'\n",[414,867,868,871,872,874],{},[453,869,870],{},"Idempotency-Key"," is honoured on ",[453,873,666],{},"; replaying the same key returns the original response without re-issuing the start.",[507,876,878],{"id":877},"poll-status","Poll status",[722,880,882],{"className":724,"code":881,"language":726,"meta":727,"style":727},"curl -s \"https:\u002F\u002F\u003Cyour-host>\u002Fc21apiv2\u002Flivestreams\u002F\u003ClivestreamId>\u002Fstatus\" \\\n  -H \"Authorization: Bearer \u003CYOUR_API_TOKEN>\"\n",[453,883,884,899],{"__ignoreMap":727},[731,885,886,888,890,892,895,897],{"class":733,"line":734},[731,887,738],{"class":737},[731,889,742],{"class":741},[731,891,746],{"class":745},[731,893,894],{"class":741},"https:\u002F\u002F\u003Cyour-host>\u002Fc21apiv2\u002Flivestreams\u002F\u003ClivestreamId>\u002Fstatus",[731,896,752],{"class":745},[731,898,756],{"class":755},[731,900,901,903,905,907],{"class":733,"line":759},[731,902,762],{"class":741},[731,904,746],{"class":745},[731,906,716],{"class":741},[731,908,769],{"class":745},[414,910,911,914],{},[453,912,913],{},"LiveStream.status"," returns one of four values:",[615,916,917,932],{},[618,918,919],{},[621,920,921,926,929],{},[624,922,923],{},[453,924,925],{},"status",[624,927,928],{},"UI label",[624,930,931],{},"Meaning",[634,933,934,949,962,976],{},[621,935,936,941,946],{},[639,937,938],{},[453,939,940],{},"0",[639,942,943],{},[448,944,945],{},"Off",[639,947,948],{},"stopped \u002F idle",[621,950,951,956,959],{},[639,952,953],{},[453,954,955],{},"1",[639,957,958],{},"(transient)",[639,960,961],{},"starting",[621,963,964,969,973],{},[639,965,966],{},[453,967,968],{},"2",[639,970,971],{},[448,972,570],{},[639,974,975],{},"running",[621,977,978,983,985],{},[639,979,980],{},[453,981,982],{},"3",[639,984,958],{},[639,986,987],{},"error \u002F failed",[507,989,575],{"id":990},"stop-1",[722,992,994],{"className":724,"code":993,"language":726,"meta":727,"style":727},"curl -X POST \"https:\u002F\u002F\u003Cyour-host>\u002Fc21apiv2\u002Flivestreams\u002F\u003ClivestreamId>\u002Fstop\" \\\n  -H \"Authorization: Bearer \u003CYOUR_API_TOKEN>\"\n",[453,995,996,1013],{"__ignoreMap":727},[731,997,998,1000,1002,1004,1006,1009,1011],{"class":733,"line":734},[731,999,738],{"class":737},[731,1001,798],{"class":741},[731,1003,801],{"class":741},[731,1005,746],{"class":745},[731,1007,1008],{"class":741},"https:\u002F\u002F\u003Cyour-host>\u002Fc21apiv2\u002Flivestreams\u002F\u003ClivestreamId>\u002Fstop",[731,1010,752],{"class":745},[731,1012,756],{"class":755},[731,1014,1015,1017,1019,1021],{"class":733,"line":759},[731,1016,762],{"class":741},[731,1018,746],{"class":745},[731,1020,716],{"class":741},[731,1022,769],{"class":745},[414,1024,1025,1027,1028,1030],{},[453,1026,710],{}," does not honour ",[453,1029,870],{}," — stopping an already-stopped Live stream is a safe no-op. The public stop does not touch any Schedule; to stop a scheduled broadcast and remove its Schedule in one move, mirror the UI flow (list and delete the active Schedule for the Live stream).",[425,1032,1034],{"id":1033},"verify","Verify",[441,1036,1037,1046,1055],{},[444,1038,1039,1040,1042,1043,1045],{},"The row on ",[433,1041,31],{"href":32}," reads ",[448,1044,570],{}," and the entrypoint arrows are green.",[444,1047,1048,1049,1051,1052,456],{},"A subsequent ",[453,1050,681],{}," returns ",[453,1053,1054],{},"status = 2",[444,1056,1057,1058,1060,1061,1051,1063,456],{},"After stop, the row leaves ",[433,1059,31],{"href":32},"; ",[453,1062,681],{},[453,1064,1065],{},"status = 0",[425,1067,1069],{"id":1068},"faq","FAQ",[1071,1072,1074,1075,1078,1079,1078,1082,1078,1084,1087,1088,1091,1092,1094],"collapsible",{"name":1073},"Which routes honour the Idempotency-Key header?","The header is honoured on ",[453,1076,1077],{},"addChannel",", ",[453,1080,1081],{},"addLivestream",[453,1083,666],{},[453,1085,1086],{},"addSchedule"," and ",[453,1089,1090],{},"executeEditor",". ",[453,1093,710],{}," does not require an idempotency key because stopping an already-stopped Live stream is a safe no-op.",[1071,1096,1098,1099,1102,1103,1105,1106,1108],{"name":1097},"Is there a dry-run option on start?","No. The platform does not expose a ",[453,1100,1101],{},"dry_run"," flag. Use ",[453,1104,651],{}," to inspect the start preconditions before posting the start; that call is read-only and surfaces the ",[453,1107,781],{}," boolean.",[1071,1110,1112,1113,1115,1116,1118],{"name":1111},"Stopping a scheduled broadcast deleted its Schedule. Is that expected?","Yes — the UI's ",[448,1114,575],{}," on a scheduled broadcast removes the active Schedule as a side effect. The public ",[453,1117,710],{}," does not touch the Schedule; mirror the UI flow if you want both actions.",[1071,1120,1122,1123,1125,1126,456],{"name":1121},"How do I rotate the API token without downtime?","Create a new token from ",[453,1124,473],{},", switch the integration over to the new value, confirm it works, then revoke the old one. See ",[433,1127,477],{"href":361},[1129,1130,1131],"style",{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":727,"searchDepth":759,"depth":759,"links":1133},[1134,1135,1136,1142,1147,1148],{"id":427,"depth":759,"text":428},{"id":438,"depth":759,"text":439},{"id":489,"depth":759,"text":490,"children":1137},[1138,1139,1140,1141],{"id":509,"depth":825,"text":510},{"id":521,"depth":825,"text":522},{"id":540,"depth":825,"text":541},{"id":574,"depth":825,"text":575},{"id":605,"depth":759,"text":606,"children":1143},[1144,1145,1146],{"id":720,"depth":825,"text":656},{"id":877,"depth":825,"text":878},{"id":990,"depth":825,"text":575},{"id":1033,"depth":759,"text":1034},{"id":1068,"depth":759,"text":1069},"Bring a configured Live stream on air and stop it again — from the UI, from the API, or both.","md",null,{},{"icon":262},{"title":259,"description":1149},"6w6pdld53ZXn8b0Mb5nt3KxJNL_yxDAa0dmU-SdU51c",[1157,1159],{"title":249,"path":250,"stem":251,"description":1158,"icon":252,"children":-1},"Read and download the log tail of C21 Live Control and its managed Encoders, filtered by file and severity, with a separate verbose debug view.",{"title":264,"path":265,"stem":266,"description":1160,"icon":267,"children":-1},"Bring a public YouTube Live broadcast on air as the source of a Live stream.",1782916483940]