v50

latestOpenAPI 3.1.0raw.githubusercontent.com2026-03-211931021.7 MB

Badges

Create a new Badge

OAuth Scope

This endpoint requires the following OAuth scope manage_badges.

Record UUID

UUID is optional for record creation. If no UUID is supplied, a UUID will be automatically generated for the new record and returned in the x-record-uuid response header.

post/badge.json

Request body

uuidstring uuid

Unique identifier for this record

namestring required

The display name of the badge. Used to identify the badge in the system. Examples include 'Warranty', 'VIP', 'Take Payment Facilities', etc.

automatically_allocatedstring

file_namestring

regarding_form_uuidstring uuid

regarding_asset_type_uuidstring uuid

UUID of the asset type that this badge is associated with. Only applicable for asset-based badges. When set, the badge represents a specific asset type in the system and will appear on assets of this type.

Example request

{
  "uuid": "123e4567-fe09-41de-b7d5-23f946b700cb",
  "regarding_form_uuid": "123e4567-4b68-437d-98c2-23f94cecbf3b",
  "regarding_asset_type_uuid": "123e4567-6dcd-492c-8c70-23f9414984cb"
}

Response

Success

errorCodenumber

messagestring

Example response

{
  "message": "OK"
}