Brain

POST /v1/brain/doc/tag

Set/replace a document's frontmatter tags (SDK/CLI; agent uses `sed`).

POST /v1/brain/doc/tag

Set/replace a document's frontmatter tags (SDK/CLI; agent uses sed).

Required scope: brain:write

Body fields

Name	Required	Notes
`path`	yes
`add`	no	Tags to add.
`remove`	no	Tags to remove.

Example

curl -X POST 'https://brain.unisonlabs.ai/v1/brain/doc/tag' \
  -H "Authorization: Bearer $UNISON_TOKEN" \
  -H 'content-type: application/json' \
  -d '{"path": "/private/notes/kickoff.md", "add": ["decision"], "remove": ["draft"]}'

Returns the JSON described above on success, or an error envelope { "error": { "code", "message" } } on failure.

DELETE /v1/brain/doc

Delete a brain .md document by path (SDK/CLI; agent uses `rm`).

GET /v1/brain/search

Hybrid BM25 + dense semantic search over the brain (SDK/CLI; agent uses semantic-search synth).