すべての操作に、
API を。

配信を受け付けるストリームを作成します。応答の ingest には、配信ソフトに設定する取り込み先の URL とストリームキーが入ります。

ingest.stream_key が返るのは、この応答と POST /streams/{id}/keys の応答だけです。同じ Idempotency-Key で再送したときの応答では null になり、stream_key_redacted: true が付きます。

name はテナント内で一意です（重複すると 409）。ストリームはテナントあたり 1000 本までで、超えると 403（QUOTA_EXCEEDED）です。

入力・出力・変換は、この本文には書きません。配信者が送ってくる映像は、RTMP・SRT・WHIP で受信します。外部へ取りに行く入力と外部への出力は POST /streams/{id}/inputs・/outputs で、変換は /pipelines で別に設定します。

captions を指定すると、配信中の音声を外部の音声認識（と翻訳）のサービスへ送り、ライブ HLS に WebVTT の字幕（master.m3u8・sub_{lang}.m3u8）を追加します。指定しなければ、外部へは何も送りません。

テナントのストリームを、ID の昇順で返します。

ストリームの設定と、望ましい状態（desired_state）、実際の状態（observed_state）を返します。

指定した項目だけを置き換えます（JSON Merge Patch を簡単にした方式です）。If-Match が必須です。

snapshots: null で静止画の設定を、captions: null で字幕の設定を削除します。それ以外の項目の null は「変更しない」という意味です。

hls・recording・limits・metadata・captions は、オブジェクト全体を置き換えます。たとえば {"hls":{"segment_ms":1000}} を送ると、window・container は既定値に戻ります。

desired_state: stopped にすると、配信を受け付けなくなります。配信中であれば、その時点で配信を終了します。

ストリームと、その予約を削除します。録画は削除しません。配信中であれば、配信者を切断します。成功すると 204 を返します。

鍵が漏れたときなどに、ストリームキーを新しくします。新しい鍵は ingest.stream_key で返り、古い鍵はその時点で使えなくなります。リクエストの本文は無視します。成功すると 200 です（201 ではありません）。

視聴者向けの、期限付きの再生 URL（HLS・RTMP・WHEP）を発行します。本文は省略できます（空のときは Content-Type を確かめません）。有効期間 ttl_secs の既定は 300 秒で、上限はノードの設定 --max-playback-ttl で決まります。

このストリームに必要な変換と資源の見積もりを返します。何も変更しません。配信が始まる前は、仮の計画（state: provisional）です。対応していないコーデックは、結果の code: UNSUPPORTED_CODEC でわかります。リクエストの本文は無視します。

配信中の映像から、今の 1 枚を静止画にして返します。画像の形式は format で選べます。

静止画は、コーデックワーカー（変換を担当する別プロセス）が映像を復号して作ります。

主なエラー:

• 配信中でないとき、映像のトラックが無いとき: 409（クラスターで、配信を別のノードが受信しているときは 409 OWNERSHIP_LOST）
• キーフレームがまだ届いていないときは最大 5 秒待ち、届かなければ 504（INPUT_TIMEOUT、retryable: true）
• E2EE（エンドツーエンド暗号化）のルームからエクスポートしたストリーム: 422（details.reason: "e2ee"）
• コーデックワーカー が動いていない、または映像を復号できるデバイスが無い: 503（CAPACITY_UNAVAILABLE。retryable: false のため Retry-After は付きません）。H.264・H.265 はハードウェアでだけ復号します
• コーデックワーカー が UNSUPPORTED_CODEC を返した（royalty_free の方針に反するなど）: 422。INVALID_CONFIG を返した: 400。それ以外の失敗: 500

ストリームについて保存した静止画を、撮った時刻の順に返します。ページングはなく、クエリパラメーターは無視します。

ストリームの録画を始めます。202 で録画を返し、Location は /api/v1/recordings/{id} です。本文は省略できます。

状態コードは 202 ですが、応答の本文は処理の進み具合ではなく、録画そのものです。

主なエラー:

• ストリームが stopped のとき: 409
• 同じストリームの同時録画がすでに 8 本あるとき: 403（QUOTA_EXCEEDED）
• クラスターで、配信を別のノードが受信しているとき: 409（OWNERSHIP_LOST、details: {owner_node, owner_api}）。そのノードへリクエストを送り直してください

録画を ID の昇順で返します。削除中（deleting）の録画は含めません。state クエリパラメーターは受け付けますが、今は絞り込みに使いません。

録画の状態とインデックスを返します。

録画の保持期限（retention_until）、リーガルホールド（legal_hold。法的な理由などで削除を禁止する設定）、名前を変更します。If-Match が必須です。

リーガルホールドを解除する（legal_hold: false）には、recording:delete の権限も必要です（無ければ 403）。

録画を削除します。削除は受け付けた後に進むため、応答は 202 です。録画中であれば、止めてから削除します。リーガルホールド中の録画は削除できません（409）。

録画を止めます。録画中でなければ 409 です。停止は受け付けた後に進むため、応答の state がまだ recording のことがあります。リクエストの本文は無視します。

録画を再生するための、期限付きの URL を返します。本文は省略できます。今のところ playback.mp4 は常に null です（MP4 は GET /recordings/{id}/export.mp4 で取得します）。

録画のサムネイル（JPEG）を返します。サムネイルは録画が確定した後に作るため、まだ無ければ 404 です。

録画を MP4 ファイルとしてダウンロードします。応答には Content-Disposition: attachment が付きます。

start・end（RFC 3339）で範囲を指定して切り出せます。予約で録画したものでは、予約の範囲と重なる部分が対象です。切り出しの始まりは、直前のキーフレームまで前に広がります。

主なエラー:

• 録画中の録画、空の録画: 409
• 大きすぎる録画: 413（PAYLOAD_TOO_LARGE）
• 時刻の形式の誤り、end が start と同じかそれより前、知らないクエリパラメーター: 400
• 指定した範囲に録画が無い: 409

ストリームの録画・配信・静止画の撮影を、指定した時間に行うよう予約します。作成の前に、POST /schedules/check と同じ検査を行います。

1 回の期間は 24 時間までで、end_at は未来の時刻にしてください。

主なエラー:

• 同じストリームで同時に行う録画の予約が 4 本を超える: 409（重なる予約が details.overlaps に入ります）
• ストリームが無い: 404
• 予約がテナントあたり 1000 件を超える: 403（QUOTA_EXCEEDED）

予約を ID の昇順で返します。state クエリパラメーターは受け付けますが、今は絞り込みに使いません。

予約を作る前に、ほかの予約と重ならないか、資源が足りるか、競合が無いかを確かめます。本文は作成と同じものを送ってください。何も保存しません。問題が無ければ 200、問題があれば作成と同じ 400・404・409 を返します。

予約の内容を変更するか、取り消します。If-Match が必須です。取り消すには state: canceled を指定します（state に指定できるのは canceled だけです）。取り消し以外の変更では、作成と同じ検査を行います。

実行中の予約の start_at は変更できません（409）。recurrence・action・stream も変更できません。

snapshot_interval_secs・retention_days は削除できません。各項目の null は「変更しない」という意味です。

予約が実行された記録と結果を、直近の 100 件まで返します。ページングはなく、items だけを返します。

ストリームに入力を追加します。入力には 2 種類あります。外部のサーバーから映像を取りに行くもの（rtmp_pull・rtsp_pull・srt_pull・hls_pull）と、このノードにつないだキャプチャ機器（device）です。device の url は device:{機器 ID} で、機器は GET /devices の capture で調べられます。

配信者から送られてくる入力（push）は、ストリームキーで受信するため、ここでは扱いません。

enabled: true の入力はグリッドのワークロード（input:{id}）になり、スケジューラーが割り当てたノードが実行します（結果は placement_status）。placement.node にはノードの ID か名前を指定でき、応答では ID に変換されます。placement.degrade はパイプライン専用のため、指定すると 400 です。

リンクローカルやプライベートの IP アドレスなど、--egress-allow で許可していない接続先は、接続のときに拒否されます。このときも作成は 201 で成功し、status.state が error か backoff になって、理由が status.last_error に表示されます。

1 つのストリームに追加できる入力は 4 つまでです（超えると 403 QUOTA_EXCEEDED）。enabled: true の入力は、すぐに動き始めます（応答の status は null か starting のことがあります）。

主なエラー（この順に検査します）:

• 本文の形式の誤り: 400・415
• ストリームが無い: 404
• protocol の誤り: 400
• url のスキームや形式の誤り: 400。資格情報（user:pass@）を含む URL も拒否するので、credential_ref を使ってください
• credential_ref の形式の誤り、シークレットが無い: 400
• options の誤り: 400
• placement の誤り: 400（PlacementSpec を参照）

入力の url・credential_ref・enabled・options・placement を置き換えます。If-Match が必須です。credential_ref と placement は null で削除できます（placement を削除すると、配置はスケジューラーに任せます）。それ以外の項目の null は「変更しない」という意味です。

protocol と stream は変更できません。作成と同じ検査を行います。

変更すると、実行中の接続を作り直します。placement を変更すると配置を決め直すため、別のノードへ移ることがあります。

入力の接続を止めて、定義を削除します。If-Match は検査しません。

ストリームを外部へ送る出力を追加します。配信が始まるまでは status.state: waiting_input です。

• rtmp_push・srt_push: 送信先の url が必要です。スキームの検査と、資格情報（user:pass@）を含む URL の拒否は、入力と同じです。RTMP のストリームキーは、url の末尾か credential_ref で指定します。
• paas（配信サービスとの連携）: provider（cloudflare_stream・aws_ivs・aws_medialive）と、そのサービスの API の資格情報を指す credential_ref が必要です。url は使いません。SENCA が連携先に作ったリソースは provider_resource に記録され、出力を削除すると SENCA が後片付けします。

1 つのストリームに追加できる出力は 16 個までです（超えると 403 QUOTA_EXCEEDED）。

enabled: true の出力はグリッドのワークロード（output:{id}）になり、スケジューラーが割り当てたノードが送信します（結果は placement_status）。指定が無ければ、配信を受信しているノードを優先します。placement の検査は入力と同じです（degrade は 400）。

外部の WHIP サーバーへの送信（whip_push）には対応していません（400）。

出力の url・credential_ref・enabled・options・placement を置き換えます。If-Match が必須です。credential_ref と placement は null で削除できます。それ以外の項目の null は「変更しない」という意味です。

protocol・provider・stream は変更できません。paas の出力には url を指定できません（400）。

送信を止めて、定義を削除します。paas の場合は、SENCA が連携先に作ったリソースも後片付けします。後片付けに失敗してもログに記録するだけで、定義は削除します。If-Match は検査しません。

配信先のストリームキーや外部サービスの資格情報などを、シークレットとして登録します。値はノードの鍵（AES-256-GCM）で暗号化して保存し、応答にも一覧にも含めません。入力・出力などからは、応答の ref（secret:{name}）で参照します。

name はテナント内で一意です（重複すると 409）。登録できるのは 500 個までです（超えると 403 QUOTA_EXCEEDED）。値は 1〜8192 バイトです。

値を変えるには、いったん削除してから登録し直してください（変更の API はありません）。

登録したシークレットの名前などを返します。値は含みません。ページングはなく、すべてを返します。next_cursor は常に null です。クエリパラメーターは無視します（ほかの一覧と違い、limit・cursor や知らないクエリパラメーターを付けても 400 になりません）。

シークレットを削除します。入力・出力の credential_ref、ストリームの captions.asr_credential_ref・translate_credential_ref から参照されているシークレットは削除できません（409）。If-Match は検査しません。

グラフを検証してから、パイプラインを保存します。desired_state の既定は stopped なので、作成しただけでは動きません。

name はテナント内で一意です（重複すると 409）。パイプラインは 100 個まで作成できます（超えると 403 QUOTA_EXCEEDED）。

使えるコーデックは、このノードのコーデックワーカー（変換を担当する別プロセス）が報告した能力で決まります。コーデックワーカー が無い場合、エンコードやデコードを含むグラフは 503 になります。

検証に失敗したとき:

• グラフを解釈できない、処理ノードの設定が不正、参照の誤り、方針違反（royalty_free のストリームに H.264 を使うなど）、対応していないコーデック: 400（INVALID_CONFIG。details.issues に PipelineIssue の配列が入ります）
• source・sink のストリームがテナントに無い: 400（INVALID_CONFIG。title にストリームの ID が入ります）
• デバイスが無い（H.264・H.265 のハードウェアが無い、セッション数が上限に達している）: 503（CAPACITY_UNAVAILABLE、retryable: false。Retry-After は付きません）
• placement の誤り: 400（INVALID_CONFIG。グラフの検証の後に検査します）

desired_state: running のパイプラインはグリッドのワークロード（pipeline:{id}）になり、スケジューラーが割り当てたノードが実行します（結果は placement_status）。入力のストリームを受信しているノードを優先します。

placement.degrade にデグレードレベルを書いておけば、CPU や GPU のセッションが足りないときも、段階を下げて動き続けます。下げた段階では、その段階で指定した処理ノード（と、入力がすべて止まった下流の処理ノード）を外したグラフで実行します（placement_status.state: degraded）。

name・graph・desired_state・placement を置き換えます。If-Match が必須です。desired_state: running で開始し、stopped で停止します。placement は null で削除できます。ほかの項目の null は「変更しない」という意味です。

graph には、作成と同じ検証を行います（400・503）。placement を指定しなかった場合も、今のデグレードレベルを新しい graph で検査し直します（止める処理ノードが新しいグラフに無ければ 400）。

変更すると generation が増え、実行中なら新しいグラフで作り直します。セッションを開き直すため、切れ目なく切り替わるわけではありません。

name はテナント内で一意です（重複すると 409）。本文の検査は If-Match の比較より先に行います。そのため、古い If-Match と不正な本文を同時に送ると、400 が返ります。

実行中であれば止めてから削除します。If-Match は検査しません。

グラフを検証し、実行の計画を返します。本文が空なら保存済みのグラフを、本文があればそのグラフ（PipelineGraph）を検証します。本文のグラフは保存しません。

失敗したときの応答は、作成と同じ 400・503 です。何も変更しないため、必要な権限は stream:read です。

実行中のパイプラインに操作（PipelineControl）を送り、結果を待ちます（最長 15 秒）。配信しながらシーンを切り替えたり、音量を変えたりするときに使います。合成やミキサーへの操作は、次に出力するフレームから反映されます。

主なエラー:

• 本文の形式の誤り（知らない op や項目）: 400（INVALID_REQUEST）。prepare・commit・rollback（世代の操作）も 400 です。グラフを変えるには PATCH を使ってください
• パイプラインが実行中でない（stopped、起動中、コーデックワーカー が無い）: 409（CONFLICT）
• 実行中に操作が拒否された（知らない処理ノード・シーン・レイヤーなど）: 409（CONFLICT。title にエラーの内容が入ります）

snapshot_on_change の処理ノードが、板書の変化を見つけて保存した静止画を返します（reason: board_change、node は処理ノードの ID）。撮った時刻の順に並びます。返すのは、パイプラインを動かしているノードにある静止画だけです。

ルームを作成します。id を省略すると、24 文字の 16 進数を生成します。作成したルームはグリッドのワークロード（room:{id}）になり、スケジューラーが割り当てたノードで開かれます。

ルームはテナントあたり 10000 個まで作成できます（超えると 403 QUOTA_EXCEEDED）。

settings には、ルームを開くときと同じ検査（形式と値の範囲）を行います。違反すると 400 で、details.errors に項目ごとの理由が入ります。

主なエラー（この順に検査します）:

• 本文の形式の誤り: 400（INVALID_REQUEST）・415
• id の誤り（使えるのは 1〜128 文字の英数字と -_.:@）: 400
• settings の誤り: 400
• metadata が大きすぎる（JSON で 8 KiB まで）: 400
• placement の誤り: 400（PlacementSpec。node にはノードの ID か名前を指定でき、応答では ID に変換されます。degrade は使えません）
• 同じ ID のルームがある（ほかのテナントのルームであっても）: 409

テナントのルームを、ID の昇順で返します。参加トークンの発行で自動作成されたルームも含みます。

ルームの定義、配置の結果（placement_status）、シグナリングの接続先（signaling_url）を返します。参加者などの今の状態は、GET /rooms/{id}/participants・/stats で取得します。ほかのテナントのルームは 404 です。

ルームの settings・metadata・placement を変更します。If-Match が必須です。

settings は JSON Merge Patch（RFC 7396）で変更します。書いた項目だけが変わり、値を null にした項目は既定値に戻ります。spotlight などの入れ子の項目も同じです。settings・metadata そのものを null にすると「変更しない」という意味になります。placement は null で削除できます。変更後の設定は、作成と同じ決まりで検査します。

settings.recording を per_participant か composite にすると、ルームを録画するためのメディアパイプライン（ID は room-rec.{ルームの ID}、managed: true）を作成・更新します。none に戻すと、そのメディアパイプラインを削除します（エクスポートしたストリームと録画は残ります）。

合成や文字起こしのメディアパイプラインがあるルームは、E2EE（e2ee: true）にできません（422、details.reason: "e2ee"）。

ルームに参加者がいる間は、e2ee・video_codec・audio_codec を変更できません（409）。この確認は、リクエストを受けたノードがルームを開いているノードの場合にだけ行います。

変更は、ルームを開いているノードへ少し遅れて伝わります。スポットライトの変更は、参加者側の指定にも反映されます。

主なエラー（この順に検査します）: If-Match が無い・誤っている（428・412）、本文の形式の誤り（400・415）、ルームが無い（404）、世代が古い（412）、作成と同じ検査（400）。

ルームを削除します。参加者には room_deleted を送って切断します（切断は少し遅れて行われます）。If-Match は検査しません。

ルームのメディアパイプライン（media-pipelines）も削除され、それが作った合成のパイプラインと外部配信の出力も削除されます。エクスポートしたストリームと録画は残ります。

このとき、メディアパイプラインの media_pipeline.deleted イベントは届きません（届くのは room.deleted だけです）。

参加者がルームに入るための参加トークンを発行します。シグナリングの connect で token として渡します。

トークンは EdDSA（Ed25519）で署名した JWT です。claim には room・role・client_id・bundle_id・metadata・permissions と、exp・iat・jti が入ります。署名の鍵は全ノードで同じなので、どのノードで発行したトークンも、すべてのノードで使えます。

ルームが無ければ、既定の設定で自動的に作成します（auto: true）。自動で作ったルームは、誰もいない状態が empty_timeout_secs 続くと削除されます。このときの room.updated イベントでは data.auto: true です。

有効期間 ttl_secs の既定は 600 秒で、expires_at は RFC 3339 の形式です。同じ Idempotency-Key で再送したときの応答では、token を伏せます（token: null・token_redacted: true）。

主なエラー:

• ほかのテナントのルームの ID を指定した、ルームの ID の形式が誤っている: 404
• 本文の形式の誤り: 400・415
• ttl_secs が 10〜86400 の範囲外: 400
• client_id・bundle_id が 1〜255 文字でない、または制御文字を含む: 400
• metadata が 8 KiB を超える: 400
• 起動した直後で、署名の鍵がまだ無い: 503（retryable: true）

ルームの参加者を、connection_id の昇順で返します。このノードに接続している参加者のほか、カスケードで別のノードにいる参加者（signaling: remote）も含みます。

リクエストは、ルームを開いているノードへ転送されます（rooms の説明を参照）。配置先が決まっていない、または WebRTC が動いていなければ 503、ルームがまだ開かれていなければ 404 です。

next_cursor は、返した件数が limit と同じときだけ入ります（続きが無くても入ることがあります）。返した件数が limit より少なければ、next_cursor の項目そのものがありません。

参加者 1 人の情報を返します（subscriptions は受信の枠です）。リクエストは、ルームを開いているノードへ転送されます。参加していない接続を指定すると 404 です。

参加者の metadata を置き換え、ルームの全員に notify {event: connection.updated} を送ります（SSE では room.connection.updated）。

参加者には世代が無いため、If-Match は検査しません。どのノードで受けても、参加者が接続しているノード（カスケードでつながった edge のノードを含む）へ転送して変更します。転送は、ルームを開いているノード、参加者のノードの順に、2 段までです。参加していない接続を指定すると 404 です。

参加者をルームから退出させます（シグナリングでは disconnect {reason: kicked} が届きます）。トークンは無効にならないため、同じトークンで再び入室できます。どのノードで受けても、参加者が接続しているノード（カスケードでつながった edge のノードを含む）へ転送して切断します。参加していない接続を指定すると 404 です。

ルームの参加者へメッセージを送ります。label が無ければ、シグナリングの push {data} で JSON のまま送ります。label があれば、そのラベルの DataChannel を開いている参加者へ、DataChannel で送ります（このとき data は文字列です）。

to（connection_id の配列）が空なら全員に送ります。ルームにいない接続が to に含まれていれば 404 です。data は JSON で 64 KiB まで、label は # で始めてください（違反すると 400）。

応答の delivered は、送った相手の数です（誰もいなければ 0）。リクエストは、ルームを開いているノードへ転送されます。

ルームを開いているノードに接続している参加者ごとに、次の値を返します: RTT（往復の遅延）、推定帯域、送受信の量、送信している層（サイマルキャストで画質ごとに分けて送る映像）ごとのビットレート、受信している層、クライアントの getStats の要約。

カスケードで別のノードにいる参加者は含みません。リクエストは、ルームを開いているノードへ転送されます。

ルームのメディアパイプラインを作成します。desired_state の既定は running なので、作成するとすぐ、ルームを開いているノードが実行を始めます。

メディアパイプラインはルームあたり 8 つまでです（超えると 403 QUOTA_EXCEEDED）。name はテナント内で一意です（重複すると 409）。

H.264・H.265 で合成するには GPU が必要ですが、作成のときには確かめません。GPU が無ければ、合成のパイプラインの配置や検証で失敗し、そのパイプラインの placement_status に表示されます。

主なエラー（この順に検査します）:

• 本文の形式の誤り: 400（INVALID_REQUEST）・415
• room がテナントのルームでない: 400（INVALID_CONFIG）
• 内容の誤り（下の一覧を参照）: 400（INVALID_CONFIG）
• name の重複: 409
• ルームあたりの上限を超えた: 403（QUOTA_EXCEEDED）

内容の検査（この順に行います）:

• name: 1〜40 文字の英数字と -_.（. で始めることはできません）。エクスポートするストリームの名前に使うため、ストリームの名前より短くしてあります
• desired_state: running か stopped
• participants: 100 人まで。それぞれ 1〜255 バイト
• composite: layout（grid・speaker）、サイズ（幅 64〜3840・高さ 64〜2160 の偶数）、fps（1〜60）、video_codec（av1・vp9・vp8・h264・h265）、bitrate_kbps（100〜50000）
• recording: composite: true には composite の指定が、participants: true には export_participants: true が必要です。retention_days は 1〜36500 です。 recording の participants・composite は、省略すると true になります。composite の無いメディアパイプラインで recording を指定するときは、composite: false を明示してください
• egress: composite が必要です（合成した 1 本を送ります）。8 個まで指定できます。各要素には、出力（OutputCreate）と同じ検査を行います（protocol、paas 以外では url、paas では provider、credential_ref のシークレット、options）
• captions: ストリームの captions と同じ検査を行います（CaptionSettings）。export_participants: true が必要です

テナントのメディアパイプラインを、ID の昇順で返します。room でルームを指定して絞り込めます（値は URL デコードしてから比べます）。

定義と、作られたリソース（artifacts）、このノードでの実行の状態（status）を返します。ほかのテナントのものは 404 です。

指定した項目だけを置き換えます（MediaPipelinePatch）。If-Match が必須です。desired_state: stopped で停止し、running で実行します。

composite・recording・captions は null で設定を削除できます。ほかの項目の null は「変更しない」という意味です。egress は配列全体を置き換えます。

room は変更できません（知らない項目として 400）。ルームの設定 recording から作られたもの（managed: true）も変更できません（409）。ルームの設定のほうを変更してください。

stopped にする、composite を外す、egress を変更する、のいずれかを行うと、それまでの定義で作った合成のパイプラインと外部配信の出力を削除します（動かし続ける場合は作り直します）。エクスポートしたストリームはそのまま残ります。participants を減らしても、対象から外れた参加者のストリームは残ります。

name を変更するときも、テナント内での重複を検査します（409）。

主なエラー（この順に検査します）: If-Match が無い・誤っている（428・412）、本文の形式の誤り（400・415）、メディアパイプラインが無い（404）、世代が古い（412）、作成と同じ内容の検査（400）。

メディアパイプラインと、それが作った合成のパイプラインと外部配信の出力を削除します（配信サービス側のリソースも後片付けします）。エクスポートしたストリーム（参加者ごと・合成）と録画は残ります。

managed: true のものは削除できません（409）。ルームの設定 recording を none にしてください。

参加者のエクスポートは、ルームを開いているノードが次に確かめたとき（1 秒以内）に止まります。If-Match は検査しません。

接続を開いたまま、リソースの変化をイベントとして送り続けます。届くのは、自分のテナントのイベントだけです。15 秒ごとに、接続を保つためのコメント行を送ります。

テナントに属さないイベント（node.updated・stream.owner、グリッドの node.down・node.up・device.down・device.up・device.disabled・device.enabled・grid.decisions）は、node:admin の権限を持つ利用者にだけ届きます。

SSE の event はイベントの種類で、data は SseEventData の JSON です。id はイベントの通し番号（クラスターに反映した変更の数）です。クラスターではどのノードでも同じ値になるため、別のノードへ再接続しても Last-Event-ID をそのまま使えます。

届くイベントは次のとおりです。

• リソースの変更: stream.created・stream.updated・stream.deleted・stream.owner・recording.updated・recording.deleted・schedule.created・schedule.updated・schedule.deleted・schedule.run・node.updated・input.updated・input.deleted・output.updated・output.deleted・secret.created・secret.deleted・pipeline.updated・pipeline.deleted・room.updated（ルームの作成・自動作成・更新。data: {auto}）・room.deleted・media_pipeline.updated（メディアパイプラインの作成・更新。data: {room, desired_state}）・media_pipeline.deleted、グリッドの node.down・node.up・device.*・grid.decisions（resource_id は空、data: {decisions}）。
• ルーム: room.started（ルームが開かれた）・room.stopped・room.connection.created・room.connection.updated・room.connection.destroyed・room.track.published・room.track.unpublished・room.spotlight.changed。これらは、ルームを開いているノードに接続した購読者にだけ届き、クラスターの記録には残りません。 ルームのイベントには SSE の id がありません。そのため Last-Event-ID での再開の対象にならず、受け取り損ねた分は、何の知らせもなく失われます。data には event_id（イベントの ID）と node（ノードの ID）が入り、イベントの内容は data.data に入ります。node:admin の権限があっても、ほかのテナントのものは届きません。 ルームを削除したとき（DELETE /rooms/{id} や、自動作成したルームの自動削除）も、room.stopped と、そのとき切断された参加者の room.connection.destroyed が届きます。

接続が切れたときは、Last-Event-ID を付けて再接続してください。その番号より後のイベントのうち、ノードに残っている分を先に送り、続けて新しいイベントを送ります。ノードが残すのは、直近の --events-retain 件（既定 4096 件）です。単一ノードでは、再起動した後も、保存した状態のスナップショットより後の分が残ります。

指定した番号が、残っている範囲より古いときは、最初に event: resync（id は今の番号、data: {}）を送ります。状態を読み直してから、この id で続きを受け取ってください。クラスターで、接続したノードへの反映が Last-Event-ID に追いついていなければ、最大 3 秒待ちます（追いつかなければ resync を送ります）。

送信が追いつかずに知らせがあふれたときは、残っている分から続きを送ります。残っていなければ、event: resync を送って接続を閉じます。

リソースの変更のイベントの data には、event_id・generation がありません（event_id に当たるのは SSE の id です）。occurred_at は変更を反映した時刻です（再起動の後に読み直したイベントでは、読み直した時刻）。24 時間分を残して再送する仕組みはありません。

401・403 のエラーは、ほかの API と同じ problem+json で返します。

管理 API を呼び出すための API トークンを発行します。トークンの値（token。senca_ で始まります）が返るのは、この応答だけです。必ず控えてください。同じ Idempotency-Key で再送したときの応答では null になり、token_redacted: true が付きます。

自分が持っていない権限を、新しいトークンに付けることはできません（403）。トークンはテナントあたり 100 個までで、超えると 403（QUOTA_EXCEEDED）です。

トークンを ID の昇順で返します。トークンの値は含みません。

トークンを削除して、使えなくします。テナントに残っている最後の tenant:admin のトークンは削除できません（409）。

このノードが対応している API の版、コーデック、機能を返します。

クラスターのノードをすべて返します。ページングはなく、応答は items だけです（next_cursor はありません）。クエリパラメーターは無視します。

ノード 1 台の情報を返します。

保守の前などに、ノードを drain の状態（新しいワークロードを受けない状態）にします。応答は draining: true になったノードです。リクエストの本文は無視します。

グリッドに登録されたノードであれば、グリッド側の draining も変更します。このノードには新しいワークロードを配置しなくなり、配置済みのワークロードは、移せるものから別のノードへ移します（reason.code: draining）。

drain 中のノードは、新しい配信（RTMP・SRT・WHIP での送信）を拒否します。RTMP では NetStream.Publish.Rejected、SRT では拒否理由 1503 を返します。WHIP では drain 中でない別のノードの /whip/... へ 307 でリダイレクトし、そのようなノードが無ければ 503 を返します。

すでにつながっている配信者と視聴者は、切断しません。

drain を解除して、ノードが新しい割り当てを受けられるようにします。応答は draining: false になったノードです。グリッドに登録されたノードであれば、グリッド側の draining も元に戻します。

今のところ、リクエストを受けたノード自身のデバイスだけを返します。コーデックワーカー（変換を担当する別プロセス）につながっていないときは、devices は空です。

スケジューラーが把握しているグリッドの状態を返します。

ノードごとに、登録された内容（容量・GPU・キャプチャ機器・ラベル）と予約（割り当てたワークロードが求める資源の合計）を返します。ワークロードごとに、割り当て先・デグレードレベル・配置できない理由を返します。デグレードとは、資源が足りないときに処理の一部を止めて、品質を下げて動かし続けることです。

テナントで絞り込まずにすべてを返すため、node:admin が必要です。クエリパラメーターは無視します。

last_heartbeat は、応答したノードがスケジューラー（リーダー）の場合にだけ値が入ります。

グリッドのデバイスを手動で無効にします（enabled: false）。デバイスの故障や保守のときに使います。これは、計測で決まる健全性（healthy）とは別の設定です。リクエストの本文は無視します。

無効にしたデバイスを使っていたワークロードは、別のデバイスやノードへ移るか、デグレードして動き続けます。ただし、placement.pin_policy: strict でそのデバイスに固定したワークロードは、止まったままになります。

無効にした状態はクラスター全体に記録され、ハートビートやノードの再登録では元に戻りません。enable で戻すまで続きます。

ノード（ID または名前）やデバイスがグリッドに無ければ 404 です。

手動で無効にしたデバイスを、有効に戻します（enabled: true）。リクエストの本文は無視します。

ほかへ移ったワークロードやデグレードしたワークロードは、クールダウン（一定の待ち時間）の後に元へ戻ります（reason.code: pin_returned・capacity_returned）。

ノード（ID または名前）やデバイスがグリッドに無ければ 404 です。

映像・音声のメディアプレイリストを返します。LL-HLS のブロッキング・リロード（新しいセグメントができるまで応答を待たせる方式）に対応しています。

ストリームに captions を設定していて字幕ができ始めると、字幕付きのマルチバリアントプレイリスト（master.m3u8）も取得できます（GET /s/.../live/{stream}/{file}）。

このノードも、リダイレクト先にできるほかのノードも配信を受信していなければ 404 です。

ライブ HLS のファイルを、ノードのメモリから返します。

• セグメント・part・init: video/mp2t・video/mp4・video/iso.segment で返します。Cache-Control: max-age=60 です。
• 字幕（ストリームに captions を設定しているとき）: master.m3u8（index.m3u8 と、字幕の EXT-X-MEDIA:TYPE=SUBTITLES をまとめたマルチバリアントプレイリスト）、sub_{lang}.m3u8（言語ごとの字幕のメディアプレイリスト。lang は captions.language と captions.targets の言語）、sub_{lang}_{n}.vtt（WebVTT のセグメント。古いものから削除されます）。 どれも Cache-Control: no-cache です。字幕がまだできていなければ 404 です。

確定した録画は VOD（ENDLIST あり）として、録画中の録画は EVENT（ENDLIST なし）として返します。削除中の録画は 404 です。

録画のセグメントを返します。Range ヘッダーで一部だけを取得できます。

ノードのプロセスが動いていれば、200 と ok を返します。

起動の処理が終わると 200 を返します。停止の処理中（SIGTERM を受けた後）は 503 です。クラスターでは、過半数のノード（またはリーダー）との通信が 4 秒を超えて途絶えている間も 503 です。このときノードは、グリッドのワークロードを止めています。