API Reference
Base URL: http://localhost:10334. All endpoints require Authorization: Bearer <token> unless noted.
Auth
| Method | Path | Description |
|---|
| POST | /auth/exchange | Exchange vuer-auth token for dreamlake JWT (no auth required) |
| GET | /auth/me | Current user profile |
| PATCH | /auth/me | Update profile |
Namespaces & Projects
| Method | Path | Description |
|---|
| GET | /auth/namespaces | List public namespaces (no auth) |
| GET | /namespaces/:slug | Namespace overview with asset counts |
| PATCH | /namespaces/:slug | Update namespace (owner only) |
| GET | /namespaces/:slug/projects | List projects |
| POST | /namespaces/:slug/projects | Create project |
| PATCH | /namespaces/:slug/projects/:proj | Update project |
Episodes
| Method | Path | Description |
|---|
| POST | /namespaces/:slug/projects/:proj/episodes | Create/upsert episode |
| GET | /namespaces/:slug/projects/:proj/episodes | List episodes (paginated) |
| PATCH | /namespaces/:slug/projects/:proj/episodes/:name | Update episode |
Nodes (File Tree)
| Method | Path | Description |
|---|
| POST | /nodes | Create node (auto-creates hierarchy) |
| GET | /nodes | List nodes by namespace/project/kind |
| GET | /nodes/children | List 1-level children |
| GET | /nodes/lookup | Resolve node by materialized path |
| GET | /nodes/:id/descendants | All descendants (recursive) |
| GET | /nodes/:id/contents | Episodes + files (paginated) |
| GET | /nodes/:id/download | Presigned S3 download URL |
| PATCH | /nodes/:id | Update node (name, move, tags) |
| DELETE | /nodes/:id | Hard-delete node + descendants |
Files
| Method | Path | Description |
|---|
| POST | /episodes/:id/files | Upload file (multipart) |
| GET | /episodes/:id/files | List files |
| GET | /episodes/:id/files/:fid/download | Download file |
| DELETE | /episodes/:id/files/:fid | Delete file |
Tracks & Logs
| Method | Path | Description |
|---|
| POST | /episodes/:id/tracks/:name/append | Append data point |
| POST | /episodes/:id/tracks/:name/append-batch | Append batch |
| GET | /episodes/:id/tracks/:name/data | Read track data |
| GET | /episodes/:id/tracks | List tracks |
| POST | /episodes/:id/logs | Create log entries |
| GET | /episodes/:id/logs | Query logs (level, time, search) |
Parameters
| Method | Path | Description |
|---|
| POST | /episodes/:id/parameters | Set/merge parameters |
| GET | /episodes/:id/parameters | Get parameters |
| DELETE | /episodes/:id/parameters | Soft-delete |
Bindrs & Datasets
| Method | Path | Description |
|---|
| POST | …/bindrs | Create bindr |
| GET | …/bindrs | List bindrs |
| GET | …/bindrs/:name | Get bindr |
| PATCH | …/bindrs/:name | Update bindr |
| DELETE | …/bindrs/:name | Soft-delete |
| POST | …/bindrs/:name/members | Add members |
| DELETE | …/bindrs/:name/members | Remove members |
| POST | …/datasets | Create dataset |
| GET | …/datasets | List datasets |
| GET | …/datasets/:name | Get dataset with bindrs |
| PATCH | …/datasets/:name | Update dataset |
| DELETE | …/datasets/:name | Soft-delete |
All bindr/dataset paths are under /namespaces/:slug/projects/:proj/.
Search
| Method | Path | Description |
|---|
| POST | /projects/:id/search | Project-wide vector search |
| POST | /projects/:id/episodes/:eid/search | Episode-scoped search |
| POST | …/assets/search | Semantic search (CLIP text/image) |
Health
| Method | Path | Description |
|---|
| GET | /health | Server status (no auth) |