Badge

Create Badge Alignment Multi

Changed on

Add a list of alignments to the badge.

Refused with a 422 when the alignment is the one the badge's qualification level manages: change the qualification level instead.

post/v1/badge/{badge_id}/alignment/multi

Request

Path parameters

badge_idinteger required

Headers

X-Access-Tokenstring nullable

Request body

external_idstring nullable
namestring required
descriptionstring required
urlstring required
frameworkstring nullable
codestring nullable

Example request

[
  {
    "external_id": "123-45678-90"
  }
]

Response

Successful Response

external_idstring nullable
namestring nullable
descriptionstring nullable
urlstring nullable
frameworkstring nullable
codestring nullable
idinteger nullable
badge_idinteger nullable

Example response

[
  {
    "external_id": "123-45678-90",
    "name": "Null Badging Standard - Example Layer",
    "description": "This badge has been mapped to the Example Layer of the Null Badging Standard",
    "url": "https://Null_Badging/Example.org"
  }
]

Changes

    • breaking

      the response's property type changed from array to string for status

    • info

      the response's property default value Unprocessable data was added for the status

    • info

      api operation id create_badge_alignment_multi_v1_badge__badge_id__alignment_multi_post removed and replaced with badge_create_badge_alignment_multi

    • info

      added the new optional header request parameter X-Access-Token

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      the response's property default value changed from Unauthorized access to Insufficient permissions for the status