Skip to navigation

Clear the retained scripture stack

Clear the owned Live’s scripture stack and return its actual affected count, empty data and new ETag. The Live returns to hidden Reader state with pause off. Requires the current Live ETag in If-Match; missing/stale conditions return 428/412. This is separate from deleting the Live. 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
affectedinteger>=0
datalist of objects