List group posts
/api/group/postsThe group's posts, read from VRChat when you ask, newest first. page and pageSize page it (at most 100 a page); total is VRChat's count. One request to VRChat per call, never retried. Authors are named from the profiles Modbot already has; roles are the group's roles as the last group read found them, for choosing who a new post is for.
Needs the ViewAnalytics permission.
An API key, made on Settings, API keys. Every key starts with mbk_.
In: header
Query Parameters
int32int32Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X GET "https://example.com/api/group/posts"{ "posts": [ { "id": "string", "title": null, "text": null, "authorId": null, "authorName": null, "imageUrl": null, "imageId": null, "visibility": "string", "roleIds": [ "string" ], "createdAt": null, "updatedAt": null } ], "total": 0, "page": 0, "pageSize": 0, "roles": [ { "id": "string", "name": "string" } ], "readAt": "2019-08-24T14:15:22Z"}Update group profile PUT
Change the group's name, description, rules, languages, links or who can join, on VRChat. Leave a field out (or null) to keep it. Only the fields that differ from what Modbot stored are sent, and nothing is sent when none do. Limits are VRChat's: a name of 3 to 64 characters, a description of up to 250, at most 3 languages (VRChat's codes, such as `eng`) and at most 3 `http` or `https` links. `joinState` is `open`, `request`, `invite` or `closed`. One request to VRChat, never retried: a refusal answers with VRChat's own message, a rate limit with 429. Once VRChat accepts, the change is written to the audit log with who made it and each field's old and new value, and the answer is the group as the page now shows it. Needs the `EditGroupProfile` permission.
Create group post POST
Post in the group on VRChat. `title` and `text` are required. `visibility` is `group` (members only, the default) or `public`. `roleIds` limits it to those roles; empty means every member. `notify` has VRChat tell the members. One request, never retried; a refusal answers with VRChat's own message. Once VRChat accepts, the audit log records who posted. Needs the `ManageGroupPosts` permission.