From b8d2075fdc74ea12fe572bfcb11231f298f27ccf Mon Sep 17 00:00:00 2001
From: Crt Ahlin <crt.ahlin@gmail.com>
Date: Thu, 29 Jan 2026 14:51:32 +0100
Subject: [PATCH] Fix typos and parameter naming in OpenAPI spec

- Fix parameter name mismatch in /bytes/{reference} HEAD: address -> reference
- Fix parameter name mismatch in /bzz/{reference} HEAD: address -> reference
- Fix parameter name mismatch in /chunks/{address} GET: reference -> address
- Fix typo: integerity -> integrity in /pins/check summary
- Fix incorrect description for /pins/check ref parameter
---
 openapi/Swarm.yaml | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/openapi/Swarm.yaml b/openapi/Swarm.yaml
index ab8c7a47c24..91689d5fbae 100644
--- a/openapi/Swarm.yaml
+++ b/openapi/Swarm.yaml
@@ -232,11 +232,11 @@ paths:
         - Bytes
       parameters:
         - in: path
-          name: address
+          name: reference
           schema:
             $ref: "SwarmCommon.yaml#/components/schemas/SwarmAddress"
           required: true
-          description: Swarm address of chunk
+          description: Swarm address reference to content
         - $ref: "SwarmCommon.yaml#/components/parameters/SwarmActTimestamp"
         - $ref: "SwarmCommon.yaml#/components/parameters/SwarmActPublisher"
         - $ref: "SwarmCommon.yaml#/components/parameters/SwarmActHistoryAddress"
@@ -447,11 +447,11 @@ paths:
         - BZZ
       parameters:
         - in: path
-          name: address
+          name: reference
           schema:
             $ref: "SwarmCommon.yaml#/components/schemas/SwarmAddress"
           required: true
-          description: Swarm address of chunk
+          description: Swarm address reference to content
         - $ref: "SwarmCommon.yaml#/components/parameters/SwarmActTimestamp"
         - $ref: "SwarmCommon.yaml#/components/parameters/SwarmActPublisher"
         - $ref: "SwarmCommon.yaml#/components/parameters/SwarmActHistoryAddress"
@@ -729,7 +729,7 @@ paths:
 
   "/pins/check":
     get:
-      summary: Validate pinned chunks integerity
+      summary: Validate pinned chunks integrity
       tags:
         - Pinning
       parameters:
@@ -738,7 +738,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
@@ -1289,7 +1289,7 @@ paths:
         - Chunk
       parameters:
         - in: path
-          name: reference
+          name: address
           schema:
             $ref: "SwarmCommon.yaml#/components/schemas/SwarmReference"
           required: true