Clarify that the latest_event field is serialized in the same form as the event itself (#2169 )

ci(build-openapi): indentity routes were missing (#2172 )
2026-02-23 06:23:43 +01:00 · 2025-07-22 15:23:28 +01:00 · 2025-07-22 15:13:51 +01:00
4 changed files with 8 additions and 1 deletions
--- a/.github/workflows/main.yml
+++ b/.github/workflows/main.yml
@ -155,6 +155,11 @@ jobs:
              --api server-server \
              -r "$RELEASE" \
              -o spec/server-server-api/api.json
+          scripts/dump-openapi.py \
+              --base-url "https://spec.matrix.org${{ needs.calculate-baseurl.outputs.baseURL }}" \
+              --api identity \
+              -r "$RELEASE" \
+              -o spec/identity-service-api/api.json
          tar -czf openapi.tar.gz spec
      - name: "📤 Artifact upload"
        uses: actions/upload-artifact@v4
--- a/changelogs/client_server/newsfragments/2169.clarification
+++ b/changelogs/client_server/newsfragments/2169.clarification
@ -0,0 +1 @@
+The `latest_event` in an aggregated set of thread events uses the same format as the event itself.
--- a/changelogs/internal/newsfragments/2172.clarification
+++ b/changelogs/internal/newsfragments/2172.clarification
@ -0,0 +1 @@
+GitHub actions are now building the OpenAPI `spec/identity-service-api/api.json` file.
--- a/content/client-server-api/modules/threading.md
+++ b/content/client-server-api/modules/threading.md
@ -185,7 +185,7 @@ included under the `m.relations` property in `unsigned` for the thread root. For
 ```

 `latest_event` is the most recent event (topologically to the server) in the thread sent by an
-un-[ignored user](#ignoring-users).
+un-[ignored user](#ignoring-users). It should be serialized in the same form as the event itself.

 Note that, as in the example above, child events of the `latest_event` should
 themselves be aggregated and included under `m.relations` for that event. The
Author	SHA1	Message	Date
Benjamin Bouvier	fb4a0d8f66	Clarify that the `latest_event` field is serialized in the same form as the event itself (#2169 ) Some checks failed Spec / 🔎 Validate OpenAPI specifications (push) Has been cancelled Details Spec / 🔎 Check Event schema examples (push) Has been cancelled Details Spec / 🔎 Check OpenAPI definitions examples (push) Has been cancelled Details Spec / 🔎 Check JSON Schemas inline examples (push) Has been cancelled Details Spec / ⚙️ Calculate baseURL for later jobs (push) Has been cancelled Details Spec / 📢 Run towncrier for changelog (push) Has been cancelled Details Spell Check / Spell Check with Typos (push) Has been cancelled Details Spec / 🐍 Build OpenAPI definitions (push) Has been cancelled Details Spec / 📖 Build the spec (push) Has been cancelled Details Spec / 🔎 Validate generated HTML (push) Has been cancelled Details Spec / 📖 Build the historical backup spec (push) Has been cancelled Details	2025-07-22 15:23:28 +01:00
Pierre 'McFly' Marty	4c87e0e745	ci(build-openapi): indentity routes were missing (#2172 )	2025-07-22 15:13:51 +01:00
				`@ -0,0 +1 @@`
				The `latest_event` in an aggregated set of thread events uses the same format as the event itself.
				`@ -0,0 +1 @@`
				GitHub actions are now building the OpenAPI `spec/identity-service-api/api.json` file.