From 96febd0337ae2c4e69e124d2b4ac2688d6738743 Mon Sep 17 00:00:00 2001
From: Nick Barrett <nick@beeper.com>
Date: Tue, 16 May 2023 19:25:31 +0100
Subject: [PATCH] Add `allow_redirect` query parameter to relevant media
 endpoints

---
 data/api/client-server/content-repo.yaml | 30 ++++++++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/data/api/client-server/content-repo.yaml b/data/api/client-server/content-repo.yaml
index 328ae1c4..7b35accd 100644
--- a/data/api/client-server/content-repo.yaml
+++ b/data/api/client-server/content-repo.yaml
@@ -308,6 +308,16 @@ paths:
             content repository can and should impose a maximum value for this
             parameter. The content repository may also choose to respond before
             the timeout.
+        - in: query
+          type: boolean
+          name: allow_redirect
+          x-example: false
+          required: false
+          default: false
+          description: |
+            Indicates to the server that it may return a 307 or 308 redirect response that points
+            at the relevant media content. When not explicitly set to true the server must return
+            the media content itself.
       responses:
         200:
           description: "The content that was previously uploaded."
@@ -404,6 +414,16 @@ paths:
             content repository can and should impose a maximum value for this
             parameter. The content repository may also choose to respond before
             the timeout.
+        - in: query
+          type: boolean
+          name: allow_redirect
+          x-example: false
+          required: false
+          default: false
+          description: |
+            Indicates to the server that it may return a 307 or 308 redirect response that points
+            at the relevant media content. When not explicitly set to true the server must return
+            the media content itself.
       responses:
         200:
           description: "The content that was previously uploaded."
@@ -518,6 +538,16 @@ paths:
             content repository can and should impose a maximum value for this
             parameter. The content repository may also choose to respond before
             the timeout.
+        - in: query
+          type: boolean
+          name: allow_redirect
+          x-example: false
+          required: false
+          default: false
+          description: |
+            Indicates to the server that it may return a 307 or 308 redirect response that points
+            at the relevant media content. When not explicitly set to true the server must return
+            the media content itself.
       responses:
         200:
           description: "A thumbnail of the requested content."