From 53e8d71117525ccb818095d262850c9e5badd0bd Mon Sep 17 00:00:00 2001
From: Olivier 'reivilibre <oliverw@matrix.org>
Date: Thu, 1 Feb 2024 13:45:38 +0000
Subject: [PATCH 1/2] Use a POST request in Federation request signing example

Otherwise the GET request having a body is confusing, since it is not valid HTTP
---
 content/server-server-api.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/content/server-server-api.md b/content/server-server-api.md
index e7c231796..fb1b06f4e 100644
--- a/content/server-server-api.md
+++ b/content/server-server-api.md
@@ -290,7 +290,7 @@ Step 1 sign JSON:
 
 ```
 {
-    "method": "GET",
+    "method": "POST",
     "uri": "/target",
     "origin": "origin.hs.example.com",
     "destination": "destination.hs.example.com",
@@ -311,7 +311,7 @@ condition applies throughout the request signing process.
 
 Step 2 add Authorization header:
 
-    GET /target HTTP/1.1
+    POST /target HTTP/1.1
     Authorization: X-Matrix origin="origin.hs.example.com",destination="destination.hs.example.com",key="ed25519:key1",sig="ABCDEF..."
     Content-Type: application/json
 

From c693cebcde180ab75ffd9719c29bf111fe86ce58 Mon Sep 17 00:00:00 2001
From: Olivier 'reivilibre <oliverw@matrix.org>
Date: Thu, 1 Feb 2024 13:47:38 +0000
Subject: [PATCH 2/2] Newsfile

---
 changelogs/server_server/newsfragments/1721.clarification | 1 +
 1 file changed, 1 insertion(+)
 create mode 100644 changelogs/server_server/newsfragments/1721.clarification

diff --git a/changelogs/server_server/newsfragments/1721.clarification b/changelogs/server_server/newsfragments/1721.clarification
new file mode 100644
index 000000000..a742501b2
--- /dev/null
+++ b/changelogs/server_server/newsfragments/1721.clarification
@@ -0,0 +1 @@
+Clarify Server-Server API request signing example by using the `POST` HTTP method, as `GET` requests don't have request bodies.