List badge-definitions

GET

/badge-definitions

• Current canonical versioned path (F3.API.01)

Static admin-managed catalog of gamification badges (F4.GAM.01) — no PII, safe cross-tenant reference data

Authorizations

• bearerAuth
• apiTokenAuth

Parameters

Query Parameters

pagination[page]

integer

pagination[pageSize]

integer

filters

Strapi REST filter syntax

object

sort

string

populate

string

Responses

200

OK

object

data

Array

object

code

required

Stable machine-readable identifier referenced by user-rank.badges[].badge_code and gamification-consumer trigger evaluation

string

title

required

string

description

string

icon

Icon name or emoji — no file upload, rendered client-side

string

xp_reward

required

integer

trigger_type

required

string

Allowed values: provisioning_count runbook_success incident_resolved streak_days automation_score_threshold manual_admin_grant

trigger_threshold

integer

active

required

boolean

documentId

string

id

integer

createdAt

string format: date-time

updatedAt

string format: date-time

publishedAt

string format: date-time

nullable

meta

object

pagination

object

page

integer

pageSize

integer

pageCount

integer

total

integer

401

Missing or invalid authentication

403

Not authorized (tenant scope or capability)