|
<div class="docs-content" data-render>
|
|
# Profile awards
|
|
|
|
Members can give one award per cooldown window to another member on their profile. The giver writes a short message (up to 125 characters); the server enqueues durable image generation and returns immediately. When the job finishes, the receiver gets a notification and the award appears on their profile gallery, a prominent banner, and a small badge on their avatar for a configurable display window.
|
|
|
|
Guests can browse awards read-only on profiles. Muting a user suppresses award notifications only; it does not block giving.
|
|
|
|
## Giving an award
|
|
|
|
On another member's profile, use **Give Award** when you are not on cooldown. Submit a short message in the modal. The giver's API key pays for gateway image generation. You cannot award yourself, and block rules match direct messages.
|
|
|
|
## Viewing awards
|
|
|
|
- **Awards tab** on a profile lists published awards newest first (first tab when the user has at least one award).
|
|
- **Prominent banner** shows the latest award for a limited time after publish.
|
|
- **Avatar badge** appears bottom-left on avatars while the latest award is prominent.
|
|
- Images are served at `/awards/{slug}/{size}` with sizes `512`, `256`, or `64`.
|
|
|
|
## Admin revoke
|
|
|
|
Administrators can revoke a published award from the gallery or prominent banner. Revocation soft-deletes the award and attachments and recomputes receiver stats. Restored rows from **Admin - Trash** bring the award back.
|
|
|
|
## API
|
|
|
|
See [Profiles & Social Graph](/docs/profiles.html) for `POST /profile/{username}/award` and the awards tab on `GET /profile/{username}?tab=awards`. Image redirects are documented on the same page. Admin revoke is under [Admin API](/docs/admin.html).
|
|
</div> |