lichess-org · ornicar · Jun 4, 2025 · Jun 4, 2025 · Jun 4, 2025 · Jun 4, 2025
diff --git a/doc/specs/examples/broadcasts-createBroadcastRound.json b/doc/specs/examples/broadcasts-createBroadcastRound.json
@@ -6,6 +6,7 @@
     "createdAt": 1745619386270,
     "ongoing": true,
     "startsAt": 1745619386270,
+    "rated": true,
     "url": "https://lichess.org/broadcast/knight-invitational/final-round/6j92xrwH"
   },
   "tour": {

diff --git a/doc/specs/examples/broadcasts-getBroadcastRound.json b/doc/specs/examples/broadcasts-getBroadcastRound.json
@@ -6,6 +6,7 @@
     "createdAt": 1745619386270,
     "ongoing": true,
     "startsAt": 1745619386270,
+    "rated": true,
     "url": "https://lichess.org/broadcast/knight-invitational-2/final-round/6j92xrwH"
   },
   "tour": {

diff --git a/doc/specs/examples/broadcasts-getBroadcastTournament.json b/doc/specs/examples/broadcasts-getBroadcastTournament.json
@@ -17,6 +17,7 @@
       "createdAt": 1745619386133,
       "ongoing": true,
       "startsAt": 1745622986125,
+      "rated": true,
       "url": "https://lichess.org/broadcast/knight-invitational/round-1/lXnKRxIP"
     },
     {
@@ -26,6 +27,7 @@
       "createdAt": 1745619386242,
       "ongoing": true,
       "startsAt": 1745626586125,
+      "rated": true,
       "url": "https://lichess.org/broadcast/knight-invitational/round-2/7QBlwdN3"
     },
     {
@@ -35,6 +37,7 @@
       "createdAt": 1745619386257,
       "ongoing": true,
       "startsAt": 1745630186125,
+      "rated": true,
       "url": "https://lichess.org/broadcast/knight-invitational/round-3/Evrjw8XS"
     },
     {
@@ -44,6 +47,7 @@
       "createdAt": 1745619386270,
       "ongoing": true,
       "startsAt": 1745619386270,
+      "rated": true,
       "url": "https://lichess.org/broadcast/knight-invitational/final-round/6j92xrwH"
     }
   ],

diff --git a/doc/specs/examples/broadcasts-getOfficialBroadcasts.json b/doc/specs/examples/broadcasts-getOfficialBroadcasts.json
@@ -17,6 +17,7 @@
       "createdAt": 1746738601488,
       "ongoing": true,
       "startsAt": 1746742201434,
+      "rated": true,
       "url": "https://lichess.org/broadcast/knight-invitational/round-1/eJLgkG7n"
     },
     {
@@ -26,6 +27,7 @@
       "createdAt": 1746738601640,
       "ongoing": true,
       "startsAt": 1746745801434,
+      "rated": true,
       "url": "https://lichess.org/broadcast/knight-invitational/round-2/97ILZHjQ"
     },
     {
@@ -35,6 +37,7 @@
       "createdAt": 1746738601663,
       "ongoing": true,
       "startsAt": 1746749401434,
+      "rated": true,
       "url": "https://lichess.org/broadcast/knight-invitational/round-3/SqzHhD4p"
     },
     {
@@ -44,6 +47,7 @@
       "createdAt": 1746738601684,
       "ongoing": true,
       "startsAt": 1746738601684,
+      "rated": true,
       "url": "https://lichess.org/broadcast/knight-invitational/final-round/6qYaFbEv"
     }
   ],

diff --git a/doc/specs/examples/broadcasts-getPaginatedToBroadcastPreviews.json b/doc/specs/examples/broadcasts-getPaginatedToBroadcastPreviews.json
@@ -18,6 +18,7 @@
         "createdAt": 1745619386133,
         "ongoing": true,
         "startsAt": 1745622986125,
+        "rated": true,
         "url": "https://lichess.org/broadcast/knight-invitational/round-1/lXnKRxIP"
       }
     }

diff --git a/doc/specs/examples/broadcasts-getYourBroadcastRounds.json b/doc/specs/examples/broadcasts-getYourBroadcastRounds.json
@@ -6,6 +6,7 @@
     "createdAt": 1745619386270,
     "ongoing": true,
     "startsAt": 1745619386270,
+    "rated": true,
     "url": "https://lichess.org/broadcast/knight-invitational-2/final-round-2/6j92xrwH"
   },
   "tour": {

diff --git a/doc/specs/examples/broadcasts-searchBroadcasts.json b/doc/specs/examples/broadcasts-searchBroadcasts.json
@@ -20,6 +20,7 @@
         "createdAt": 1746738601684,
         "ongoing": true,
         "startsAt": 1746738601684,
+        "rated": true,
         "url": "https://lichess.org/broadcast/knight-invitational/final-round/6qYaFbEv"
       }
     }

diff --git a/doc/specs/examples/broadcasts-updateBroadcastRound.json b/doc/specs/examples/broadcasts-updateBroadcastRound.json
@@ -6,6 +6,7 @@
     "createdAt": 1745619386270,
     "ongoing": true,
     "startsAt": 1745619386270,
+    "rated": true,
     "url": "https://lichess.org/broadcast/knight-invitational-2/final-round-2/6j92xrwH"
   },
   "tour": {

diff --git a/doc/specs/schemas/BroadcastCustomPoints.yaml b/doc/specs/schemas/BroadcastCustomPoints.yaml
@@ -0,0 +1,14 @@
+type: object
+properties:
+  win:
+    type: number
+    minimum: 0.0
+    maximum: 10.0
+  draw:
+    type: number
+    minimum: 0.0
+    maximum: 10.0
+
+required:
+  - win
+  - draw
diff --git a/doc/specs/schemas/BroadcastCustomScoring.yaml b/doc/specs/schemas/BroadcastCustomScoring.yaml
@@ -0,0 +1,13 @@
+type: object
+description: Scoring overrides for wins or draws.
+properties:
+  white:
+    type: object
+    $ref: "./BroadcastCustomPoints.yaml"
+  black:
+    type: object
+    $ref: "./BroadcastCustomPoints.yaml"
+
+required:
+  - white
+  - black
diff --git a/doc/specs/schemas/BroadcastRoundForm.yaml b/doc/specs/schemas/BroadcastRoundForm.yaml
@@ -162,6 +162,13 @@ allOf:
         description: |
           Lichess can usually detect the round status, but you can also set it manually if needed.
         default: new
+      rated:
+        type: boolean
+        default: true
+        description: "Whether the round is used when calculating players' rating changes."
+      customScoring:
+        type: object
+        $ref: "./BroadcastCustomScoring.yaml"
       period:
         type: integer
         description: |

diff --git a/doc/specs/schemas/BroadcastRoundInfo.yaml b/doc/specs/schemas/BroadcastRoundInfo.yaml
@@ -10,6 +10,9 @@ properties:
   createdAt:
     type: integer
     format: int64
+  rated:
+    type: boolean
+    description: "Whether the round is used for rating calculations"
   ongoing:
     type: boolean
   startsAt:
@@ -29,10 +32,14 @@ properties:
   delay:
     type: integer
     format: int64
+  customScoring:
+    type: object
+    $ref: "./BroadcastCustomScoring.yaml"
 
 required:
   - id
   - name
   - slug
   - url
   - createdAt
+  - rated