Modbot Docs
APIAPI referenceCase files

Add case file

POST/api/cases

Names 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.

AuthorizationBearer <token>

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"}

Modbot is not endorsed by or affiliated with VRChat Inc. or Discord Inc. VRChat is a trademark of VRChat Inc. Discord is a trademark of Discord Inc. SteamVR is a trademark of Valve Corporation. Windows is a trademark of Microsoft Corporation. Docker is a trademark of Docker, Inc. PostgreSQL is a trademark of the PostgreSQL Community Association of Canada. Railway is a trademark of Railway Corp. Other names are trademarks of their respective owners; see Legal. Modbot and its logo are trademarks of the Modbot project. Open source under AGPL-3.0.