Cinder API

Authentication

Create a key in Cinder under API keys.

Send it as a bearer token in the Authorization header.

Authorization: Bearer wg_cinder_…

• Keys reach only your own Cinder account.
• Read views need the bans.read scope.
• Import, publish, save and withdraw need the bans.write scope.
• Keys can be revoked at any time in the dashboard.

Export

GET /api/cinder?view=export&page=0

Returns accepted cases from followed public and private lists with evidence and your saved decisions.

• Use source=own to export your own cases.
• Pages hold up to 25 cases, continue until page + 1 === pages.
• Withdrawn and expired public cases are excluded.

Public queue

GET /api/cinder?view=queue&status=pending&page=0

Read unreviewed public cases without subscribing or changing a game-server ban list.

Import

Import original staff cases as drafts, then publish them from the API or the dashboard.

POST /api/cinder
Content-Type: application/json

{
  "action": "import",
  "cases": [{
    "externalId": "my-system-ban-123",
    "steamId": "76561198000000001",
    "origin": "staff",
    "reason": "Cheating",
    "issuedAt": 1792530000000,
    "expiresAt": null,
    "context": {
      "notes": "Staff reviewed the recording and documented the incident.",
      "tags": ["Cheating"],
      "links": [{"kind": "video", "url": "https://example.com/clip"}]
    }
  }]
}

• Requires the bans.write scope.
• Import up to 100 cases per request and send another request for more.
• Unknown fields are rejected with 400, so send only the fields in the table.
• Imports stay private drafts under your account until you publish them.
• Imports return their ids in request order.
• Retrying an identical external ID returns its existing case, and different content returns 409.
• Automatic and received bans cannot be imported as original staff cases.

Publish

POST /api/cinder
{"action":"publish","id":"CASE_UUID","version":1}

• Publish sends one draft to the official public WarGuardian ban list.
• Drafts, private lists and your own exports need no evidence.
• The official list needs notes that say more than the ban category.
• It also needs one uploaded video or image, or one link with kind video or image.
• Supporting links alone do not count as evidence.
• Tickets and transcripts are optional, and valid submissions publish at once.

Accepted-ban export fields

GET /api/cinder?view=export&page=0&listId=LIST_UUID

• Exports accepted bans only.
• Omit listId for all followed lists.
• Your submissions remain separate under source=own.

Evidence files

GET /api/cinder?view=list-evidence&listId=LIST_UUID&entryId=CASE_UUID&fileId=FILE_UUID

Returns a short-lived file URL that expires after 60 seconds.

• Hidden evidence is omitted.
• Private lists require a valid sharing-code grant.
• Revoked, withdrawn, expired and inaccessible cases are excluded.

Update and withdraw

GET /api/cinder?view=case&id=CASE_UUID
POST /api/cinder {"action":"save","id":"CASE_UUID","version":1,"input":{...}}
POST /api/cinder {"action":"withdraw","id":"CASE_UUID","version":2}

• Use the latest case version.
• Published case facts cannot be edited.
• Withdrawing removes the case from public exports.

Responses