From 3ba8244f74de62172730f73a3be426febec004a4 Mon Sep 17 00:00:00 2001
From: Crt Ahlin <crt.ahlin@gmail.com>
Date: Tue, 27 Jan 2026 10:20:12 +0100
Subject: [PATCH] Fix bugs, typos, and parameter naming mismatches in API spec
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Fix typo "integerity" → "integrity" in /pins/check summary
- Fix wrong copy-pasted description on /pins/check ref parameter
- Fix parameter name mismatch in HEAD /bytes/{reference} (was "address")
- Fix parameter name mismatch in HEAD /bzz/{reference} (was "address")
- Fix parameter name mismatch in GET /chunks/{address} (was "reference")

Closes #1
---
 openapi/Swarm.yaml | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/openapi/Swarm.yaml b/openapi/Swarm.yaml
index 04c17b0ee..13bd47e08 100644
--- a/openapi/Swarm.yaml
+++ b/openapi/Swarm.yaml
@@ -257,7 +257,7 @@ paths:
         - Bytes
       parameters:
         - in: path
-          name: address
+          name: reference
           schema:
             $ref: "SwarmCommon.yaml#/components/schemas/SwarmAddress"
           required: true
@@ -467,7 +467,7 @@ paths:
         - BZZ
       parameters:
         - in: path
-          name: address
+          name: reference
           schema:
             $ref: "SwarmCommon.yaml#/components/schemas/SwarmAddress"
           required: true
@@ -752,7 +752,7 @@ paths:
 
   "/pins/check":
     get:
-      summary: Validate pinned chunks integerity
+      summary: Validate pinned chunks integrity
       tags:
         - Pinning
       parameters:
@@ -761,7 +761,7 @@ paths:
           schema:
             $ref: "SwarmCommon.yaml#/components/schemas/SwarmOnlyReference"
           required: false
-          description: The number of items to skip before starting to collect the result set.
+          description: Swarm reference of the pinned root hash to check. If omitted, all pinned content is checked.
       responses:
         "200":
           description: List of checked root hash references
@@ -1309,7 +1309,7 @@ paths:
         - Chunk
       parameters:
         - in: path
-          name: reference
+          name: address
           schema:
             $ref: "SwarmCommon.yaml#/components/schemas/SwarmReference"
           required: true