Update a user-rank
PUT /user-ranks/{id}
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”DocumentId
Request Body required
Section titled “Request Body required ”object
object
Array of { badge_code, awarded_at } — badge_code references badge-definition.code
Latest automation-score snapshot; historical values live in gamification-event, not here
F4.GAM.06 — per-user opt-out of org leaderboard exposure. Even when an organisation’s leaderboard_enabled is true, a member with this set is excluded from GET /api/organisations/:id/leaderboard results. Self-service, but NOT writable via the generic service-only user-rank update route — the owning user sets it via the dedicated PUT /api/user-ranks/me/leaderboard-opt-out endpoint (the one exception to user-rank’s service-write-only rule, scoped to this single boolean field).
Responses
Section titled “ Responses ”Updated
object
object
Array of { badge_code, awarded_at } — badge_code references badge-definition.code
Latest automation-score snapshot; historical values live in gamification-event, not here
F4.GAM.06 — per-user opt-out of org leaderboard exposure. Even when an organisation’s leaderboard_enabled is true, a member with this set is excluded from GET /api/organisations/:id/leaderboard results. Self-service, but NOT writable via the generic service-only user-rank update route — the owning user sets it via the dedicated PUT /api/user-ranks/me/leaderboard-opt-out endpoint (the one exception to user-rank’s service-write-only rule, scoped to this single boolean field).
Validation error
Missing or invalid authentication
Not authorized (tenant scope or capability)
Not found