# BrainTube REST API API

**Canonical:** https://apis.io/apis/brain-tube-com/braintube-rest-api-api/  
**Provider:** BrainTube — https://apis.io/providers/brain-tube-com/  
**Base URL:** https://mcp.brain-tube.com  
**Documentation:** https://brain-tube.com/developers

BrainTube REST API API is one of 2 APIs that [BrainTube](https://apis.io/providers/brain-tube-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Personal knowledge corpus API covering search, corpus stats, bookmarks, ingest, and Brains over plain HTTP for use by web apps, mobile clients, and chat widgets. This is a subset of the full BrainTube MCP tool set, not a mirror of it. Authenticate with either a Supabase JWT via `Authorization: Beare

## Operations (18)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/search` | Search knowledge corpus |
| GET | `/api/search/source` | Search filtered by source type |
| GET | `/api/search/date` | Search within a date range |
| GET | `/api/stats` | Corpus statistics |
| GET | `/api/recent` | Recently saved items |
| GET | `/api/related/{item_id}` | Semantically related items |
| GET | `/api/resurface` | Random resurface (spaced repetition) |
| GET | `/api/expertise` | Knowledge expertise profile |
| GET | `/api/conversations` | Recent AI conversations |
| GET | `/api/session-brief` | Session bootstrap (expertise + conversations + stats) |
| GET | `/api/bookmarks` | List bookmarks |
| POST | `/api/bookmark/{item_id}` | Bookmark / unbookmark / mark read |
| POST | `/api/ingest` | Ingest a single item |
| POST | `/api/bulk-ingest` | Ingest up to 50 items |
| POST | `/api/tag/{item_id}` | Add or remove tags |
| GET | `/api/brains` | List user's Brains |
| POST | `/api/brain-chat/{slug}` | Chat with a public Brain or one of your own |
| POST | `/api/note/{item_id}` | Add or update a note on an item |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/brain-tube-com/openapi/_original/brain-tube-com-api-openapi.json
- **JSONSchema** — https://artifacts.apis.io/brain-tube-com/json-schema/brain-tube-com-ingest-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/brain-tube-com/json-schema/brain-tube-com-bookmark-schema.json
- **JSONSchema** — https://artifacts.apis.io/brain-tube-com/json-schema/brain-tube-com-stats-schema.json
- **JSONSchema** — https://artifacts.apis.io/brain-tube-com/json-schema/brain-tube-com-bulk-ingest-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/brain-tube-com/json-schema/brain-tube-com-tainted-search-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/brain-tube-com/json-schema/brain-tube-com-bulk-ingest-response-schema.json

## Other BrainTube APIs (1)

- [BrainTube REST API](https://apis.io/apis/brain-tube-com/braintube-rest-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/brain-tube-com/braintube-rest-api-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/brain-tube-com/.