Get spotlight settings
/api/settings/spotlightWhether the weekly member spotlight is on, the day and hour its draft is made and the time zone they are in, how the member is picked, and the sites the post goes to.
Needs the ManageSettings permission.
An API key, made on Settings, API keys. Every key starts with mbk_.
In: header
Response Body
application/json
application/problem+json
application/problem+json
curl -X GET "https://example.com/api/settings/spotlight"{ "on": true, "day": 0, "hour": 0, "timeZone": null, "mode": "string", "places": { "discord": null, "vrChat": null, "bluesky": false }, "vrChatRoles": [ { "id": "string", "name": "string" } ]}Check the Twitch connection POST
Ask Twitch for an app token with the stored client id and secret, find the channel by its login, and ask whether the token may read its stream. Writes nothing to Twitch. Answers 200 with what it found, a refusal included. While Twitch is limiting Modbot nothing is sent and the stored result is returned. Needs the `ManageSettings` permission.
Update spotlight settings PUT
Turn the weekly member spotlight on or off, or change the day and hour of its draft (`day` 0 is Sunday; `hour` 0 to 23 in `timeZone`, an IANA name, empty for UTC), who picks the member (`mode`: `random` or `staff`) or the sites it goes to. Each site ticked is checked as the Marketing tab checks a post. Turning it on, or moving the time, never makes a draft for a time already past. A refusal (400) lists everything wrong at once, in `problems`. Needs the `ManageSettings` permission.