Brains

Bulk brain stats

Aggregate counts for many brains in one round trip. Pass a comma-separated ids list; brains the caller cannot access are omitted rather than erroring.

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.

Query parameters

idsstringOptional

Comma-separated brain ids, e.g. ids=a,b,c. Unowned ids are omitted.

Response

Stats keyed by brain id
pageCountinteger

Active (non-deprecated, non-archived) pages

deprecatedPageCountinteger

Deprecated/stale pages awaiting review or recovery

archivedPageCountinteger
Archived pages
sourceCountinteger
Ingest sources ever pushed to the brain
connectionCountinteger
Connections between active pages
agentCountinteger

Host concept; always 0 here (the host may merge its own count)

estimatedBytesinteger
Approximate size of all page bodies in bytes
bucketCountsmap from strings to doubles
Active page count per bucket
lastActivityAtstring or null

ISO timestamp of the last compile/read activity

Errors

400
Bad Request Error
401
Unauthorized Error