Brains

Create a brain

Create a new brain for the calling subject. A brain is an isolated knowledge vault: every capture, page, and connection belongs to exactly one brain. The x-subject-id header determines who owns it.

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.

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.
namestringRequired

User-facing name of the brain

descriptionstringOptional
Optional description

Response

idstring
Brain id
tenantIdstring
Owning tenant id
subjectIdstring

Owning subject id (host-defined)

namestring

User-facing name

slugstring

URL-safe identifier, unique per (tenant, subject)

descriptionstring
Description
briefSettingsobject or null

Daily-brief schedule and delivery settings for this brain.

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