Skip to navigation

List your personal Lives

Required scopes: live.list.

Personal-account owner access only. Fresh finite personal token authority, active membership/user/account and account boundary checks apply. No organization/collaborator/child-actor authority. GET uses limit/after pagination. POST creates a Reader Live with the existing personal library and plan quota, serialized under the personal account lock; quota exhaustion returns 409. Creation does not enable organization-only presentation or Live Studio features. Returns the individual /lives/{live_id} URL. Registered delegated OAuth access tokens are accepted within these personal boundaries; /me and account metadata additionally require identity.read.

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

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

account_idstringRequiredformat: "uuid"

Caller’s own immutable personal account UUID; other personal or organization accounts return 404.

Query parameters

limitintegerOptional1-100Defaults to 50
afterstringOptional<=128 characters

Opaque cursor returned as next_cursor.

Response headers

X-Request-IdstringOptional

Server-generated correlation ID.

Response

Successful read
datalist of objects
next_cursorstring or null

Pass this value unchanged as after; null ends the collection.

Errors

401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error
503
Service Unavailable Error