Set a badge on a data model (Beta)
Set or replace the badge on a data model.
Beta: This documentation describes a public beta feature and is subject to the Beta features disclaimer.
Usage notes
- Retrieve the dataModelId by calling the /v2/dataModels endpoint.
- To perform this operation, you must use API credentials owned by a user assigned to an account type with the Manage all badges permission.
- If dataModelId is the ID of a tagged version of a data model (
taggedDataModelId), the badge is set on the original data model. Tagged versions do not have their own badges. - Omit
badgeNoteto clear the current note. PassbadgeNoteto replace the current note. Returns an empty string when the badge has no note. - Pass the
badgereturned by the /v2/files endpoint. That endpoint returnsnullwhen the document has no badge.
Usage scenarios
- Certification: Set a data model to
Endorsedwhen it is verified, trusted, and meets your quality standards. - Lifecycle: Set a data model to
Warningwhen it is outdated, incomplete, or under review, and toDeprecatedwhen it is obsolete or no longer maintained.
Authentication
AuthorizationBearer
OAuth authentication of the form <token>.
Path parameters
dataModelId
Unique identifier of the data model.
Request
The request body.
badge
Badge shown on the data model.
Allowed values:
badgeNote
Note shown with the badge.
Response
The response body.
badge
Badge shown on the data model.
Allowed values:
badgeNote
Note shown with the badge.

