Search, labels, and models
Global search, org labels, and the model catalog API.
Utility routes that power dashboard search, labeling, and the shared model picker.
Endpoints
| Method | Path | Description |
|---|---|---|
GET | /api/v1/search | Global search across projects, files, and agents (q, filters). |
GET | /api/v1/models | List available models and pricing metadata (models:read scope when using API keys). |
GET | /api/v1/labels | List org labels. |
POST | /api/v1/labels | Create a label. |
PATCH | /api/v1/labels/:id | Update a label. |
DELETE | /api/v1/labels/:id | Delete a label. |
POST | /api/v1/labels/:id/assign | Assign a label to a resource. |
GET | /api/v1/labels/assignments | List label assignments. |
GET | /api/v1/health | Health check (no auth). |
Search
GET /api/v1/search returns mixed results for the authenticated org. Use it to build cross-resource lookup in custom dashboards or internal tools.
Models
GET /api/v1/models mirrors the app model catalog documented in Models. API keys with only models:read may call this route even when other prefixes are scope-gated.
Labels
Labels tag projects, tasks, and other org resources for filtering. Assignments are org-scoped; nested writes validate target ownership before linking a label.
Health
GET /api/v1/health is unauthenticated and used by load balancers and deploy smoke tests.