Skip to content
Developers
Menu

API reference

Instance

Public information about this instance.

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

Get instance info

GET /instance No token: Needs no token.

What the signup, login and account screens need to know about this instance: the registration mode, whether an email address is required and whether email is delivered, and the captcha provider with its site key. No authentication; limited per client address.

Responses

200

Instance information.

Body: InstanceInfo

Example response (200)
{
  "features": [
    {
      "key": "threads",
      "scope": "community",
      "available": false,
      "everyone": false,
      "min_tier": "standard"
    }
  ],
  "gif_provider": "giphy",
  "gif_mode": "proxy",
  "registration": "open",
  "require_email": false,
  "email_delivery": false,
  "captcha": {
    "provider": "none",
    "site_key": "string"
  },
  "account_deletion_grace_seconds": 0,
  "export_cooldown_seconds": 0,
  "export_available_for_seconds": 0,
  "identity_domain": "string",
  "account_moves_enabled": false,
  "directory_enabled": false,
  "automod_enabled": false,
  "search_enabled": false,
  "emoji_names_enabled": false,
  "oidc_enabled": false,
  "markdown_enabled": false,
  "voice_enabled": false,
  "threads_enabled": false,
  "dark_images_enabled": false,
  "animated_banners_enabled": false,
  "terms_url": "https://app.palloo.app/",
  "privacy_url": "https://app.palloo.app/",
  "terms_version": "string",
  "media": {
    "base_url": "https://app.palloo.app/",
    "max_upload_bytes": 0,
    "daily_upload_bytes": 0,
    "max_attachments": 0,
    "attachment_url_ttl_seconds": 0
  },
  "tiers": [
    {
      "tier": "standard",
      "limits": {
        "members": 0,
        "channels": 0,
        "roles": 0,
        "upload_bytes": 0,
        "emoji_slots": 0,
        "sticker_slots": 0
      },
      "perks": [
        "vanity_invite"
      ],
      "features": [
        "threads"
      ]
    }
  ],
  "discord_templates_enabled": false,
  "account_content_deletion_enabled": false
}
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.

500

internal: an unexpected server error. Details are only in server logs.

Body: Error