RoleRequiredCertification
A request or response body; the type column links to the schemas it refers to.
RoleRequiredCertification
| Field | Type | Required | Description |
|---|---|---|---|
| id | string (uuid) | yes | — |
| role_id | string (uuid) | yes | — |
| department_id | string (uuid) | yes | — |
| organization_id | string (uuid) | yes | — |
| certification_type_id | string (uuid) | yes | — |
| recert_scheme | string | yes | none: certify once, never again. anniversary: due recert_interval_months after each award. fixed_calendar: due on recert_anchor_month/recert_anchor_day each year. one of "none" | "anniversary" | "fixed_calendar" |
| recert_interval_months | number | null | yes | — |
| recert_anchor_month | number | null | yes | — |
| recert_anchor_day | number | null | yes | — |
| initial_due_at | string (date-time) | null | yes | When holders' *initial* certification falls due; null when the role sets no deadline. Per-person due dates override it. |
| created_by | string (uuid) | null | yes | — |
| created_at | string (date-time) | yes | — |
| certification_type | object | yes | The linked certification type, for display. |
jsonExample
{
"id": "1b671a64-40d5-491e-99b0-da01ff1f3341",
"role_id": "1b671a64-40d5-491e-99b0-da01ff1f3341",
"department_id": "1b671a64-40d5-491e-99b0-da01ff1f3341",
"organization_id": "1b671a64-40d5-491e-99b0-da01ff1f3341",
"certification_type_id": "1b671a64-40d5-491e-99b0-da01ff1f3341",
"recert_scheme": "none",
"recert_interval_months": 0,
"recert_anchor_month": 0,
"recert_anchor_day": 0,
"initial_due_at": "2026-01-01T00:00:00.000Z",
"created_by": "1b671a64-40d5-491e-99b0-da01ff1f3341",
"created_at": "2026-01-01T00:00:00.000Z",
"certification_type": {
"id": "1b671a64-40d5-491e-99b0-da01ff1f3341",
"slug": "string",
"name": "string",
"awarding_mode": "automatic",
"archived_at": "2026-01-01T00:00:00.000Z"
}
}