Brain

PUT /v1/brain/doc

Create or overwrite a brain .md document (SDK/CLI; agent uses a Bash heredoc).

PUT /v1/brain/doc

Create or overwrite a brain .md document (SDK/CLI; agent uses a Bash heredoc).

Required scope: brain:write

Body fields

Name	Required	Notes
`path`	yes
`bodyMd`	no
`kind`	no
`title`	no

Example

curl -X PUT 'https://brain.unisonlabs.ai/v1/brain/doc' \
  -H "Authorization: Bearer $UNISON_TOKEN" \
  -H 'content-type: application/json' \
  -d '{"path": "...", "bodyMd": "...", "kind": "..."}'

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

GET /v1/brain/doc

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

PATCH /v1/brain/doc

Surgical str_replace edit of a doc body — oldStr must match exactly once (SDK/CLI; agent uses str_replace_based_edit_tool).