Get posts health
/api/posts/healthWhat the Health page's Posts card shows: whether posting is paused, destinations that failed in the last 7 days, posts Modbot has been looking for on a site for more than 15 minutes, and sites scheduled posts wait on that are switched off or not set up.
Needs the ViewPosts 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/posts/health"{ "paused": true, "problems": [ { "postId": "1d33c5d7-f0cb-41cc-a647-907f16832fc3", "title": "string", "network": "string", "problem": "string", "error": null, "at": null, "missingPermission": null } ], "holds": [ { "network": "string", "hold": "string", "waiting": 0 } ], "pinError": null, "pinErrorAt": null, "countsError": null, "countsErrorAt": null, "repliesError": null, "repliesErrorAt": null, "profileError": null, "profileErrorAt": null}Write post POST
Saves a draft, or schedules a post: `when` is `now` or `later` with `sendAt` in `timeZone`. Each site is ticked by sending its section (`discord`, `vrChat`, `bluesky`); none is ticked unless sent. VRChat needs a title, the post's or its own. Bluesky gets the title and text, or its own text, of at most 300 characters and 3000 bytes. Nothing is sent by this request: Modbot's Discord loop sends a post within about twenty seconds of its time, its VRChat loop within about fifteen and its Bluesky loop within about thirty, unless Pause all posting is on or that site's posts are off. A refusal (400) lists everything wrong at once, in `problems`. Needs the `ManagePosts` permission.
Get post GET
One post, with each site it goes to and how it went there. Needs the `ViewPosts` permission.