CertificationType
A request or response body; the type column links to the schemas it refers to.
CertificationType
| Field | Type | Required | Description |
|---|---|---|---|
| id | string (uuid) | yes | — |
| owner_organization_id | string (uuid) | yes | — |
| owner_department_id | string (uuid) | null | yes | Null when the organization itself owns the certification type. |
| subjects | array of CertificationTypeSubject | yes | The subject matters whose records and evidence satisfy the rules, alphabetically; a record filed under any of them counts. Empty for a type proven by sign-offs, quizzes or external courses alone. |
| slug | string | yes | — |
| name | string | yes | — |
| description | string | null | yes | — |
| description_markdown | string | null | yes | Long-form narrative markdown below the summary line; never parsed. |
| awarding_mode | string | yes | automatic: the user claims the certification themselves once every rule is satisfied. approval: the user requests it and a permission holder decides. one of "automatic" | "approval" |
| archived_at | string (date-time) | null | yes | When set, the record is retired; it stays readable but should not grow. |
| created_at | string (date-time) | yes | — |
jsonExample
{
"id": "1b671a64-40d5-491e-99b0-da01ff1f3341",
"owner_organization_id": "1b671a64-40d5-491e-99b0-da01ff1f3341",
"owner_department_id": "1b671a64-40d5-491e-99b0-da01ff1f3341",
"subjects": [
{
"id": "1b671a64-40d5-491e-99b0-da01ff1f3341",
"slug": "string",
"name": "string"
}
],
"slug": "string",
"name": "string",
"description": "string",
"description_markdown": "string",
"awarding_mode": "automatic",
"archived_at": "2026-01-01T00:00:00.000Z",
"created_at": "2026-01-01T00:00:00.000Z"
}