Sign in
Badges

Update a Badge

OAuth Scope

This endpoint requires the following OAuth scope manage_badges.

post/badge/{uuid}.json

Path parameters

uuidstring uuid required

UUID of the Badge

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 - The record was updated successfully

errorCodenumber
messagestring

Example response

{
  "message": "OK"
}

Changes

Changed in 2 of the 50 revisions of this API.15

  • 638a8df09bf41See the full diff
    • ●

      removed the request property active

      request-property-removed

  • ca9b053c43735See the full diff
    • ○

      added the non-success response with the status 401

      response-non-success-status-added

    • ○

      added the non-success response with the status 403

      response-non-success-status-added

    • ○

      added the non-success response with the status 404

      response-non-success-status-added

    • ○

      added the non-success response with the status 429

      response-non-success-status-added

    • ○

      added the non-success response with the status 500

      response-non-success-status-added