The top-3 podium — positions 1 to 3, one member each, assigned by hand. Members read; awards:manage writes.
3 endpoints.
| Method | Path | Summary |
|---|---|---|
GET | /api/communities/{communityId}/awards/leaderboard | The top-3 podium (members) |
DELETE | /api/communities/{communityId}/awards/leaderboard/{position} | Clear a podium position (awards:manage) |
PUT | /api/communities/{communityId}/awards/leaderboard/{position} | Put a member on a podium position (awards:manage) |
GET /api/communities/{communityId}/awards/leaderboardAuth: Bearer JWT required.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
communityId | path | yes | string (uuid) | — |
Responses
| Status | Description | Body |
|---|---|---|
200 | data lists positions 1-3 | — |
DELETE /api/communities/{communityId}/awards/leaderboard/{position}Auth: Bearer JWT required.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
communityId | path | yes | string (uuid) | — |
position | path | yes | integer | — |
Responses
| Status | Description | Body |
|---|---|---|
200 | Cleared | — |
PUT /api/communities/{communityId}/awards/leaderboard/{position}Auth: Bearer JWT required.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
communityId | path | yes | string (uuid) | — |
position | path | yes | integer | — |
Request body (required) — application/json
| Field | Type | Required | Description |
|---|---|---|---|
userId | string | yes | The member's User.id |
title | string | no | — |
Responses
| Status | Description | Body |
|---|---|---|
200 | data is the position | — |
400 | Position outside 1-3, or the user is not a member | — |