Push retained scripture with optional selected translations
Append the requested scripture reference to the owned Live’s scripture stack. The reference requires book_id; omit chapter for a whole book, include chapter for a chapter, and add verse for a single verse. A verse requires a chapter. Omit translation to use the Live’s configured translations; missing configuration returns 409 translations_not_configured. Current enabled-library access is required. Returns the updated stack, affected count, sequence and ETag. Requires the current Live ETag in If-Match; missing/stale conditions return 428/412. Invalid references return 422, denied access 403, and domain state conflicts 409. Idempotency-Key is unsupported; never automatically replay an ambiguous push.
Required scopes: live.update, translation.read. Scopes intersect current authority; browser cookies never authenticate REST.
Authentication
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.
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.
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
Headers
Current strong Live ETag. Missing:428; stale:412. No automatic retry.