---
title: "Changes to Create Badge"
method: POST
path: "/v1/badge/"
---

# Changes to Create Badge

`POST /v1/badge/`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 9 of 12 revisions.

- **2026-11-06** `04bf6727d360`: 1 info
- **2026-10-22** `5b575d75af2b`: 18 info
- **2026-10-06** `d2127ead6e50`: 2 warning, 2 info
- **2026-09-29** `88bdee3363ad`: 2 info
- **2026-09-24** `2e7136176810`: 6 info
- **2026-09-16** `db80baab3a0d`: 4 info
- **2026-09-11** `01172499a398`: 6 warning, 4 info
- **2026-08-06** `4039d06e340b`: 6 warning, 33 info
- **2025-11-20** `6eb631bcc695`: 69 breaking, 59 warning, 113 info

## Changes

- **2026-11-06** `04bf6727d360`: 1 info
  - added the optional property `quality_assured_at` to the response with the `200` status
- **2026-10-22** `5b575d75af2b`: 18 info
  - added the new optional request property `credits_available`
  - added the new optional request property `credits_unit`
  - added the new optional request property `field_of_study_id`
  - added the new optional request property `grade`
  - added the new optional request property `qualification_code`
  - added the new optional request property `qualification_framework`
  - added the new optional request property `qualification_level`
  - added the new optional request property `qualification_type`
  - added the optional property `credits_available` to the response with the `200` status
  - added the optional property `credits_unit` to the response with the `200` status
  - added the optional property `field_of_study` to the response with the `200` status
  - added the optional property `field_of_study_id` to the response with the `200` status
  - added the optional property `grade` to the response with the `200` status
  - added the optional property `qualification_code` to the response with the `200` status
  - added the optional property `qualification_framework` to the response with the `200` status
  - added the optional property `qualification_level` to the response with the `200` status
  - added the optional property `qualification_type` to the response with the `200` status
  - added the required property `display_level` to the response with the `200` status
- **2026-10-06** `d2127ead6e50`: 2 warning, 2 info
  - removed the request property `qa_required`
  - removed the optional property `qa_required` from the response with the `200` status
  - added the new optional request property `qa_locked`
  - added the optional property `qa_locked` to the response with the `200` status
- **2026-09-29** `88bdee3363ad`: 2 info
  - added the new optional request property `certificates_enabled`
  - added the optional property `certificates_enabled` to the response with the `200` status
- **2026-09-24** `2e7136176810`: 6 info
  - added the new optional `query` request parameter `subtitle`
  - added the new optional `query` request parameter `title`
  - added the optional property `created_by/anyOf[subschema #1: User_Detail_Public]/visibility` to the response with the `200` status
  - added the optional property `published_by/anyOf[subschema #1: User_Detail_Public]/visibility` to the response with the `200` status
  - added the optional property `submitted_by/anyOf[subschema #1: User_Detail_Public]/visibility` to the response with the `200` status
  - added the optional property `updated_by/anyOf[subschema #1: User_Detail_Public]/visibility` to the response with the `200` status
- **2026-09-16** `db80baab3a0d`: 4 info
  - the `noindex_enabled` response's property default value changed from `false` to `true` for the status `200`
  - the `noindex_enabled` response's property default value changed from `false` to `true` for the status `200`
  - the `noindex_enabled` response's property default value changed from `false` to `true` for the status `200`
  - the `noindex_enabled` response's property default value changed from `false` to `true` for the status `200`
- **2026-09-11** `01172499a398`: 6 warning, 4 info
  - removed the request property `job_feed_companies`
  - removed the request property `job_feed_enabled`
  - removed the request property `job_feed_levels`
  - removed the optional property `job_feed_companies` from the response with the `200` status
  - removed the optional property `job_feed_enabled` from the response with the `200` status
  - removed the optional property `job_feed_levels` from the response with the `200` status
  - added the new optional request property `specialized_occupations`
  - added the new optional request property `title_names`
  - added the optional property `specialized_occupations` to the response with the `200` status
  - added the optional property `title_names` to the response with the `200` status
- **2026-08-06** `4039d06e340b`: 6 warning, 33 info
  - removed the optional property `created_by/anyOf[subschema #1: User_Detail_Public]/role` from the response with the `200` status
  - removed the optional property `published_by/anyOf[subschema #1: User_Detail_Public]/role` from the response with the `200` status
  - removed the optional property `submitted_by/anyOf[subschema #1: User_Detail_Public]/role` from the response with the `200` status
  - removed the optional property `updated_by/anyOf[subschema #1: User_Detail_Public]/role` from the response with the `200` status
  - added the new `Imported` enum value to the `source/anyOf[subschema #1: Source_Type]/` response property for the response status `200`
  - added the new `Pathway` enum value to the `criteria/anyOf[subschema #1]/items/type/anyOf[subschema #1: Badge_Criteria_Type]/` response property for the response status `200`
  - api operation id `create_badge_v1_badge__post` removed and replaced with `badge_create_badge`
  - added the new optional `header` request parameter `X-Access-Token`
  - added the new optional `query` request parameter `generate_image`
  - added the new optional request property `config`
  - added the new `Imported` enum value to the request property `source/anyOf[subschema #1: Source_Type]/`
  - added the new `Pathway` enum value to the request property `criteria/anyOf[subschema #1]/items/type`
  - added the optional property `config` to the response with the `200` status
  - added the optional property `created_by/anyOf[subschema #1: User_Detail_Public]/social_handle_facebook` to the response with the `200` status
  - added the optional property `created_by/anyOf[subschema #1: User_Detail_Public]/social_handle_instagram` to the response with the `200` status
  - added the optional property `created_by/anyOf[subschema #1: User_Detail_Public]/social_handle_linkedin` to the response with the `200` status
  - added the optional property `created_by/anyOf[subschema #1: User_Detail_Public]/social_handle_twitter` to the response with the `200` status
  - added the optional property `providers/anyOf[subschema #1]/items/community/anyOf[subschema #1: Community_Light]/image_url_2x` to the response with the `200` status
  - added the optional property `providers/anyOf[subschema #1]/items/community/anyOf[subschema #1: Community_Light]/image_url_original` to the response with the `200` status
  - added the optional property `providers/anyOf[subschema #1]/items/community/anyOf[subschema #1: Community_Light]/linkedin_organisation_id` to the response with the `200` status
  - added the optional property `providers/anyOf[subschema #1]/items/community/anyOf[subschema #1: Community_Light]/social_handle_facebook` to the response with the `200` status
  - added the optional property `providers/anyOf[subschema #1]/items/community/anyOf[subschema #1: Community_Light]/social_handle_instagram` to the response with the `200` status
  - added the optional property `providers/anyOf[subschema #1]/items/community/anyOf[subschema #1: Community_Light]/social_handle_linkedin` to the response with the `200` status
  - added the optional property `providers/anyOf[subschema #1]/items/community/anyOf[subschema #1: Community_Light]/social_handle_twitter` to the response with the `200` status
  - added the optional property `providers/anyOf[subschema #1]/items/community/anyOf[subschema #1: Community_Light]/url` to the response with the `200` status
  - added the optional property `providers/anyOf[subschema #1]/items/url` to the response with the `200` status
  - added the optional property `published_by/anyOf[subschema #1: User_Detail_Public]/social_handle_facebook` to the response with the `200` status
  - added the optional property `published_by/anyOf[subschema #1: User_Detail_Public]/social_handle_instagram` to the response with the `200` status
  - added the optional property `published_by/anyOf[subschema #1: User_Detail_Public]/social_handle_linkedin` to the response with the `200` status
  - added the optional property `published_by/anyOf[subschema #1: User_Detail_Public]/social_handle_twitter` to the response with the `200` status
  - added the optional property `submitted_by/anyOf[subschema #1: User_Detail_Public]/social_handle_facebook` to the response with the `200` status
  - added the optional property `submitted_by/anyOf[subschema #1: User_Detail_Public]/social_handle_instagram` to the response with the `200` status
  - added the optional property `submitted_by/anyOf[subschema #1: User_Detail_Public]/social_handle_linkedin` to the response with the `200` status
  - added the optional property `submitted_by/anyOf[subschema #1: User_Detail_Public]/social_handle_twitter` to the response with the `200` status
  - added the optional property `updated_by/anyOf[subschema #1: User_Detail_Public]/social_handle_facebook` to the response with the `200` status
  - added the optional property `updated_by/anyOf[subschema #1: User_Detail_Public]/social_handle_instagram` to the response with the `200` status
  - added the optional property `updated_by/anyOf[subschema #1: User_Detail_Public]/social_handle_linkedin` to the response with the `200` status
  - added the optional property `updated_by/anyOf[subschema #1: User_Detail_Public]/social_handle_twitter` to the response with the `200` status
  - the `detail` response's property default value changed from `Unauthorized access` to `Insufficient permissions` for the status `403`
- **2025-11-20** `6eb631bcc695`: 69 breaking, 59 warning, 113 info
  - added the new required request property `description`
  - added the new required request property `name`
  - added the new required request property `type`
  - the request's body type changed from no type to `object`
  - response property `address` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `alignments` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `availability` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `available_to_all` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `city` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `collections` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `community_ids` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `country` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `created_by_id` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `criteria` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `description` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `earn_url` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `edu_levels` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `embed` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `end_date` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `endorsements` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `external_id` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `external_url` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `image_url` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `image_url_2x` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `image_url_original` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `industries` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `information_url` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `interacted_with` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `is_demo` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `issuer_id` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `job_feed_companies` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `job_feed_enabled` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `job_titles` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `latitude` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `longitude` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `name` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `occupation_groups` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `provider_ids` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `providers` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `published_by_id` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - …201 more

---

[Operation](https://skmtc.dev/navigatr/apis/navigatr-api/docs/v1/badge/post.md) - [API](https://skmtc.dev/navigatr/apis/navigatr-api.md) - [Page](https://skmtc.dev/navigatr/apis/navigatr-api/changes/v1/badge/post)
