Add token scopes to logs endpoint

Author: Devon-White

specs/signalwire-rest/logs-api/conferences/main.tsp

@@ -14,7 +14,15 @@ namespace LogsAPI.Conferences {
   @friendlyName("Conferences")
   interface Conferences {
     @summary("List Conferences")
-    @doc("A list of Conferences.")
+    @doc("""
+      A list of Conferences.
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_ or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     list(): ConferencesResponse | StatusCode401 | StatusCode404;
   }
 }

specs/signalwire-rest/logs-api/tsp-output/@typespec/openapi3/openapi.yaml

@@ -10,7 +10,14 @@ paths:
     get:
       operationId: Conferences_list
       summary: List Conferences
-      description: A list of Conferences.
+      description: |-
+        A list of Conferences.
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_ or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters: []
       responses:
         '200':