UpdateRoleRequiredCertificationRequest
A request or response body; the type column links to the schemas it refers to.
UpdateRoleRequiredCertificationRequest
| Field | Type | Required | Description |
|---|---|---|---|
| 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 | integer | no | Months between recertifications, for the anniversary scheme. |
| recert_anchor_month | integer | no | Calendar month (1-12) the certification falls due, for fixed_calendar. minimum 1 · maximum 12 |
| recert_anchor_day | integer | no | Day of the anchor month (1-31, clamped to the month's length), for fixed_calendar. minimum 1 · maximum 31 |
| initial_due_at | string (date-time) | no | When the *initial* certification falls due for every holder of the role. A member's per-person due date overrides it; omit to set no role-level deadline. |
jsonExample
{
"recert_scheme": "none",
"recert_interval_months": 12,
"recert_anchor_month": 3,
"recert_anchor_day": 31,
"initial_due_at": "2026-01-01T00:00:00.000Z"
}