Defines a badge that can be awarded via badge award records to users, projects, or activity claims.
Record Key
tid
Timestamp-based ID
Properties
allowedIssuers
array
of
ref
app.certified.defs#did
Optional
Optional allowlist of DIDs allowed to issue this badge. If omitted, anyone may issue it.
maxLength: 100 itemsbadgeType
string
Required
Category of the badge (e.g. endorsement, participation, affiliation).
maxLength: 100 bytescreatedAt
string
datetime
Required
Client-declared timestamp when this record was originally created
description
string
Optional
Optional short statement describing what the badge represents.
maxLength: 5000 bytesmaxGraphemes: 500 graphemesicon
blob
Required
Icon representing the badge, stored as a blob for compact visual display.
maxSize: 1.0 MBtitle
string
Required
Human-readable title of the badge.
maxLength: 256 bytesView raw schema
{
"key": "tid",
"type": "record",
"record": {
"type": "object",
"required": [
"title",
"badgeType",
"icon",
"createdAt"
],
"properties": {
"icon": {
"type": "blob",
"accept": [
"image/png",
"image/jpeg",
"image/webp",
"image/svg+xml"
],
"maxSize": 1048576,
"description": "Icon representing the badge, stored as a blob for compact visual display."
},
"title": {
"type": "string",
"maxLength": 256,
"description": "Human-readable title of the badge."
},
"badgeType": {
"type": "string",
"maxLength": 100,
"description": "Category of the badge (e.g. endorsement, participation, affiliation)."
},
"createdAt": {
"type": "string",
"format": "datetime",
"description": "Client-declared timestamp when this record was originally created"
},
"description": {
"type": "string",
"maxLength": 5000,
"description": "Optional short statement describing what the badge represents.",
"maxGraphemes": 500
},
"allowedIssuers": {
"type": "array",
"items": {
"ref": "app.certified.defs#did",
"type": "ref"
},
"maxLength": 100,
"description": "Optional allowlist of DIDs allowed to issue this badge. If omitted, anyone may issue it."
}
}
},
"description": "Defines a badge that can be awarded via badge award records to users, projects, or activity claims."
}