Add calendar event
/api/calendar/eventsPlan an event. A refusal (400) lists everything wrong at once, in problems, and joins it in error. When the event goes to VRChat's calendar and the group as Modbot last read it says Modbot's VRChat account lacks Manage Group Calendar, that comes first; on its own it does not refuse the save.
Needs the ManageCalendar permission.
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/calendar/events" \ -H "Content-Type: application/json" \ -d '{ "title": "string", "description": null, "startsAt": "string", "endsAt": "string", "timeZone": "string", "repeat": null, "repeatDays": null, "repeatUntil": null, "worldId": null, "accessType": null, "region": null, "imageUrl": null, "vrChatImageId": null, "category": null, "languages": null, "platforms": null, "tags": null, "visibility": null, "notifyMembers": true, "publishToVRChat": true, "publishToDiscord": true, "postToChannel": true, "channelId": null, "autoOpen": true, "openMinutesBefore": null, "draft": true }'{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "title": "string", "description": "string", "startsAt": "2019-08-24T14:15:22Z", "endsAt": "2019-08-24T14:15:22Z", "startsAtLocal": "string", "endsAtLocal": "string", "timeZone": "string", "repeat": "string", "repeatDays": [ "string" ], "repeatUntil": null, "worldId": null, "worldName": null, "worldThumbnailUrl": null, "worldImageUrl": null, "worldPlatforms": null, "accessType": "string", "region": "string", "imageUrl": null, "vrChatImageId": null, "category": "string", "languages": [ "string" ], "platforms": [ "string" ], "tags": [ "string" ], "visibility": "string", "notifyMembers": true, "publishToVRChat": true, "publishToDiscord": true, "postToChannel": true, "channelId": null, "autoOpen": true, "openMinutesBefore": 0, "state": "string", "occurrenceStartsAt": null, "occurrenceEndsAt": null, "version": 0, "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z", "madeOnVRChat": true, "places": [ { "place": "string", "state": "string", "error": null, "errorAt": null, "updatedAt": "2019-08-24T14:15:22Z", "missingGroupPermission": null, "canTryAgain": false, "problems": null, "link": null } ], "opening": null, "occurrences": [ { "startsAt": "2019-08-24T14:15:22Z", "endsAt": "2019-08-24T14:15:22Z", "plannedStartsAt": "2019-08-24T14:15:22Z", "title": null, "description": null, "vrChatError": null, "googleError": null } ], "cancelledAt": null, "worldListId": null, "worldListName": null, "worldListEmpty": false, "cancelledDates": null, "inviteHostUserId": null, "inviteStaffUserIds": null, "inviteListId": null, "inviteListName": null, "announceFirstJoinInDiscord": false, "invites": null, "announceFirstJoinInVRChat": false, "mentionRoleId": null, "repeatEvery": 1, "repeatTimes": null, "featured": false, "coverPictureId": null, "publishToGoogle": false, "vrChatRoleIds": null, "twitchStreams": null, "vrChatTitle": null, "vrChatDescription": null, "discordTitle": null, "discordDescription": null, "googleTitle": null, "googleDescription": null, "categories": null, "publishToBluesky": false, "blueskyPostBeforeMinutes": 1440, "blueskyTitle": null, "blueskyDescription": null, "announceFirstJoinOnBluesky": false, "postColour": null, "blueskyPictures": null, "blueskyWhoCanReply": null, "blueskyQuotesOff": false, "blueskyLanguages": null, "blueskyVideo": null, "blueskyGif": null, "googleColour": null, "googleShowAs": "free"}Update calendar event PUT
Publishing follows on its own. Several changes close together are sent to VRChat as one. A place that failed goes back to waiting and is sent again, even when nothing it is sent changed; a VRChat event that got no answer is the exception, and keeps its Try again. A refusal (400) lists everything wrong at once, as for a new event. Needs the `ManageCalendar` permission.
Open an event's instance now POST
Opens the group instance for the event's current or next time, from two hours before its start until its end, when none is open. Refused while an earlier attempt has no answer yet. One request to VRChat, recorded with who asked; the invites and the first-person posts follow as usual. Answers with the event. Needs the `ManageCalendar` permission.