Create group post
/api/group/postsPost 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.
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
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X POST "https://example.com/api/group/posts" \ -H "Content-Type: application/json" \ -d '{ "id": null, "title": null, "text": null, "visibility": null, "roleIds": null }'{ "post": { "id": "string", "title": null, "text": null, "authorId": null, "authorName": null, "imageUrl": null, "imageId": null, "visibility": "string", "roleIds": [ "string" ], "createdAt": null, "updatedAt": null }}List group posts GET
The 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.
Update group post PUT
Change a post: `id` names it, and the title, text, `visibility` and `roleIds` replace what it had. VRChat replaces the whole post, so send `imageId` back to keep its picture. Members are not notified again. One request, never retried. Once VRChat accepts, the audit log records who changed it. Needs the `ManageGroupPosts` permission. Kept for older clients: use `PUT /api/group/posts/{id}`.