Skip to navigation
API referenceLive Controls

Update retained reference and translations

Partially update the owned Live’s reference and/or selected translations. At least one field is required. Current library access and selection quotas apply; this does not install or enable editions. Requires the current Live ETag in If-Match: missing conditions return 428, stale conditions 412 and invalid input 422. The response includes the updated settings and ETag. No automatic replay or retry is provided.

Required scopes: live.update. Scopes intersect current authority; browser cookies never authenticate REST.

Authentication

AuthorizationBearer

Personal bearer credential issued through existing account settings or browser-approved CLI flow. Must be active, finite, unexpired, unrevoked, within any rotation overlap, and bound to an active personal membership/user/account. Explicit scopes intersect current user permissions; empty existing personal scopes inherit current user authority. Not an OAuth grant or service token. Browser cookies are ignored.

OR
AuthorizationBearer

Organization-owned service token. Issue the initial token in organization credential settings. Scopes are documented per operation via x-required-scopes; they are not OAuth scopes.

OR
AuthorizationBearer

Registered public-client OAuth for personal-account resources only. Exact registered HTTPS or fixed-port literal loopback redirect; S256 required; explicit consent. No organization/presentation authority. identity.read is required for /me and account metadata. Scope intersection with current user authority; no empty-scope inheritance.

Path parameters

live_idstringRequired

Headers

If-MatchstringRequired

Current strong Live ETag. Missing:428; stale:412. No automatic retry.

Request

This endpoint expects an object.
referencestringOptional1-256 characters
translationslist of stringsOptional

Response headers

ETagstringOptional

Response

Successful operation
live_idstring
sequenceinteger>=0
referencestring or null
translationslist of strings