Skip to content
Developers
Menu

API reference

Badges

Every path is relative to https://api.palloo.app/v1. Send a bot token as Authorization: Bearer palloo_bot_... unless the operation says otherwise; see Authentication.

On this page

List badge definitions

GET /badges Bot token: Call it with a bot token (people can call it too).

The badge catalog, in display order, with each badge's tiers. Badge images are part of the client's design system, keyed by badge and tier key.

Responses

200

The catalog.

Body: BadgeCatalog

Example response (200)
{
  "badges": [
    {
      "key": "staff",
      "name": "string",
      "description": "string",
      "kind": "automatic",
      "lapse": "keep",
      "hideable": false,
      "owner_only": false,
      "order": 0,
      "tiers": [
        {
          "key": "string",
          "name": "string",
          "level": 1,
          "requirement": "string"
        }
      ]
    }
  ]
}
401

unauthenticated: the bearer token is missing, invalid or expired.

Body: Error

WWW-Authenticate header.

429

rate_limited: too many attempts. Every operation a bot calls is also limited per bot (50 at once, then 50 per second), so any authenticated operation can answer this to a bot. Changes to a community's structure (creating or changing the community, channels, roles, member roles, overwrites, invites, kicks, bans, timeouts, report updates and actions, and bots) are also limited per caller (30 at once, then 1 per second) and per community (60 at once, then 1 per second), and creating communities per caller (10 at once, then 1 every 5 minutes).

Body: Error

Retry-After header.