Set a badge on a report (Beta)
Set or replace the badge on a report.
Beta: This documentation describes a public beta feature and is subject to the Beta features disclaimer.
Usage notes
- Retrieve the reportId by calling the /v2/reports 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 reportId is the ID of a tagged version of a report (
taggedReportId), the badge is set on the original report. 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 report to
Endorsedwhen it is verified, trusted, and meets your quality standards. - Lifecycle: Set a report 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
reportId
Unique identifier of the report.
Request
The request body.
badge
Badge shown on the report.
Allowed values:
badgeNote
Note shown with the badge.
Response
The response body.
badge
Badge shown on the report.
Allowed values:
badgeNote
Note shown with the badge.

