Update the project's playback session settings

This operation supports dashboard session-cookie authentication. Call it only from trusted server code; browsers must not manufacture or expose the session cookie.

Partial update: send only the fields that change. Setting a field to null resets it to inherit the plan/platform default. The stored document is always the full effective object, and the response returns it. A patch whose committed result would leave sessionTtlDefaultSeconds above sessionTtlMaxSeconds is rejected. Session-cookie auth only. Rate limit: 60 requests per 60 s per session.

Error codes: unauthorized (401), not_found (404), invalid_session_settings (400).

Authentication

• sessionCookie — Dashboard session cookie set by POST /v1/auth/login. Video and playback endpoints additionally require the projectId query parameter under cookie auth.

Parameters

Request body

required

Content type: application/json

Schema: SessionSettingsPatch

{
  "concurrentStreamsPerViewer": 2,
  "evictionGraceSeconds": 120
}

Responses

Example request

{
  "concurrentStreamsPerViewer": 2,
  "evictionGraceSeconds": 120
}