Switches counting on or off, says who sees your badges, pins up to three and keeps any back
PUT
/api/v1/badges/settings - Sign-in
- No scope
- Scope
- None
- MCP tool
badges.setSettings
Parameters
None.
Request body
| Field | Type and meaning |
|---|---|
enabled | boolean Count badges at all. Off keeps what was earned and shows it to nobody. |
hidden | array of string Badge ids nobody else ever sees (every season of them) |
onBoard | boolean Be on the public board. Off takes you off it; your collection stays as visible as visibility says. |
showcase | array of string Up to three earned badges shown first on your profile: an id |
visibility | "public" | "friends" | "nobody" Who besides you sees your badges. Only public ones are on the board. |
Response 200
| Field | Type and meaning |
|---|---|
categories always | array of object |
categories[].id always | string |
categories[].name always | string |
counts always | object |
counts.brass always | integer |
counts.copper always | integer |
counts.gold always | integer |
counts.total always | integer |
counts.unlocked always | integer |
enabled always | boolean |
hidden always | array of string |
items always | array of object |
items[].animation | string |
items[].art | string |
items[].category always | string |
items[].current | boolean |
items[].how always | string |
items[].icon always | string |
items[].id always | string |
items[].manual | boolean |
items[].name always | string |
items[].of | integer |
items[].progress | integer |
items[].quiet | boolean |
items[].reason | string |
items[].ref always | string |
items[].retired | boolean |
items[].season | string |
items[].seasonName | string |
items[].secret | boolean |
items[].serial | integer |
items[].tiers always | array of object |
items[].tiers[].backfill | boolean |
items[].tiers[].metal always | string |
items[].tiers[].new | boolean |
items[].tiers[].rarity | number |
items[].tiers[].threshold | integer |
items[].tiers[].unlockedAt | string |
onBoard always | boolean |
season | object |
season.id always | string |
season.name always | string |
showcase always | array of string |
visibility always | string |
Errors
| Status | Type and meaning |
|---|---|
400 | The request was not understood. |
401 | Sign in and try again. |
404 | There is nothing here, or nothing you may see. |
429 | Too many requests. |
500 | Something on our side went wrong. |
Every error comes back as { code, message, requestId }. Errors