Rarity tiers (name + colour). Members read; awards:manage writes.
5 endpoints.
| Method | Path | Summary |
|---|---|---|
GET | /api/communities/{communityId}/awards/rarities | List rarity tiers (members) |
POST | /api/communities/{communityId}/awards/rarities | Create a rarity tier (awards:manage) |
DELETE | /api/communities/{communityId}/awards/rarities/{rarityId} | Delete a rarity tier (awards:manage) |
GET | /api/communities/{communityId}/awards/rarities/{rarityId} | One rarity tier (members) |
PUT | /api/communities/{communityId}/awards/rarities/{rarityId} | Edit a rarity tier (awards:manage) |
GET /api/communities/{communityId}/awards/raritiesAuth: Bearer JWT required.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
communityId | path | yes | string (uuid) | — |
Responses
| Status | Description | Body |
|---|---|---|
200 | data is the tier list | — |
POST /api/communities/{communityId}/awards/raritiesAuth: Bearer JWT required.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
communityId | path | yes | string (uuid) | — |
Request body (required) — application/json
| Field | Type | Required | Description |
|---|---|---|---|
name | string | no | — |
color | string | no | — |
sortOrder | integer | no | — |
Responses
| Status | Description | Body |
|---|---|---|
201 | data is the tier | — |
DELETE /api/communities/{communityId}/awards/rarities/{rarityId}Auth: Bearer JWT required.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
communityId | path | yes | string (uuid) | — |
rarityId | path | yes | string | — |
Responses
| Status | Description | Body |
|---|---|---|
200 | Deleted | — |
GET /api/communities/{communityId}/awards/rarities/{rarityId}Auth: Bearer JWT required.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
communityId | path | yes | string (uuid) | — |
rarityId | path | yes | string | — |
Responses
| Status | Description | Body |
|---|---|---|
200 | data is the tier | — |
404 | Not found | — |
PUT /api/communities/{communityId}/awards/rarities/{rarityId}Auth: Bearer JWT required.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
communityId | path | yes | string (uuid) | — |
rarityId | path | yes | string | — |
Request body (required) — application/json
| Field | Type | Required | Description |
|---|---|---|---|
name | string | no | — |
color | string | no | — |
sortOrder | integer | no | — |
Responses
| Status | Description | Body |
|---|---|---|
200 | data is the tier | — |