Brains

Overview

Brains are knowledge bases the AI uses to answer questions. Each brain contains articles and can be attached to a channel so that its AI agent draws on that content. Workspaces can have up to 10 brains.

Admin role is required to create, update, or delete brains and their articles.

List Brains

GET /api/brains

Example Response

{
    "data": [
        {
            "id": 1,
            "ulid": "01hx9f3k2a...",
            "name": "Support KB",
            "additional_instructions": null,
            "article_count": 12,
            "created_at": "2026-04-13T10:00:00+00:00"
        }
    ]
}

Show Brain

GET /api/brains/{brain}

Create Brain (admin only)

POST /api/brains

Request Body

Field	Type	Required
name	string	Yes
additional_instructions	string	No

Update Brain (admin only)

PUT /api/brains/{brain}

Same body as create.

Delete Brain (admin only)

DELETE /api/brains/{brain}

Channels attached to the deleted brain have their brain reference cleared.

Brain Articles

Articles belong to a brain. They are indexed for semantic search so the AI can surface them as answers.

List Articles

GET /api/brains/{brain}/articles

Show Article

GET /api/brains/{brain}/articles/{article}

Create Article (admin only)

POST /api/brains/{brain}/articles

Request Body

Field	Type	Required	Description
title	string	Yes
body	string	Yes	Markdown body
is_public	boolean	No	Defaults to true

Update Article (admin only)

PUT /api/brains/{brain}/articles/{article}

Omit fields to leave them unchanged.

Delete Article (admin only)

DELETE /api/brains/{brain}/articles/{article}