CreateCertificationTypeRequest
A request or response body; the type column links to the schemas it refers to.
CreateCertificationTypeRequest
| Field | Type | Required | Description |
|---|---|---|---|
| owner_organization_id | string (uuid) | yes | Organization the certification type belongs to. Always required. |
| owner_department_id | string (uuid) | no | Omit for a type owned by the organization directly. |
| subject_matter_ids | array of string (uuid) | no | Subject matters of the same organization to tag the type with; records filed under any of them satisfy its record-based rules. Omit for an untagged type; the set can be replaced later through PUT /certifications/{cert_id}/subjects. at most 50 items |
| slug | string | yes | Unique within the organization. Slugs are lowercase letters and digits in words separated by single hyphens, like forklift-operator. 1–100 characters · matches ^[a-z0-9]+(-[a-z0-9]+)*$ |
| name | string | yes | 1–200 characters |
| description | string | no | Omit or send empty for no description. at most 2000 characters |
| description_markdown | string | no | Omit or send empty for no long-form markdown description. at most 50000 characters |
| 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" |
{
"owner_organization_id": "1b671a64-40d5-491e-99b0-da01ff1f3341",
"owner_department_id": "1b671a64-40d5-491e-99b0-da01ff1f3341",
"subject_matter_ids": [
"1b671a64-40d5-491e-99b0-da01ff1f3341"
],
"slug": "forklift-operator",
"name": "Certified forklift operator",
"description": "string",
"description_markdown": "string",
"awarding_mode": "automatic"
}