Modbot Docs

Write post

POST/api/posts

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.

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 POST "https://example.com/api/posts" \  -H "Content-Type: application/json" \  -d '{    "title": null,    "text": null  }'
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "title": null,  "text": "string",  "pictureId": null,  "status": "string",  "lists": [    "string"  ],  "sendAt": null,  "sendAtLocal": null,  "timeZone": "string",  "eventId": null,  "eventTitle": null,  "kind": null,  "version": 0,  "createdBy": null,  "createdAt": "2019-08-24T14:15:22Z",  "updatedAt": "2019-08-24T14:15:22Z",  "cancelledAt": null,  "destinations": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "network": "string",      "target": "string",      "targetName": null,      "roleId": null,      "roleName": null,      "publish": true,      "state": "string",      "shown": "string",      "link": null,      "externalId": null,      "error": null,      "errorAt": null,      "notPublished": true,      "mayBeSent": true,      "titleOverride": null,      "textOverride": null,      "sentText": null,      "sentAt": null,      "postedAt": null,      "publishedAt": null,      "vrChat": null,      "missingPermission": null,      "bluesky": null    }  ],  "keepUpdated": false,  "listsUpdatedAt": 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.