From fa6289a0a7d5f92c7ca08d6e089ecc6cda4413fc Mon Sep 17 00:00:00 2001
From: bbiggerr <bxbigg@gmail.com>
Date: Fri, 20 Aug 2021 16:24:05 -0400
Subject: [PATCH 1/4] [New] Region Migrations List

---
 openapi.yaml | 46 ++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 46 insertions(+)

diff --git a/openapi.yaml b/openapi.yaml
index 2dd6c8d34..f7729cbdd 100644
--- a/openapi.yaml
+++ b/openapi.yaml
@@ -14542,6 +14542,52 @@ paths:
       - lang: CLI
         source: >
           linode-cli regions view us-east
+  /regions/{regionId}/migrations:
+    x-linode-cli-command: regions
+    servers:
+    - url: https://api.linode.com/v4beta
+    parameters:
+    - name: regionId
+      in: path
+      description: ID of the Region to look up.
+      required: true
+      schema:
+        type: string
+    get:
+      tags:
+      - Regions
+      summary: Region Migrations List
+      description: |
+        Returns the migration queue sizes for the Region.
+
+        Only the Block Storage Volumes migration queue size is returned at this time.
+
+        **Beta**: This endpoint is in beta. Please make sure to prepend all requests with
+        `/v4beta` instead of `/v4`, and be aware that this endpoint may receive breaking
+        updates in
+      operationId: getRegionMigrations
+      x-linode-cli-action: migrations
+      responses:
+        '200':
+          description: A Region Migrations object.
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  volumes:
+                    type: integer
+                    description: The size of the Block Storage Volumes migration queue for the Region.
+                    example: 42
+        default:
+          $ref: '#/components/responses/ErrorResponse'
+      x-code-samples:
+      - lang: Shell
+        source: >
+          curl https://api.linode.com/v4/regions/us-east/migrations
+      - lang: CLI
+        source: >
+          linode-cli regions migrations us-east
   /support/tickets:
     x-linode-cli-command: tickets
     get:

From 5efe5f5981651c330c520376dc82e83763f35a60 Mon Sep 17 00:00:00 2001
From: bbiggerr <bxbigg@gmail.com>
Date: Fri, 20 Aug 2021 16:27:20 -0400
Subject: [PATCH 2/4] Fix beta tag

---
 openapi.yaml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openapi.yaml b/openapi.yaml
index f7729cbdd..d131ede4a 100644
--- a/openapi.yaml
+++ b/openapi.yaml
@@ -14544,8 +14544,6 @@ paths:
           linode-cli regions view us-east
   /regions/{regionId}/migrations:
     x-linode-cli-command: regions
-    servers:
-    - url: https://api.linode.com/v4beta
     parameters:
     - name: regionId
       in: path
@@ -14554,6 +14552,8 @@ paths:
       schema:
         type: string
     get:
+      servers:
+      - url: https://api.linode.com/v4beta
       tags:
       - Regions
       summary: Region Migrations List

From b03a587663a2e0e2e9bfcd195343adfabf25632a Mon Sep 17 00:00:00 2001
From: bbiggerr <bxbigg@gmail.com>
Date: Mon, 23 Aug 2021 16:40:01 -0400
Subject: [PATCH 3/4] Complete sentence

---
 openapi.yaml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/openapi.yaml b/openapi.yaml
index d131ede4a..dfd8a5a50 100644
--- a/openapi.yaml
+++ b/openapi.yaml
@@ -14564,7 +14564,8 @@ paths:
 
         **Beta**: This endpoint is in beta. Please make sure to prepend all requests with
         `/v4beta` instead of `/v4`, and be aware that this endpoint may receive breaking
-        updates in
+        updates in the future. This notice will be removed when this endpoint is out of
+        beta.
       operationId: getRegionMigrations
       x-linode-cli-action: migrations
       responses:

From c1d8e8ffddc3e157398bd4bc26bafa191f1d1c1d Mon Sep 17 00:00:00 2001
From: bbiggerr <bxbigg@gmail.com>
Date: Tue, 24 Aug 2021 10:04:33 -0400
Subject: [PATCH 4/4] Update description

---
 openapi.yaml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/openapi.yaml b/openapi.yaml
index dfd8a5a50..b79b56b06 100644
--- a/openapi.yaml
+++ b/openapi.yaml
@@ -14558,7 +14558,8 @@ paths:
       - Regions
       summary: Region Migrations List
       description: |
-        Returns the migration queue sizes for the Region.
+        Returns the number of queued migrations for the Region. Scheduled migrations that have not been placed on the
+        queue are not included in this count.
 
         Only the Block Storage Volumes migration queue size is returned at this time.