Skip to main content
POST
Attach a brain context capsule

Authorizations

Authorization
string
header
required

Workspace API key. Create one via the dashboard or POST /v1/auth/keys.

Headers

X-Naive-Project-Id
string<uuid>

Act inside this project. The header form of the /v1/projects/{project_id}/... prefix, for clients that cannot rewrite their base path. Lower precedence than the path, higher than the key's pinned project; omitted resolves to the organization's default project.

Path Parameters

user_id
string
required

Tenant user id, or default/me.

Body

application/json
goal
string
required

What the run is trying to do.

Maximum string length: 4000
entities
string[]

Entities in scope.

artifacts_touched
string[]

Artifacts the run touches.

since_watermark
string<date-time>

Previous capsule as_of, for deltas.

knowledge_base_id
string<uuid>

Knowledge base to scope to; defaults to the company default.

Response

Context capsule.

space
object
as_of
string<date-time>
beliefs
object[]
working_set
object[]
deltas
object
open_questions
string[]
citation_map
object
capsule_id
string
render
string