Add case file
/api/casesNames the person and, optionally, the audit entry the ban came from; otherwise the newest recorded ban of that person is used, or the ban list's row. Takes the profile snapshot from what Modbot has stored, then asks the profile sync for a fresher copy -- never the other way round, because the write-up must not wait on VRChat. One case file per ban: a second is refused with 409 naming the first. Recorded as a fact against your account.
Needs the Ban 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
curl -X POST "https://example.com/api/cases" \ -H "Content-Type: application/json" \ -d '{ "userId": "string", "auditEntryId": null, "reasonIds": [ "e6e632b6-7f9e-4e05-a39d-4b39087bdd62" ], "writtenReason": null }'{ "case": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "userId": "string", "displayName": null, "groupId": null, "auditEntryId": null, "banFactId": null, "bannedAt": null, "bannedBy": null, "authorUserId": "ea75109d-c5c5-4407-b0ab-0da27cd41c18", "authorUsername": "string", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z", "updatedByUsername": null, "reasons": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "label": "string", "isActive": true } ], "writtenReason": "string", "withdrawn": true, "withdrawnAt": null, "withdrawnByUsername": null, "withdrawnNote": null, "snapshot": { "profile": null, "membership": null, "banListEntry": null, "takenAt": "2019-08-24T14:15:22Z", "profileRefreshedAt": null, "profileAgeSecondsAtCapture": null, "recapturedAt": null, "profileRefreshedNow": null, "canCaptureAgain": true, "explanation": "string" }, "evidence": null, "evidenceDelivery": { "configured": true, "uploadsAllowed": true, "storeExplanation": "string", "directDelivery": true, "maxFileBytes": 0, "acceptedTypes": [ "string" ] }, "canEdit": true, "canAttach": true, "canViewEvidence": true, "now": "2019-08-24T14:15:22Z", "canDestroyEvidence": false, "lifted": null, "clips": null, "clipStatus": null }, "refreshOutcome": "string"}List case files GET
Case files, newest first -- everyone's, or one person's. Withdrawn case files are left out unless includeWithdrawn is true. Nothing is ever deleted, so a withdrawn one is still there to read; it just no longer counts as the write-up of its ban. Needs the `ViewProfile` permission.
List unwritten case files GET
Bans in the last N days with no case file, newest first. Read from the recorded ban facts, so it covers the window Modbot's audit-log sync covers and nothing before it. A ban is covered when a case file that stands names its audit entry, or was written for the same person on or after it. A withdrawn case file covers nothing. This is the list the accountability "bans without a report" signal reads. Needs the `ViewProfile` permission.