TANITARDevelopers
WebhooksEvent catalogTournaments

tournament.stage.placements-updated

Version 1 of the tournament.stage.placements-updated webhook event.

The tournament.stage.placements-updated event.

Event typetournament.stage.placements-updated
Schema version1
Routing keyevent.tournament.stage.placements-updated.v1
Produced byTournament Management
Schemaurn:defendr:contract:tournament:stage-placements-updated:1

data fields

FieldTypeRequiredDescription
tournamentIdstringyes
organizationIdstringyes
stageIdstringyes
revisionintegeryes
placementsarray of objectyes

Some fields are required only in particular states. The JSON Schema below is authoritative.

Example delivery

Signed with the example secret whsec_placeholder_example_webhooks_signing_secret, so you can check your verifier against it. See Verifying signatures.

POST /your/webhook/endpoint HTTP/1.1
content-type: application/json
webhook-id: whd_00000000-0000-4000-8000-000000000067
webhook-timestamp: 1800000000
webhook-signature: v1,b7azHIyCgRDkSc7uU2Z/XiV3yeu2CJv5k3wlejO75W4=
tanitar-event-type: tournament.stage.placements-updated
tanitar-schema-version: 1
tanitar-delivery-attempt: 1

{"messageId":"evt_00000000-0000-4000-8000-000000000067","kind":"event","type":"tournament.stage.placements-updated","schemaVersion":1,"occurredAt":"2027-01-15T10:00:00.000Z","producer":"tournament-management-service","accountId":"acc_11111111-1111-4111-8111-111111111111","correlationId":"corr_00000000-0000-4000-8000-000000000067","data":{"tournamentId":"trn_example","organizationId":"org_example","stageId":"stg_example","revision":5,"placements":[]}}

The same body, formatted:

{
  "messageId": "evt_00000000-0000-4000-8000-000000000067",
  "kind": "event",
  "type": "tournament.stage.placements-updated",
  "schemaVersion": 1,
  "occurredAt": "2027-01-15T10:00:00.000Z",
  "producer": "tournament-management-service",
  "accountId": "acc_11111111-1111-4111-8111-111111111111",
  "correlationId": "corr_00000000-0000-4000-8000-000000000067",
  "data": {
    "tournamentId": "trn_example",
    "organizationId": "org_example",
    "stageId": "stg_example",
    "revision": 5,
    "placements": []
  }
}

JSON Schema

urn:defendr:contract:tournament:stage-placements-updated:1
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "urn:defendr:contract:tournament:stage-placements-updated:1",
  "type": "object",
  "additionalProperties": true,
  "required": [
    "tournamentId",
    "organizationId",
    "stageId",
    "revision",
    "placements"
  ],
  "properties": {
    "tournamentId": {
      "type": "string"
    },
    "organizationId": {
      "type": "string"
    },
    "stageId": {
      "type": "string"
    },
    "revision": {
      "type": "integer"
    },
    "placements": {
      "type": "array",
      "items": {
        "type": "object"
      }
    }
  }
}

On this page