From f2734f753bc1d1f54766d4c539d8e6472644f615 Mon Sep 17 00:00:00 2001
From: Carlos Aguado <crlsa@amazon.com>
Date: Fri, 19 Jan 2024 12:24:31 +0000
Subject: [PATCH] Model locations and sessions as REST resources

Remove the action from the URI for the resource to allow individual
referencing and collections of nested resources.
---
 api/openapi.yaml | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/api/openapi.yaml b/api/openapi.yaml
index b319054..769a348 100644
--- a/api/openapi.yaml
+++ b/api/openapi.yaml
@@ -34,12 +34,13 @@ paths:
         '400':
           $ref: '#/components/responses/ErrorResponse'
 
-  /list_locations:
+  /locations:
     get:
+      description: Lists all the visible locations to the caller.
       parameters:
         - name: asn
           in: query
-          description: List avaible locations for peering with the given ASN
+          description: List available locations for peering with the given ASN
           required: true
           schema:
             type: integer
@@ -63,9 +64,9 @@ paths:
         '400':
           $ref: '#/components/responses/ErrorResponse'
 
-  /add_sessions:
+  /sessions:
     post:
-      description: Request peering
+      description: Requests a new set of sessions to be created.
       requestBody:
         description: Request to create peering sessions
         content:
@@ -89,8 +90,8 @@ paths:
         '400':
           $ref: '#/components/responses/ErrorResponse'
 
-  /get_status:
     get:
+      description: Lists a set of sessions visible to the caller. Each session in the set contains a summary of its current status.
       parameters:
         - name: asn
           in: query