Live updates polling
/api/live/pollReturns events after after at once when there are any, up to limit (default 100, at most 500); otherwise waits up to wait seconds (default 30, at most 60) for one and returns an empty list. No after means from now. Send the returned cursor back as after; more means poll again straight away. See https://docs.modbot.co/api/live-updates/.
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
curl -X GET "https://example.com/api/live/poll"{ "events": [ { "id": "string", "cursor": "string", "kind": "string", "type": "string", "typeRaw": null, "category": "string", "label": "string", "source": "string", "at": "2019-08-24T14:15:22Z", "occurredBefore": null, "observedAt": "2019-08-24T14:15:22Z", "subject": { "platform": "string", "id": "string", "kind": "string" }, "actor": null, "instanceId": null, "worldId": null, "worldName": null, "person": null, "flagged": true, "reason": null, "byThisDevice": true, "data": null, "sentence": null, "origin": null, "factId": 0 } ], "cursor": "string", "more": true, "notice": null, "clipRequests": null}Live updates socket GET
Authenticate with `?ticket=` from POST /api/live/tickets, or `Authorization: Bearer mbk_...`. `?after=` is the cursor to carry on from; without it the stream starts from now. Events arrive as `{"kind":"event","event":{...}}`. See https://docs.modbot.co/api/live-updates/.
List live instances GET
Read from Modbot's own tables; nothing here calls VRChat. Every open group instance is listed with its head count whether or not a moderator is in it. `people` is filled only while a moderator's client is watching; otherwise `lastSeen` holds who was there when watching last stopped, at `lastWatchedAt`. `voice` lists the Discord server's voice channels with somebody in them. Needs the `ViewLiveInstances` permission.