VideohatiDocs
API referenceProjects

Get the project's encoding settings

Get the project's encoding settings

GET/v1/projects/{id}/encoding-settings

This 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) encoding document the project snapshots onto future uploads. The response carries id and encodingSettings; 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 the projectId query parameter under cookie auth.

Parameters

NameInTypeRequiredDescription
idpathstring (Ulid)Yes

Request body

This operation takes no request body.

Responses

StatusMeaning
200The effective encoding settings.
401No valid credential was presented.
404The resource does not exist or is not visible to this caller.
429Rate limit exceeded.