API Reference
Base URL
Section titled “Base URL”http://<host>:8080/api/v1/Authentication
Section titled “Authentication”Most endpoints require a JWT token in the Authorization header:
Authorization: Bearer <token>Relay endpoints use a relay token instead of a JWT. See Connections for details.
Content type
Section titled “Content type”All request and response bodies use application/json unless otherwise noted.
Error format
Section titled “Error format”Errors return a JSON object with a human-readable message:
{"error": "Human-readable message"}Endpoints
Section titled “Endpoints”Concourse exposes 46 endpoints across 8 modules:
| Module | Endpoints | Description |
|---|---|---|
| Health & Discovery | 3 | Health check, autodiscovery |
| IAM | 8 | Authentication (password, OIDC, SAML) |
| Org | 7 | User management |
| Board | 14 | Kanban boards, tasks, comments |
| Workspace | 16 | Workspaces, members, threads, comments, WebSocket |
| Helm (AI Agents) | 5 | AI agent management |
| Connections | 10 | Database relay management, query dispatch |
| Shopkeep (Extensions) | 9 | Extension registry |