Modbot Docs
APIAPI referenceSettings

Update birthday settings

PUT/api/settings/discord-birthdays

Turn the daily birthday post on or off, or change its channel, its hour (hour 0 to 23 in timeZone, an IANA name, empty for UTC), its text ({members} stands for the members; empty for the built-in text) or the birthday role (empty for none). A role that holds a dangerous permission is refused. Turning it on, or moving the hour, never posts for a time already past. A refusal (400) lists everything wrong at once, in problems.

Needs the ManageSettings permission.

AuthorizationBearer <token>

An API key, made on Settings, API keys. Every key starts with mbk_.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

curl -X PUT "https://example.com/api/settings/discord-birthdays" \  -H "Content-Type: application/json" \  -d '{}'
{  "on": true,  "channelId": null,  "hour": 0,  "timeZone": null,  "message": "string",  "roleId": null,  "problem": null}

Modbot is not endorsed by or affiliated with VRChat Inc. or Discord Inc. VRChat is a trademark of VRChat Inc. Discord is a trademark of Discord Inc. SteamVR is a trademark of Valve Corporation. Windows is a trademark of Microsoft Corporation. Docker is a trademark of Docker, Inc. PostgreSQL is a trademark of the PostgreSQL Community Association of Canada. Railway is a trademark of Railway Corp. Other names are trademarks of their respective owners; see Legal. Modbot and its logo are trademarks of the Modbot project. Open source under AGPL-3.0.