Workspace

Read a page

Read a single page by slug. This bumps the page’s lastReferencedAt, which feeds the brain health score — use it when a human or agent actually consumes the content.

Authentication

x-api-keystring

Your Living Brain API key. Create one from the dashboard; keys are scoped to an organization and carry the role of the member they were issued to.

Path parameters

brainIdstringRequired
Brain id
slugstringRequired
Page slug

Headers

x-subject-idstringRequired
Identifies the end user the request is made on behalf of. Brains are owned by a subject, so this determines which brains the caller can see.

Query parameters

includeDeprecatedbooleanOptional

Response

idstring
Page id
tenantIdstring
Owning tenant id
subjectIdstring

Owning subject id (host-defined)

brainIdstring
Owning brain id
sourceobject or null
Opaque provenance
pageTypeenum
What kind of knowledge this page holds.
bucketenum

Top-level grouping the page belongs to.

bucketSourceenum
Whether the bucket was set automatically or by the user
slugstring

URL-safe identifier, unique per brain

titlestring

Human-readable title.

summarystring
Short generated summary of the content.
bodystring
Markdown body
entitieslist of strings
Named entities extracted from the body
sourceslist of objects
Contributing ingest sources
embeddinglist of doubles

Vector embedding used for semantic search (internal; can be large)

versioninteger

Monotonic version, bumped on every compile/edit

pinnedboolean
Pinned pages rank first in the prompt index and are exempt from deprecation.
archivedboolean
Whether the page has been retired by the user.
statusenum
Lifecycle state. Deprecated and archived items are hidden from listings by default.
lastCompiledAtdatetime
ISO 8601 timestamp of the last time this page was recompiled from its sources.
lastReferencedAtdatetime or null
ISO 8601 timestamp of the last read. Reading a page bumps this, and it feeds the brain health score.
createdAtdatetime
ISO 8601 timestamp of when this record was created.
updatedAtdatetime
ISO 8601 timestamp of when this record was last modified.

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error