Skip to navigation

Remove audience-secret protection

Remove audience-secret protection from the owned Live. Returns protection state, sequence and ETag, without a secret. Requires the current Live ETag in If-Match (428 if missing, 412 if stale). This changes viewer protection, not the REST bearer credential or Live ownership. Idempotency-Key is unsupported.

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.

Response headers

ETagstringOptional

Response

Successful operation
live_idstring
sequenceinteger>=0
protectedboolean
secretstringOptional