Base URL
Authentication
All requests require:Authorization: Bearer <supabase_jwt_token>
Endpoints Overview
Authentication
| Method | Endpoint | Description |
|---|---|---|
| GET | /auth/me | Get current user profile |
| POST | /auth/refresh | Refresh JWT token |
Workspaces
| Method | Endpoint | Description |
|---|---|---|
| GET | /workspaces | List user workspaces |
| POST | /workspaces | Create new workspace |
| GET | /workspaces/{id} | Get workspace details |
| PATCH | /workspaces/{id} | Update workspace |
| DELETE | /workspaces/{id} | Delete workspace |
Standards
| Method | Endpoint | Description |
|---|---|---|
| GET | /standards/common | Get common standards catalog |
| GET | /standards | List standards (paginated) |
| POST | /standards | Create new standard |
| GET | /standards/{id} | Get standard details |
| PATCH | /standards/{id}/attest | Attest standard ownership |
| DELETE | /standards/{id} | Delete standard |
| POST | /standards/{id}/uploads/init | Initialize file upload |
| POST | /standards/{id}/uploads/{upload_id}/complete | Complete file upload |
Work Products
| Method | Endpoint | Description |
|---|---|---|
| GET | /work-products | List work products (paginated) |
| GET | /work-products/{id} | Get work product details |
| PATCH | /work-products/{id} | Update work product |
| DELETE | /work-products/{id} | Delete work product |
| POST | /work-products/uploads/init | Initialize file upload |
| POST | /work-products/uploads/{file_id}/complete | Complete file upload |
Analysis
| Method | Endpoint | Description |
|---|---|---|
| GET | /analysis/overview | Get analysis overview |
| GET | /analysis/standards/{id}/drilldown | Get standard drill-down |
| POST | /analysis/gaps | Start gap analysis |
| GET | /analysis/evidence | Get evidence mapping |
| GET | /analysis/analyses | List persisted analyses |
| GET | /analysis/analyses/{id} | Get analysis by ID (with gaps/recommendations) |
| GET | /analysis/gaps | List persisted gaps (filters supported) |
| PATCH | /analysis/gaps/{gap_id} | Update gap status (open/in_progress/resolved/accepted) |
Reports
| Method | Endpoint | Description |
|---|---|---|
| GET | /reports | List reports (paginated) |
| POST | /reports | Create new report |
| GET | /reports/{id} | Get report details |
| DELETE | /reports/{id} | Delete report |
| GET | /reports/{id}/download | Download report |
Traceability
| Method | Endpoint | Description |
|---|---|---|
| GET | /traceability/matrix | Get traceability matrix |
| GET | /traceability/gaps | Get traceability gaps |
| GET | /traceability/completeness | Get workspace completeness metrics |
| GET | /traceability/analyze | Run comprehensive traceability analysis |
| GET | /traceability/links | List links with filters |
| POST | /traceability/links | Create traceability link |
Detailed API Reference
View complete API documentation with examples