Workspace

Update the profile

Update the brain profile's directives. These take effect on subsequent captures, not retroactively.

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

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.
whoTheyArestringOptional
Who the subject is. Omit to leave unchanged.
whatTheyDostringOptional
What the subject works on. Omit to leave unchanged.
focusstringOptional
Current focus. Omit to leave unchanged.
goalsstringOptional
Current goals. Omit to leave unchanged.
currentProjectsstringOptional
Projects in flight. Omit to leave unchanged.
stuckOnstringOptional
Known blockers. Omit to leave unchanged.
vaultOrganizationstringOptional
Organization preference. Omit to leave unchanged.
directivesobjectOptional
Standing instructions. Omit to leave unchanged.

Response

idstring
Profile id
tenantIdstring
Owning tenant id
subjectIdstring

Owning subject id (host-defined)

brainIdstring
Owning brain id
whoTheyArestring

Who the subject is — role, background, and context that frames how captures are interpreted.

whatTheyDostring
What the subject works on day to day.
focusstring
What the subject is concentrating on right now.
goalsstring
What the subject is trying to achieve.
currentProjectsstring
Projects currently in flight.
stuckOnstring
Known blockers, so the brain can surface relevant material.
vaultOrganizationstring
How the subject prefers their knowledge organized.
directivesobject or null
Standing instructions that shape how new captures are compiled.
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