---
title: "Changes to Push External Badge Assertion"
method: POST
path: "/v1/badge_assertion/push"
---

# Changes to Push External Badge Assertion

`POST /v1/badge_assertion/push`

> 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`: 14 info
- **2026-10-06** `d2127ead6e50`: 1 warning, 2 info
- **2026-09-29** `88bdee3363ad`: 1 info
- **2026-09-24** `2e7136176810`: 5 info
- **2026-09-16** `db80baab3a0d`: 5 info
- **2026-09-11** `01172499a398`: 3 warning, 2 info
- **2026-08-06** `4039d06e340b`: 6 warning, 16 info
- **2025-11-20** `6eb631bcc695`: 40 breaking, 112 warning, 12 info

## Changes

- **2026-11-06** `04bf6727d360`: 1 info
  - added the optional property `badge/anyOf[subschema #1: Badge]/quality_assured_at` to the response with the `200` status
- **2026-10-22** `5b575d75af2b`: 14 info
  - added the optional property `badge/anyOf[subschema #1: Badge]/credits_available` to the response with the `200` status
  - added the optional property `badge/anyOf[subschema #1: Badge]/credits_unit` to the response with the `200` status
  - added the optional property `badge/anyOf[subschema #1: Badge]/field_of_study` to the response with the `200` status
  - added the optional property `badge/anyOf[subschema #1: Badge]/field_of_study_id` to the response with the `200` status
  - added the optional property `badge/anyOf[subschema #1: Badge]/grade` to the response with the `200` status
  - added the optional property `badge/anyOf[subschema #1: Badge]/qualification_code` to the response with the `200` status
  - added the optional property `badge/anyOf[subschema #1: Badge]/qualification_framework` to the response with the `200` status
  - added the optional property `badge/anyOf[subschema #1: Badge]/qualification_level` to the response with the `200` status
  - added the optional property `badge/anyOf[subschema #1: Badge]/qualification_type` to the response with the `200` status
  - added the optional property `credits_earned` to the response with the `200` status
  - added the optional property `grade` to the response with the `200` status
  - added the optional property `provider/anyOf[subschema #1: Provider_Public]/email` to the response with the `200` status
  - added the optional property `provider/anyOf[subschema #1: Provider_Public]/enable_analytics` to the response with the `200` status
  - added the required property `badge/anyOf[subschema #1: Badge]/display_level` to the response with the `200` status
- **2026-10-06** `d2127ead6e50`: 1 warning, 2 info
  - removed the optional property `badge/anyOf[subschema #1: Badge]/qa_required` from the response with the `200` status
  - added the optional property `badge/anyOf[subschema #1: Badge]/qa_locked` to the response with the `200` status
  - added the optional property `restorable_until` to the response with the `200` status
- **2026-09-29** `88bdee3363ad`: 1 info
  - added the optional property `badge/anyOf[subschema #1: Badge]/certificates_enabled` to the response with the `200` status
- **2026-09-24** `2e7136176810`: 5 info
  - added the optional property `badge/anyOf[subschema #1: Badge]/created_by/anyOf[subschema #1: User_Detail_Public]/visibility` to the response with the `200` status
  - added the optional property `badge/anyOf[subschema #1: Badge]/published_by/anyOf[subschema #1: User_Detail_Public]/visibility` to the response with the `200` status
  - added the optional property `badge/anyOf[subschema #1: Badge]/submitted_by/anyOf[subschema #1: User_Detail_Public]/visibility` to the response with the `200` status
  - added the optional property `badge/anyOf[subschema #1: Badge]/updated_by/anyOf[subschema #1: User_Detail_Public]/visibility` to the response with the `200` status
  - added the optional property `recipient/anyOf[subschema #1: User_Detail_Public]/visibility` to the response with the `200` status
- **2026-09-16** `db80baab3a0d`: 5 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`
  - the `noindex_enabled` response's property default value changed from `false` to `true` for the status `200`
- **2026-09-11** `01172499a398`: 3 warning, 2 info
  - removed the optional property `badge/anyOf[subschema #1: Badge]/job_feed_companies` from the response with the `200` status
  - removed the optional property `badge/anyOf[subschema #1: Badge]/job_feed_enabled` from the response with the `200` status
  - removed the optional property `badge/anyOf[subschema #1: Badge]/job_feed_levels` from the response with the `200` status
  - added the optional property `badge/anyOf[subschema #1: Badge]/specialized_occupations` to the response with the `200` status
  - added the optional property `badge/anyOf[subschema #1: Badge]/title_names` to the response with the `200` status
- **2026-08-06** `4039d06e340b`: 6 warning, 16 info
  - removed the optional property `recipient/anyOf[subschema #1: User_Detail_Public]/role` from the response with the `200` status
  - added the new `Imported` enum value to the `issuer/anyOf[subschema #1: Badge_Issuer]/source/anyOf[subschema #1: Source_Type]/` response property for the response status `200`
  - added the new `Imported` enum value to the `issuing_method` response property for the response status `200`
  - 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 `issuing_method` response property for the response status `200`
  - added the new `Tally` enum value to the `issuing_method` response property for the response status `200`
  - api operation id `push_external_badge_assertion_v1_badge_assertion_push_post` removed and replaced with `badge_assertion_push_external_badge_assertion`
  - added the new optional `header` request parameter `X-Access-Token`
  - added the new `Imported` enum value to the request property `source`
  - added the optional property `change_request` to the response with the `200` status
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
  - added the optional property `recipient/anyOf[subschema #1: User_Detail_Public]/social_handle_facebook` to the response with the `200` status
  - added the optional property `recipient/anyOf[subschema #1: User_Detail_Public]/social_handle_instagram` to the response with the `200` status
  - added the optional property `recipient/anyOf[subschema #1: User_Detail_Public]/social_handle_linkedin` to the response with the `200` status
  - added the optional property `recipient/anyOf[subschema #1: User_Detail_Public]/social_handle_twitter` to the response with the `200` status
  - added the optional property `time_claimed` to the response with the `200` status
  - added the optional property `time_verified` to the response with the `200` status
  - added `#/components/schemas/Badge` to the `badge` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/Provider_Public` to the `provider` response property `anyOf` list for the response status `200`
  - removed `#/components/schemas/Badge-Output` from the `badge` response property `anyOf` list for the response status `200`
  - removed `#/components/schemas/Provider_Public-Output` from the `provider` response property `anyOf` list for the response status `200`
- **2025-11-20** `6eb631bcc695`: 40 breaking, 112 warning, 12 info
  - request property `source` was restricted to a list of enum values
  - the `source` request property type changed from no type to `string`
  - response property `badge_id` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `badge_issuer_id` 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 `end_date` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `evidence` 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 `issue_date` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `narrative` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `provider_id` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `recipient_email` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `recipient_firstname` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `recipient_id` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `recipient_lastname` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `recipient_organisation` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `reject_code` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `reminder_emails_sent` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `revocation_reason` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `seo_description` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `seo_keywords` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `seo_title` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `time_updated` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `updated_by_id` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `url` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - the `external_url` response property's maxLength was unset from `65536` for the response status `200`
  - the `image_url` response property's maxLength was unset from `65536` for the response status `200`
  - the `image_url_2x` response property's maxLength was unset from `65536` for the response status `200`
  - the `image_url_original` response property's maxLength was unset from `65536` for the response status `200`
  - the `external_url` response property's minLength was decreased from `1` to `0` for the response status `200`
  - the `image_url` response property's minLength was decreased from `1` to `0` for the response status `200`
  - the `image_url_2x` response property's minLength was decreased from `1` to `0` for the response status `200`
  - the `image_url_original` response property's minLength was decreased from `1` to `0` for the response status `200`
  - the `badge` response's property type changed from `object` to no type for status `200`
  - the `provider` response's property type changed from `object` to no type for status `200`
  - the `recipient` response's property type changed from `object` to no type for status `200`
  - …124 more

---

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