diff --git a/openapi/Swarm.yaml b/openapi/Swarm.yaml
index 16ec4f427c2..8be3e66bc41 100644
--- a/openapi/Swarm.yaml
+++ b/openapi/Swarm.yaml
@@ -158,6 +158,11 @@ paths:
             $ref: "SwarmCommon.yaml#/components/schemas/SwarmReference"
           required: true
           description: Swarm address reference to content
+        - in: header
+          schema:
+            $ref: "SwarmCommon.yaml#/components/parameters/SwarmCache"
+          name: swarm-cache
+          required: false
       responses:
         "200":
           description: Retrieved content specified by reference
@@ -300,6 +305,11 @@ paths:
             $ref: "SwarmCommon.yaml#/components/schemas/SwarmReference"
           required: true
           description: Swarm address of content
+        - in: header
+          schema:
+            $ref: "SwarmCommon.yaml#/components/parameters/SwarmCache"
+          name: swarm-cache
+          required: false
       responses:
         "200":
           description: Ok
diff --git a/openapi/SwarmCommon.yaml b/openapi/SwarmCommon.yaml
index ce3f988e3dc..a3e46342eea 100644
--- a/openapi/SwarmCommon.yaml
+++ b/openapi/SwarmCommon.yaml
@@ -985,6 +985,15 @@ components:
       description: >
         Determines if the uploaded data should be sent to the network immediately or in a deferred fashion. By default the upload will be direct.
 
+    SwarmCache:
+      in: header
+      name: swarm-cache
+      schema:
+        type: boolean
+        default: "true"
+      required: false
+      description: "Determines if the download data should be cached on the node. By default the download will be cached"
+
   responses:
     "204":
       description: The resource was deleted successfully.