Get the project's playback session settings
Get the project's playback session settings
/v1/projects/{id}/session-settingsThis operation supports dashboard session-cookie authentication. Call it only from trusted server code; browsers must not manufacture or expose the session cookie.
Returns the effective (defaults-merged) per-project playback session
policy: concurrent streams per viewer, session TTL default/max,
eviction grace, and heartbeat tolerance. Every field is nullable and
null means "inherit" — the plan value (concurrent streams) or the
platform default (TTL/grace) applies. The response carries id and
sessionSettings; it omits updatedAt (only the PATCH response
carries it). Session-cookie auth only. Rate limit: 60 requests per
60 s per session.
Error codes: unauthorized (401), not_found (404).
Authentication
- sessionCookie — Dashboard session cookie set by
POST /v1/auth/login. Video and playback endpoints additionally require theprojectIdquery parameter under cookie auth.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id | path | string (Ulid) | Yes | — |
Request body
This operation takes no request body.
Responses
| Status | Meaning |
|---|---|
200 | The effective session settings. |
401 | No valid credential was presented. |
404 | The resource does not exist or is not visible to this caller. |
429 | Rate limit exceeded. |