From d496d03b7f46550dc6cdf9bf6079d6120cb08f8e Mon Sep 17 00:00:00 2001
From: Tim Burke <tim.burke@gmail.com>
Date: Thu, 7 Apr 2022 12:45:07 -0700
Subject: [PATCH] api-ref: Document `reverse` param

Change-Id: I731ff275e14fbb0271ddb50f91550197d6d0a4a4
---
 api-ref/source/parameters.yaml                | 8 ++++++++
 api-ref/source/storage-account-services.inc   | 1 +
 api-ref/source/storage-container-services.inc | 1 +
 3 files changed, 10 insertions(+)

diff --git a/api-ref/source/parameters.yaml b/api-ref/source/parameters.yaml
index 3950dcfc89..01952f58f4 100644
--- a/api-ref/source/parameters.yaml
+++ b/api-ref/source/parameters.yaml
@@ -1130,6 +1130,14 @@ prefix:
   in: query
   required: false
   type: string
+reverse:
+  description: |
+    By default, listings are returned sorted by name, ascending. If you include
+    the ``reverse=true`` query parameter, the listing will be returned sorted
+    by name, descending.
+  in: query
+  required: false
+  type: boolean
 swiftinfo_expires:
   description: |
     The time at which ``swiftinfo_sig`` expires. The time is in
diff --git a/api-ref/source/storage-account-services.inc b/api-ref/source/storage-account-services.inc
index 455ed02dc5..2bcab9ab94 100644
--- a/api-ref/source/storage-account-services.inc
+++ b/api-ref/source/storage-account-services.inc
@@ -82,6 +82,7 @@ Request
    - format: format
    - prefix: prefix
    - delimiter: delimiter
+   - reverse: reverse
    - X-Auth-Token: X-Auth-Token
    - X-Service-Token: X-Service-Token
    - X-Newest: X-Newest
diff --git a/api-ref/source/storage-container-services.inc b/api-ref/source/storage-container-services.inc
index 8c3216eea0..7d7be9fc52 100644
--- a/api-ref/source/storage-container-services.inc
+++ b/api-ref/source/storage-container-services.inc
@@ -56,6 +56,7 @@ Request
    - format: format
    - delimiter: delimiter
    - path: path
+   - reverse: reverse
    - X-Auth-Token: X-Auth-Token
    - X-Service-Token: X-Service-Token
    - X-Newest: X-Newest