Teams API
Manage engineers, skill profiles, and team structure programmatically. Pull real-time workload and utilisation data for custom dashboards and reporting pipelines.
Engineers
| Method | Endpoint | Description |
|---|
| GET | /engineers | List all engineers in the organisation |
| GET | /engineers/{id} | Get engineer profile and current workload |
| PATCH | /engineers/{id}/skills | Update engineer skill profile |
| PATCH | /engineers/{id}/capacity | Update weekly capacity hours |
Get engineer profile
GET /api/v1/engineers/7
# Response
{
"id": 7,
"name": "Sarah Chen",
"email": "sarah@example.com",
"seniority": "senior",
"skills": ["Python", "FastAPI", "PostgreSQL", "AWS"],
"weekly_capacity_hours": 40,
"current_utilisation_pct": 65,
"active_assignments": 3,
"overdue_tasks": 0
}Analytics
| Method | Endpoint | Description |
|---|
| GET | /analytics/team-metrics | Velocity, throughput, cycle time |
| GET | /analytics/workload | Current utilisation per engineer |
| GET | /analytics/skill-coverage | Skill heatmap and gap analysis |
Get team workload
GET /api/v1/analytics/workload
# Response
{
"team_utilisation_avg_pct": 73,
"engineers": [
{
"engineer_id": 7,
"name": "Sarah Chen",
"utilisation_pct": 65,
"status": "available"
},
{
"engineer_id": 12,
"name": "James Park",
"utilisation_pct": 108,
"status": "overloaded"
}
]
}Audit logs
| Method | Endpoint | Description |
|---|
| GET | /audit/logs | Query audit log (Admin only) |
Query parameters
| Parameter | Description |
|---|
event_type | Filter by event type (e.g. user_login, task_assigned) |
user_id | Filter by user who performed the action |
from_date | Start of date range (ISO 8601) |
to_date | End of date range (ISO 8601) |
format | json (default) or csv for export |