Skip to navigation
API referenceLive Controls

Remove a positive count from the retained stack tail

Remove up to count entries from the owned Live’s scripture stack; omitted count defaults to 1. A count larger than the stack removes all remaining entries. Returns the actual affected count and updated stack with ETag. Empty stacks return 409 stack_empty. Requires the current Live ETag in If-Match; missing/stale conditions return 428/412. Idempotency-Key is unsupported; do not automatically retry an ambiguous removal.

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.
countintegerOptional1-2147483647Defaults to 1

Response headers

ETagstringOptional

Response

Successful operation
live_idstring
sequenceinteger>=0
affectedinteger>=0
datalist of objects