Skip to content

Discord

POST /v1/discord/interaction

Handles Discord interaction payloads (slash commands) for Uebliche.

Headers

  • X-Signature-Ed25519: signature for the request body.
  • X-Signature-Timestamp: timestamp used for the signature.

Env

  • DISCORD_INTERACTIONS_PUBLIC_KEY: Discord application public key used for signature verification.
  • BUILD_MOE_WEB_BASE: base URL for build.moe website links (e.g. https://build.moe).
  • BUILD_MOE_MONGO_DATABASE: optional database override for head lookups.
  • BUILD_MOE_HEADS_COLLECTION: collection name for head lookups (defaults to heads).
  • DISCORD_BUILD_MOE_APP_ID: build.moe Discord application id.
  • DISCORD_BUILD_MOE_TOKEN: build.moe Discord bot token (used to register commands).

Commands

/head query:<search|id>

Searches build.moe heads.

Response includes a link to the head and metadata (category, tags, image if available).

/randomhead

Returns a random build.moe head.

/docs page:<path>

Returns a link to the docs page (defaults to https://uebliche.info/docs).

POST /v1/discord/build-moe/commands

Registers the build.moe bot slash commands globally. Requires super-admin auth.