Workspace

Edit page content

Manually overwrite a page's content. This creates a new version, so the previous content stays retrievable through the version history.

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.

Request

This endpoint expects an object.
titlestringOptional

Human-readable title.

summarystringOptional
Short generated summary of the content.
bodystringOptional
New page content. Replaces the existing body and creates a new version.

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