Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.productbrain.com/llms.txt

Use this file to discover all available pages before exploring further.

The ProductBrain API lets LLM agents and scripts read, search, and modify your project. It’s the same API that Claude Code, Cursor, and other AI agents use to operate on your planning tree.

​
Base URL

https://productbrain.com/api

​
Authentication

All requests require a Bearer token — either a per-user API key or a Clerk session JWT. 
curl -H "Authorization: Bearer pb_your_api_key" \
  https://productbrain.com/api/nodes?projectId=your-project
API keys are generated from Settings in the app. Each key is scoped to the projects owned by the key’s user.

​
Endpoints

EndpointMethodPurpose
/api/nodesGETList all nodes in a project (filterable by type, iteration)
/api/searchGETSemantic search over nodes using vector embeddings
/api/mutatePOSTCreate, update, or delete nodes
/api/iterationsGETList iterations (filterable by status, &current=true for active)
/api/treeGETGet a node with its ancestors, siblings, and children

​
Key Concepts

Search First

Use /api/search?q=... to find nodes by meaning. Don’t pull all nodes and filter — the search endpoint uses vector embeddings for semantic matching.

Mutations are atomic

Each /api/mutate call performs one operation: add, update, or delete. Batch mutations use the app’s internal batch endpoint.

​
Full Reference

For the complete API contract — data model, field validation rules, hierarchy constraints, and worked examples — see the LLM Operations Guide.