team-completion
2 endpoints.
GET
/api/organizations/{organizationId}/departments/{departmentId}/roles/{roleId}/certification-completion Bearer tokenA role's trainee certification completion
Tallies every current holder of the role against its required certification types: who holds a current award and is not past due, per type and overall, with the named roster. Requires the caller to hold a role in this role's manager chain, or be a superuser.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| organizationId | path | string (uuid) | yes | e.g. 6f3b34d8-3c5e-4dd9-9f4e-2b52f0d9a1c7 |
| departmentId | path | string (uuid) | yes | e.g. 0b8f9a3e-97a4-4f2f-b3a3-51f2f8f0f7f4 |
| roleId | path | string (uuid) | yes | e.g. 9c2f1f7e-4a35-4b8f-8d21-3f5b2a7c9d10 |
Responses
| Status | Description | Body |
|---|---|---|
| 200 | The role's aggregate completion, tallies and roster alike. | RoleCertificationCompletion |
| 401 | The access token is missing or invalid. | ErrorResponse |
| 403 | The caller is neither in the role's manager chain nor a superuser. | ErrorResponse |
| 404 | The organization, department, or role does not exist there. | ErrorResponse |
| 500 | The database could not be read. | ErrorResponse |
GET
/api/team/certification-completion Bearer tokenThe caller's team certification completion
The aggregate completion of every role reachable walking the reporting lines down from the caller's unexpired roles, limited to roles that require at least one live certification type. Empty for a caller who manages nothing.
Responses
| Status | Description | Body |
|---|---|---|
| 200 | One aggregate per managed role that requires certifications. | TeamCertificationCompletionList |
| 401 | The access token is missing or invalid. | ErrorResponse |
| 500 | The database could not be read. | ErrorResponse |