diff --git a/specs/compatibility-api/_spec_.yaml b/specs/compatibility-api/_spec_.yaml
index 82f0bcd20..704d7e78f 100644
--- a/specs/compatibility-api/_spec_.yaml
+++ b/specs/compatibility-api/_spec_.yaml
@@ -213,7 +213,9 @@ paths:
 
         #### Permissions
 
-        The API token must include the following scopes: _Management_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Management_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Accounts
       parameters:
@@ -364,7 +366,9 @@ paths:
         This endpoint create a subproject on the Project you are connecting as.
 
         #### Permissions
-        The API token must include the following scopes: _Management_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Management_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Accounts
       requestBody:
@@ -521,7 +525,9 @@ paths:
         Find a Project (also referred to as _Account_) by ID.
 
         #### Permissions
-        The API token must include the following scopes: _Management_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Management_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Accounts
       responses:
@@ -656,7 +662,9 @@ paths:
         Update a Project (also referred to as _Account_).
 
         #### Permissions
-        The API token must include the following scopes: _Management_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Management_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Accounts
       requestBody:
@@ -813,8 +821,10 @@ paths:
 
         #### Permissions
 
-        The API token must include one of the following scopes: _Voice_ or
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_ or
         _Messaging_ or _Fax_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Applications
       requestBody:
@@ -1091,8 +1101,10 @@ paths:
 
         #### Permissions
 
-        The API token must include one of the following scopes: _Voice_ or
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_ or
         _Messaging_ or _Fax_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Applications
       responses:
@@ -1269,8 +1281,10 @@ paths:
 
         #### Permissions
 
-        The API token must include one of the following scopes: _Voice_ or
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_ or
         _Messaging_ or _Fax_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Applications
       responses:
@@ -1422,8 +1436,10 @@ paths:
 
         #### Permissions
 
-        The API token must include one of the following scopes: _Voice_ or
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_ or
         _Messaging_ or _Fax_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Applications
       requestBody:
@@ -1678,8 +1694,10 @@ paths:
 
         #### Permissions
 
-        The API token must include one of the following scopes: _Voice_ or
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_ or
         _Messaging_ or _Fax_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Applications
       responses:
@@ -1790,7 +1808,9 @@ paths:
         Search for Local AvailablePhoneNumbers.
 
         #### Permissions
-        The API token must include the following scopes: _Numbers_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Numbers_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       responses:
         '200':
           description: OK
@@ -1988,7 +2008,9 @@ paths:
         Search for toll-free AvailablePhoneNumbers.
 
         #### Permissions
-        The API token must include the following scopes: _Numbers_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Numbers_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       responses:
         '200':
           description: OK
@@ -2104,7 +2126,9 @@ paths:
 
         #### Permissions
 
-        The API token must include the following scopes: _Numbers_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Numbers_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       responses:
         '200':
           description: OK
@@ -2182,7 +2206,9 @@ paths:
 
         #### Permissions
 
-        The API token must include the following scopes: _Numbers_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Numbers_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       responses:
         '200':
           description: OK
@@ -2240,7 +2266,9 @@ paths:
         List all calls.
 
         #### Permissions
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - in: query
           name: EndTime
@@ -2498,7 +2526,9 @@ paths:
         Create a call.
 
         #### Permissions
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       requestBody:
         required: true
         content:
@@ -2945,7 +2975,9 @@ paths:
         Retrieve a call.
 
         #### Permissions
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       responses:
         '200':
           description: OK
@@ -3097,7 +3129,9 @@ paths:
         Allows you to modify an active call.
 
         #### Permissions
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       requestBody:
         required: true
         content:
@@ -3322,7 +3356,9 @@ paths:
 
         #### Permissions
 
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       responses:
         '204':
           $ref: '#/components/responses/204'
@@ -3360,7 +3396,9 @@ paths:
         Retrieve a single Participant.
 
         #### Permissions
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       responses:
         '200':
           description: OK
@@ -3459,7 +3497,9 @@ paths:
 
         #### Permissions
 
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       requestBody:
         required: true
         content:
@@ -3626,7 +3666,9 @@ paths:
 
         #### Permissions
 
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       responses:
         '204':
           $ref: '#/components/responses/204'
@@ -3674,7 +3716,9 @@ paths:
 
         #### Permissions
 
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       responses:
         '200':
           description: OK
@@ -3820,7 +3864,9 @@ paths:
         Retrieve a single conference.
 
         #### Permissions
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       responses:
         '200':
           description: OK
@@ -3901,7 +3947,9 @@ paths:
         Allows you to modify the properties of a conference.
 
         #### Permissions
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       requestBody:
         content:
           application/x-www-form-urlencoded:
@@ -4052,7 +4100,9 @@ paths:
 
         #### Permissions
 
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       responses:
         '200':
           description: OK
@@ -4181,7 +4231,9 @@ paths:
         Create a stream for an existing conference.
 
         #### Permissions
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Conference Streams
       requestBody:
@@ -4345,7 +4397,9 @@ paths:
       description: |
         Update an existing conference stream. Commonly used to stop/start streams or modify stream properties.
         #### Permissions
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Conference Streams
       requestBody:
@@ -4480,7 +4534,9 @@ paths:
 
         #### Permissions
 
-        The API token must include the following scopes: _Fax_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Fax_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Faxes
       responses:
@@ -4641,7 +4697,9 @@ paths:
         Send a fax.
 
         #### Permissions
-        The API token must include the following scopes: _Fax_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Fax_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Faxes
       requestBody:
@@ -4835,7 +4893,9 @@ paths:
         Retrieve a fax.
 
         #### Permissions
-        The API token must include the following scopes: _Fax_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Fax_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Faxes
       responses:
@@ -4971,7 +5031,9 @@ paths:
         Allows you to modify the properties of Fax.
 
         #### Permissions
-        The API token must include the following scopes: _Fax_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Fax_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Faxes
       requestBody:
@@ -5131,7 +5193,9 @@ paths:
 
         #### Permissions
 
-        The API token must include the following scopes: _Fax_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Fax_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Faxes
       responses:
@@ -5165,7 +5229,9 @@ paths:
 
         #### Permissions
 
-        The API token must include the following scopes: _Fax_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Fax_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Fax Media
       responses:
@@ -5254,7 +5320,9 @@ paths:
 
         #### Permissions
 
-        The API token must include the following scopes: _Fax_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Fax_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Fax Media
       responses:
@@ -5311,7 +5379,9 @@ paths:
 
         #### Permissions
 
-        The API token must include the following scopes: _Fax_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Fax_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Fax Media
       responses:
@@ -5367,7 +5437,9 @@ paths:
 
         #### Permissions
 
-        The API token must include the following scopes: _Numbers_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Numbers_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Incoming Phone Numbers
       responses:
@@ -5624,7 +5696,9 @@ paths:
         Create an Incoming Phone Number.
 
         #### Permissions
-        The API token must include the following scopes: _Numbers_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Numbers_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Incoming Phone Numbers
       requestBody:
@@ -5988,7 +6062,9 @@ paths:
         Retrieve an incoming phone number.
 
         #### Permissions
-        The API token must include the following scopes: _Numbers_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Numbers_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Incoming Phone Numbers
       responses:
@@ -6203,7 +6279,9 @@ paths:
 
         #### Permissions
 
-        The API token must include the following scopes: _Numbers_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Numbers_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Incoming Phone Numbers
       requestBody:
@@ -6553,7 +6631,9 @@ paths:
 
         #### Permissions
 
-        The API token must include the following scopes: _Numbers_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Numbers_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Incoming Phone Numbers
       responses:
@@ -6581,7 +6661,9 @@ paths:
 
         #### Permissions
 
-        The API token must include the following scopes: _Numbers_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Numbers_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Imported Phone Numbers
       requestBody:
@@ -6884,8 +6966,10 @@ paths:
 
         #### Permissions
 
-        The API token must include one of the following scopes: _Voice_ or
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_ or
         _Messaging_ or _Fax_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - cXML Bins
       responses:
@@ -6989,8 +7073,10 @@ paths:
 
         #### Permissions
 
-        The API token must include one of the following scopes: _Voice_ or
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_ or
         _Messaging_ or _Fax_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - cXML Bins
       requestBody:
@@ -7114,8 +7200,10 @@ paths:
 
         #### Permissions
 
-        The API token must include one of the following scopes: _Voice_ or
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_ or
         _Messaging_ or _Fax_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - cXML Bins
       responses:
@@ -7201,8 +7289,10 @@ paths:
 
         #### Permissions
 
-        The API token must include one of the following scopes: _Voice_ or
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_ or
         _Messaging_ or _Fax_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - cXML Bins
       requestBody:
@@ -7309,8 +7399,10 @@ paths:
 
         #### Permissions
 
-        The API token must include one of the following scopes: _Voice_ or
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_ or
         _Messaging_ or _Fax_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - cXML Bins
       responses:
@@ -7388,7 +7480,9 @@ paths:
 
         #### Permissions
 
-        The API token must include the following scopes: _Messaging_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Messaging_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Messages
       responses:
@@ -7574,7 +7668,9 @@ paths:
         Create a message.
 
         #### Permissions
-        The API token must include the following scopes: _Messaging_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Messaging_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Messages
       requestBody:
@@ -7844,7 +7940,9 @@ paths:
         Retrieve a single message.
 
         #### Permissions
-        The API token must include the following scopes: _Messaging_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Messaging_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Messages
       responses:
@@ -8005,7 +8103,9 @@ paths:
 
         #### Permissions
 
-        The API token must include the following scopes: _Messaging_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Messaging_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Messages
       requestBody:
@@ -8185,7 +8285,9 @@ paths:
 
         #### Permissions
 
-        The API token must include the following scopes: _Messaging_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Messaging_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Messages
       responses:
@@ -8232,7 +8334,9 @@ paths:
 
         #### Permissions
 
-        The API token must include the following scopes: _Messaging_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Messaging_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Media
       responses:
@@ -8324,7 +8428,9 @@ paths:
         Retrieve a single media.
 
         #### Permissions
-        The API token must include the following scopes: _Messaging_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Messaging_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Media
       responses:
@@ -8379,7 +8485,9 @@ paths:
 
         #### Permissions
 
-        The API token must include the following scopes: _Messaging_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Messaging_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Media
       responses:
@@ -8428,7 +8536,9 @@ paths:
 
         #### Permissions
 
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Recordings
       responses:
@@ -8643,7 +8753,9 @@ paths:
 
         #### Permissions
 
-        The API token must include the following scopes: _Voice_. This permission is only required for authenticated requests to retrieve recording metadata (.json extension).
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_. This permission is only required for authenticated requests to retrieve recording metadata (.json extension).
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Recordings
       responses:
@@ -8761,7 +8873,9 @@ paths:
 
         #### Permissions
 
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Recordings
       responses:
@@ -8794,7 +8908,9 @@ paths:
         Create a recording.
 
         #### Permissions
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Recordings
       requestBody:
@@ -9003,7 +9119,9 @@ paths:
 
         #### Permissions
 
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Recordings
       requestBody:
@@ -9156,7 +9274,9 @@ paths:
 
         #### Permissions
 
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Recording Transcriptions
       responses:
@@ -9268,7 +9388,9 @@ paths:
         Retrieve a single recording transcription.
 
         #### Permissions
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Recording Transcriptions
       responses:
@@ -9357,7 +9479,9 @@ paths:
 
         #### Permissions
 
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Recording Transcriptions
       responses:
@@ -9394,7 +9518,9 @@ paths:
 
         #### Permissions
 
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Queues
       responses:
@@ -9478,7 +9604,9 @@ paths:
         Create a call queue.
 
         #### Permissions
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Queues
       requestBody:
@@ -9576,7 +9704,9 @@ paths:
         Retrieve a single queue.
 
         #### Permissions
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Queues
       responses:
@@ -9640,7 +9770,9 @@ paths:
         Allows you to modify the properties of a single call queue.
 
         #### Permissions
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Queues
       requestBody:
@@ -9726,7 +9858,9 @@ paths:
 
         #### Permissions
 
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Queues
       responses:
@@ -9743,7 +9877,9 @@ paths:
         The ability to read all of the queue members that are waiting in a particular queue. This will be returned as a list of members.
         
         #### Permissions
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Queue Members
       responses:
@@ -9793,7 +9929,9 @@ paths:
         Retrieve a single queue member.
 
         #### Permissions
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Queue Members
       responses:
@@ -9810,7 +9948,9 @@ paths:
         Allows you to dequeue a given queue member and execute new XML Instructions.
 
         #### Permissions
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Queue Members
       parameters:
@@ -9853,7 +9993,9 @@ paths:
         Create a stream.
 
         #### Permissions
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Streams
       requestBody:
@@ -10004,7 +10146,9 @@ paths:
       description: |
         Stop a Stream.
         #### Permissions
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Streams
       requestBody:
@@ -10094,6 +10238,13 @@ paths:
       description: >-
         Generate an API Token for a project to be used to authenticate requests
         within the project.
+
+
+        #### Permissions
+
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Management_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Tokens
       requestBody:
@@ -10200,7 +10351,15 @@ paths:
     patch:
       operationId: update_token
       summary: Update an API Token
-      description: Update an API Token's name or permissions.
+      description: >-
+        Update an API Token's name or permissions.
+
+
+        #### Permissions
+
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Management_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Tokens
       parameters:
@@ -10313,7 +10472,15 @@ paths:
     delete:
       operationId: delete_token
       summary: Delete an API Token
-      description: Delete an API Token. This action cannot be undone.
+      description: >-
+        Delete an API Token. This action cannot be undone.
+
+
+        #### Permissions
+
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Management_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Tokens
       parameters:
diff --git a/specs/signalwire-rest/calling-api/calls/main.tsp b/specs/signalwire-rest/calling-api/calls/main.tsp
index ffb2afc33..2dd0d31e7 100644
--- a/specs/signalwire-rest/calling-api/calls/main.tsp
+++ b/specs/signalwire-rest/calling-api/calls/main.tsp
@@ -19,6 +19,12 @@ namespace CallingAPI.Calls {
     Unified JSON-RPC style endpoint for executing call methods through command-based dispatch.
     Send a request with the appropriate `command` field to invoke the desired call operation.
     This endpoint provides a single interface for all call-related methods including creation, updates, termination, and AI conversation control.
+
+    #### Permissions
+
+    The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+    [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
     """)
     @opExample(
       #{ parameters: dialCallExample },
diff --git a/specs/signalwire-rest/calling-api/tsp-output/@typespec/openapi3/openapi.yaml b/specs/signalwire-rest/calling-api/tsp-output/@typespec/openapi3/openapi.yaml
index 6cba4a9c5..b0676e063 100644
--- a/specs/signalwire-rest/calling-api/tsp-output/@typespec/openapi3/openapi.yaml
+++ b/specs/signalwire-rest/calling-api/tsp-output/@typespec/openapi3/openapi.yaml
@@ -29,6 +29,12 @@ paths:
         Unified JSON-RPC style endpoint for executing call methods through command-based dispatch.
         Send a request with the appropriate `command` field to invoke the desired call operation.
         This endpoint provides a single interface for all call-related methods including creation, updates, termination, and AI conversation control.
+
+        #### Permissions
+
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters: []
       responses:
         '200':
diff --git a/specs/signalwire-rest/chat-api/_spec_.yaml b/specs/signalwire-rest/chat-api/_spec_.yaml
index bffde44ea..8dba0aafd 100644
--- a/specs/signalwire-rest/chat-api/_spec_.yaml
+++ b/specs/signalwire-rest/chat-api/_spec_.yaml
@@ -32,7 +32,7 @@ paths:
 
         #### Permissions
 
-        The API token must include the following scopes: _Chat_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Chat_.
       tags:
         - Tokens
       requestBody:
diff --git a/specs/signalwire-rest/chat-api/tokens/main.tsp b/specs/signalwire-rest/chat-api/tokens/main.tsp
index 96fae0994..bc2757a20 100644
--- a/specs/signalwire-rest/chat-api/tokens/main.tsp
+++ b/specs/signalwire-rest/chat-api/tokens/main.tsp
@@ -19,7 +19,9 @@ namespace ChatAPI.Tokens {
       
       #### Permissions
       
-      The API token must include the following scopes: `Chat`.
+      The API token used to authenticate must have the following scopes enabled to make a successful request: _Chat_.
+      
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       """)
     create(...NewChatToken):
       | {
diff --git a/specs/signalwire-rest/chat-api/tsp-output/@typespec/openapi3/openapi.yaml b/specs/signalwire-rest/chat-api/tsp-output/@typespec/openapi3/openapi.yaml
index 401d3e886..f9fd89b6a 100644
--- a/specs/signalwire-rest/chat-api/tsp-output/@typespec/openapi3/openapi.yaml
+++ b/specs/signalwire-rest/chat-api/tsp-output/@typespec/openapi3/openapi.yaml
@@ -16,7 +16,9 @@ paths:
 
         #### Permissions
 
-        The API token must include the following scopes: `Chat`.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Chat_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters: []
       responses:
         '201':
diff --git a/specs/signalwire-rest/datasphere-api/document/main.tsp b/specs/signalwire-rest/datasphere-api/document/main.tsp
index b8804a0f1..5e13c2e28 100644
--- a/specs/signalwire-rest/datasphere-api/document/main.tsp
+++ b/specs/signalwire-rest/datasphere-api/document/main.tsp
@@ -12,11 +12,27 @@ namespace DatasphereAPI.Documents {
   @route("/documents")
   @tag("Documents")
   interface Documents {
-    @doc("A list of Datasphere Documents")
+    @doc("""
+      A list of Datasphere Documents.
+      
+      #### Permissions
+      
+      The API token used to authenticate must have the following scopes enabled to make a successful request: _DataSphere_.
+      
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @summary("List Documents")
     list(): DocumentListResponse | StatusCode401 | StatusCode404;
 
-    @doc("Creates a Datasphere Document")
+    @doc("""
+      Creates a Datasphere Document.
+      
+      #### Permissions
+      
+      The API token used to authenticate must have the following scopes enabled to make a successful request: _DataSphere_.
+      
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @summary("Create a Document")
     @post
     create(@body body: DocumentCreateRequest):
@@ -28,7 +44,15 @@ namespace DatasphereAPI.Documents {
       | StatusCode404
       | CreateStatusCode422;
 
-    @doc("Updates a Datasphere Document by ID")
+    @doc("""
+      Updates a Datasphere Document by ID.
+      
+      #### Permissions
+      
+      The API token used to authenticate must have the following scopes enabled to make a successful request: _DataSphere_.
+      
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @summary("Update a Document")
     @patch(#{ implicitOptionality: true })
     update(...PathID, ...DocumentUpdateRequest):
@@ -40,14 +64,30 @@ namespace DatasphereAPI.Documents {
       | StatusCode404
       | SearchStatusCode422;
 
-    @doc("Deletes a Datasphere Document by ID")
+    @doc("""
+      Deletes a Datasphere Document by ID.
+      
+      #### Permissions
+      
+      The API token used to authenticate must have the following scopes enabled to make a successful request: _DataSphere_.
+      
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @summary("Delete a Document")
     @delete
     delete(...PathID): {
       @statusCode statusCode: 204;
     } | StatusCode401 | StatusCode404;
 
-    @doc("Search Datasphere Documents")
+    @doc("""
+      Search Datasphere Documents.
+      
+      #### Permissions
+      
+      The API token used to authenticate must have the following scopes enabled to make a successful request: _DataSphere_.
+      
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @route("/search")
     @summary("Search Documents")
     @post
@@ -64,16 +104,40 @@ namespace DatasphereAPI.Chunks {
   @tag("Chunks")
   @friendlyName("Chunks")
   interface Chunks {
-    @doc("A list of chunks for a Datasphere Document.")
+    @doc("""
+      A list of chunks for a Datasphere Document.
+      
+      #### Permissions
+      
+      The API token used to authenticate must have the following scopes enabled to make a successful request: _DataSphere_.
+      
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @summary("List Chunks")
     list(...DocumentPathID): ChunkListResponse | StatusCode401 | StatusCode404;
 
-    @doc("Retrieves a specific chunk for a Datasphere Document by ID.")
+    @doc("""
+      Retrieves a specific chunk for a Datasphere Document by ID.
+      
+      #### Permissions
+      
+      The API token used to authenticate must have the following scopes enabled to make a successful request: _DataSphere_.
+      
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @summary("Retrieve Chunk")
     @route("/{chunkId}")
     get(...ChunkPathID): ChunkResponse | StatusCode401 | StatusCode404;
 
-    @doc("Deletes a specific chunk for a Datasphere Document by ID.")
+    @doc("""
+      Deletes a specific chunk for a Datasphere Document by ID.
+      
+      #### Permissions
+      
+      The API token used to authenticate must have the following scopes enabled to make a successful request: _DataSphere_.
+      
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @summary("Delete Chunk")
     @route("/{chunkId}")
     @delete
diff --git a/specs/signalwire-rest/datasphere-api/tsp-output/@typespec/openapi3/openapi.yaml b/specs/signalwire-rest/datasphere-api/tsp-output/@typespec/openapi3/openapi.yaml
index 943750638..7f9ef5dd6 100644
--- a/specs/signalwire-rest/datasphere-api/tsp-output/@typespec/openapi3/openapi.yaml
+++ b/specs/signalwire-rest/datasphere-api/tsp-output/@typespec/openapi3/openapi.yaml
@@ -11,7 +11,14 @@ paths:
     get:
       operationId: Documents_list
       summary: List Documents
-      description: A list of Datasphere Documents
+      description: |-
+        A list of Datasphere Documents.
+
+        #### Permissions
+
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _DataSphere_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters: []
       responses:
         '200':
@@ -37,7 +44,14 @@ paths:
     post:
       operationId: Documents_create
       summary: Create a Document
-      description: Creates a Datasphere Document
+      description: |-
+        Creates a Datasphere Document.
+
+        #### Permissions
+
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _DataSphere_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters: []
       responses:
         '201':
@@ -76,7 +90,14 @@ paths:
     post:
       operationId: Documents_search
       summary: Search Documents
-      description: Search Datasphere Documents
+      description: |-
+        Search Datasphere Documents.
+
+        #### Permissions
+
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _DataSphere_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters: []
       responses:
         '200':
@@ -117,7 +138,14 @@ paths:
     get:
       operationId: Chunks_list
       summary: List Chunks
-      description: A list of chunks for a Datasphere Document.
+      description: |-
+        A list of chunks for a Datasphere Document.
+
+        #### Permissions
+
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _DataSphere_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/DocumentPathID'
       responses:
@@ -145,7 +173,14 @@ paths:
     get:
       operationId: Chunks_get
       summary: Retrieve Chunk
-      description: Retrieves a specific chunk for a Datasphere Document by ID.
+      description: |-
+        Retrieves a specific chunk for a Datasphere Document by ID.
+
+        #### Permissions
+
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _DataSphere_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/ChunkPathID.documentId'
         - $ref: '#/components/parameters/ChunkPathID.chunkId'
@@ -173,7 +208,14 @@ paths:
     delete:
       operationId: Chunks_delete
       summary: Delete Chunk
-      description: Deletes a specific chunk for a Datasphere Document by ID.
+      description: |-
+        Deletes a specific chunk for a Datasphere Document by ID.
+
+        #### Permissions
+
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _DataSphere_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/ChunkPathID.documentId'
         - $ref: '#/components/parameters/ChunkPathID.chunkId'
@@ -198,7 +240,14 @@ paths:
     patch:
       operationId: Documents_update
       summary: Update a Document
-      description: Updates a Datasphere Document by ID
+      description: |-
+        Updates a Datasphere Document by ID.
+
+        #### Permissions
+
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _DataSphere_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/PathID'
       responses:
@@ -237,7 +286,14 @@ paths:
     delete:
       operationId: Documents_delete
       summary: Delete a Document
-      description: Deletes a Datasphere Document by ID
+      description: |-
+        Deletes a Datasphere Document by ID.
+
+        #### Permissions
+
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _DataSphere_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/PathID'
       responses:
diff --git a/specs/signalwire-rest/fabric-api/addresses/main.tsp b/specs/signalwire-rest/fabric-api/addresses/main.tsp
index 91f2e167d..69b224bf4 100644
--- a/specs/signalwire-rest/fabric-api/addresses/main.tsp
+++ b/specs/signalwire-rest/fabric-api/addresses/main.tsp
@@ -17,6 +17,13 @@ namespace FabricAPI.FabricAddresses {
     @doc("""
       A list of Fabric Addresses. This endpoint uses the bearer token authentication method with the SAT (Subscriber Access Token) which can be
       generated using the [Create Subscriber Token endpoint](/rest/signalwire-rest/endpoints/fabric/subscriber-tokens-create).
+      
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       """)
     list():
       | FabricAddressesResponse
@@ -28,6 +35,13 @@ namespace FabricAPI.FabricAddresses {
     @doc("""
       Returns a Fabric Address by ID. This endpoint uses the bearer token authentication method with the SAT (Subscriber Access Token) which can be
       generated using the [Create Subscriber Token endpoint](/rest/signalwire-rest/endpoints/fabric/subscriber-tokens-create).
+      
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       """)
     read(...FabricAddressID):
       | {
diff --git a/specs/signalwire-rest/fabric-api/ai-agent/addresses/main.tsp b/specs/signalwire-rest/fabric-api/ai-agent/addresses/main.tsp
index 9d9ea2b44..263501695 100644
--- a/specs/signalwire-rest/fabric-api/ai-agent/addresses/main.tsp
+++ b/specs/signalwire-rest/fabric-api/ai-agent/addresses/main.tsp
@@ -13,7 +13,15 @@ namespace FabricAPI.AIAgent.Addresses {
   @tag(AI_CUSTOM_TAG)
   interface AIAgentAddresses {
     @summary("List AI Agent Addresses")
-    @doc("This endpoint returns a list of addresses associated with a specific AI Agent.")
+    @doc("""
+      This endpoint returns a list of addresses associated with a specific AI Agent.
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     list(...AIAgentIDPath):
       | AIAgentAddressListResponse
       | StatusCode401
diff --git a/specs/signalwire-rest/fabric-api/ai-agent/main.tsp b/specs/signalwire-rest/fabric-api/ai-agent/main.tsp
index c31723a5b..b8bba27b6 100644
--- a/specs/signalwire-rest/fabric-api/ai-agent/main.tsp
+++ b/specs/signalwire-rest/fabric-api/ai-agent/main.tsp
@@ -17,11 +17,27 @@ namespace FabricAPI.AIAgents {
   @friendlyName("AI Agent: Custom")
   interface AIAgents {
     @summary("List AI Agents")
-    @doc("A list of AI Agents")
+    @doc("""
+      A list of AI Agents
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     list(): AIAgentListResponse | StatusCode401 | StatusCode404 | StatusCode500;
 
     @summary("Get AI Agent")
-    @doc("Returns an AI Agent by ID")
+    @doc("""
+      Returns an AI Agent by ID
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     read(...AIAgentPathID):
       | {
           @statusCode statusCode: 200;
@@ -32,7 +48,15 @@ namespace FabricAPI.AIAgents {
       | StatusCode500;
 
     @summary("Create AI Agent")
-    @doc("Creates an AI Agent")
+    @doc("""
+      Creates an AI Agent
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @post
     create(...AIAgentCreateRequest):
       | {
@@ -45,7 +69,15 @@ namespace FabricAPI.AIAgents {
       | StatusCode500;
 
     @summary("Update AI Agent")
-    @doc("Updates an AI Agent by ID")
+    @doc("""
+      Updates an AI Agent by ID
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @patch(#{ implicitOptionality: true })
     update(...AIAgentPathID, ...AIAgentUpdateRequest):
       | {
@@ -58,7 +90,15 @@ namespace FabricAPI.AIAgents {
       | StatusCode500;
 
     @summary("Delete AI Agent")
-    @doc("Deletes an AI Agent by ID")
+    @doc("""
+      Deletes an AI Agent by ID
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @delete
     delete(...AIAgentPathID):
       | {
diff --git a/specs/signalwire-rest/fabric-api/ai-agent/models/ai/main.tsp b/specs/signalwire-rest/fabric-api/ai-agent/models/ai/main.tsp
index f995a0dd7..5275fa0c5 100644
--- a/specs/signalwire-rest/fabric-api/ai-agent/models/ai/main.tsp
+++ b/specs/signalwire-rest/fabric-api/ai-agent/models/ai/main.tsp
@@ -6,42 +6,61 @@ import "./swaig";
 
 @summary("AI object")
 model AI {
-  @doc("Create a new AI agent.")
+  @doc("""
+      Create a new AI agent.
+      """)
   @summary("ai")
   ai: {
     @doc("""
       A powerful and flexible environmental variable which can accept arbitrary data that is set initially in the SWML script
       or from the SWML `set_global_data` action. This data can be referenced `globally`.
       All contained information can be accessed and expanded within the prompt - for example, by using a template string.
+      
       """)
     global_data?: {
       ...TypeSpec.Record<unknown>;
     };
 
-    @doc("An array of hints (as strings) to provide context to the dialogue.")
+    @doc("""
+      An array of hints (as strings) to provide context to the dialogue.
+      """)
     @example(#["pizza", "pepperoni"])
     hints?: string[];
 
-    @doc("An array of JSON objects defining supported languages in the conversation.")
+    @doc("""
+      An array of JSON objects defining supported languages in the conversation.
+      """)
     languages?: Languages[];
 
-    @doc("A JSON object containing parameters as key-value pairs.")
+    @doc("""
+      A JSON object containing parameters as key-value pairs.
+      """)
     params?: AIParams;
 
-    @doc("The final set of instructions and configuration settings to send to the agent.")
+    @doc("""
+      The final set of instructions and configuration settings to send to the agent.
+      """)
     post_prompt?: AIPostPrompt;
 
-    @doc("The URL to which to send status callbacks and reports. Authentication can also be set in the url in the format of `username:password@url`.")
+    @doc("""
+      The URL to which to send status callbacks and reports. Authentication can also be set in the url in the format of `username:password@url`.
+      """)
     @example("username:password@https://example.com")
     post_prompt_url?: url;
 
-    @doc("An array of JSON objects to clarify the agent's pronunciation of words or expressions.")
+    @doc("""
+      An array of JSON objects to clarify the agent's pronunciation of words or expressions.
+      """)
     pronounce?: Pronounce[];
 
-    @doc("Establishes the initial set of instructions and settings to configure the agent.")
+    @doc("""
+      Establishes the initial set of instructions and settings to configure the agent.
+      """)
     prompt: AIPrompt;
 
-    @doc("An array of JSON objects to create user-defined functions/endpoints that can be executed during the dialogue.")
+    @doc("""
+      An array of JSON objects to create user-defined functions/endpoints that can be executed during the dialogue.
+      """)
     SWAIG?: SWAIG;
   };
 }
diff --git a/specs/signalwire-rest/fabric-api/ai-agent/models/ai/prompt/contexts/main.tsp b/specs/signalwire-rest/fabric-api/ai-agent/models/ai/prompt/contexts/main.tsp
index dd99965fb..1c33bf42b 100644
--- a/specs/signalwire-rest/fabric-api/ai-agent/models/ai/prompt/contexts/main.tsp
+++ b/specs/signalwire-rest/fabric-api/ai-agent/models/ai/prompt/contexts/main.tsp
@@ -2,7 +2,9 @@ import "./steps.tsp";
 
 @summary("contexts")
 model Contexts {
-  @doc("The default context to use at the beginning of the conversation. Additional context steps can be defined as any other key in the object.")
+  @doc("""
+      The default context to use at the beginning of the conversation. Additional context steps can be defined as any other key in the object.
+      """)
   default: ContextSteps;
 
   ...TypeSpec.Record<ContextSteps>;
diff --git a/specs/signalwire-rest/fabric-api/ai-agent/models/ai/prompt/main.tsp b/specs/signalwire-rest/fabric-api/ai-agent/models/ai/prompt/main.tsp
index dd8576515..f0a8632e7 100644
--- a/specs/signalwire-rest/fabric-api/ai-agent/models/ai/prompt/main.tsp
+++ b/specs/signalwire-rest/fabric-api/ai-agent/models/ai/prompt/main.tsp
@@ -2,16 +2,22 @@ import "./contexts";
 
 @summary("AIPromptBase")
 model AIPromptBase {
-  @doc("The instructions to send to the agent.")
+  @doc("""
+      The instructions to send to the agent.
+      """)
   @example("Your name is Franklin and you are taking orders for Franklin's Pizza. Begin by greeting the caller, and ask if they'd like to place an order for pickup or delivery.")
   text: string;
 
-  @doc("Randomness setting. Float value between 0.0 and 1.5. Closer to 0 will make the output less random.")
+  @doc("""
+      Randomness setting. Float value between 0.0 and 1.5. Closer to 0 will make the output less random.
+      """)
   @minValue(0.0)
   @maxValue(1.5)
   temperature?: float;
 
-  @doc("Randomness setting. Alternative to `temperature`. Float value between 0.0 and 1.0. Closer to 0 will make the output less random.")
+  @doc("""
+      Randomness setting. Alternative to `temperature`. Float value between 0.0 and 1.0. Closer to 0 will make the output less random.
+      """)
   @minValue(0.0)
   @maxValue(1.0)
   top_p?: float;
@@ -24,12 +30,16 @@ model AIPromptBase {
   @maxValue(1.0)
   confidence?: float;
 
-  @doc("Aversion to staying on topic. Float value between -2.0 and 2.0. Positive values increase the model's likelihood to talk about new topics.")
+  @doc("""
+      Aversion to staying on topic. Float value between -2.0 and 2.0. Positive values increase the model's likelihood to talk about new topics.
+      """)
   @minValue(-2.0)
   @maxValue(2.0)
   presence_penalty?: float;
 
-  @doc("Aversion to repeating lines. Float value between -2.0 and 2.0. Positive values decrease the model's likelihood to repeat the same line verbatim.")
+  @doc("""
+      Aversion to repeating lines. Float value between -2.0 and 2.0. Positive values decrease the model's likelihood to repeat the same line verbatim.
+      """)
   @minValue(-2.0)
   @maxValue(2.0)
   frequency_penalty?: float;
diff --git a/specs/signalwire-rest/fabric-api/ai-agent/models/ai/swaig/functions/data_map/main.tsp b/specs/signalwire-rest/fabric-api/ai-agent/models/ai/swaig/functions/data_map/main.tsp
index eedf0f6d2..2af12a440 100644
--- a/specs/signalwire-rest/fabric-api/ai-agent/models/ai/swaig/functions/data_map/main.tsp
+++ b/specs/signalwire-rest/fabric-api/ai-agent/models/ai/swaig/functions/data_map/main.tsp
@@ -8,12 +8,18 @@ using TypeSpec.OpenAPI;
 @oneOf
 @summary("DataMap union")
 union DataMap {
-  @doc("An object that defines the output of the SWAIG function.")
+  @doc("""
+      An object that defines the output of the SWAIG function.
+      """)
   Output,
 
-  @doc("An array of objects that define patterns and corresponding actions.")
+  @doc("""
+      An array of objects that define patterns and corresponding actions.
+      """)
   Expression,
 
-  @doc("An array of objects that define external API calls.")
+  @doc("""
+      An array of objects that define external API calls.
+      """)
   Webhook,
 }
diff --git a/specs/signalwire-rest/fabric-api/ai-agent/models/ai/swaig/functions/main.tsp b/specs/signalwire-rest/fabric-api/ai-agent/models/ai/swaig/functions/main.tsp
index fedb5ed67..f9bea5bf3 100644
--- a/specs/signalwire-rest/fabric-api/ai-agent/models/ai/swaig/functions/main.tsp
+++ b/specs/signalwire-rest/fabric-api/ai-agent/models/ai/swaig/functions/main.tsp
@@ -4,18 +4,26 @@ import "./parameters.tsp";
 
 @summary("functions")
 model SWAIGFunction {
-  @doc("A unique name for the function. For example, 'get_weather'.")
+  @doc("""
+      A unique name for the function. For example, 'get_weather'.
+      """)
   @example("get_weather")
   function: string;
 
-  @doc("A description of the context and purpose of the function, to explain to the agent when to use it.")
+  @doc("""
+      A description of the context and purpose of the function, to explain to the agent when to use it.
+      """)
   @example("Get the weather information")
   description: string;
 
-  @doc("A JSON object defining the input that should be passed to the function. The fields of this object are the following two parameters.")
+  @doc("""
+      A JSON object defining the input that should be passed to the function. The fields of this object are the following two parameters.
+      """)
   parameters?: FunctionParameters;
 
-  @doc("Whether the function is active. Default is `true`.")
+  @doc("""
+      Whether the function is active. Default is `true`.
+      """)
   active?: boolean;
 
   @doc("""
@@ -28,7 +36,9 @@ model SWAIGFunction {
     ...TypeSpec.Record<unknown>;
   };
 
-  @doc("Scoping token for meta_data. If not supplied, metadata will be scoped to function's `web_hook_url`. Default is set by SignalWire.")
+  @doc("""
+      Scoping token for meta_data. If not supplied, metadata will be scoped to function's `web_hook_url`. Default is set by SignalWire.
+      """)
   meta_data_token?: string;
 
   @doc("""
@@ -37,15 +47,21 @@ model SWAIGFunction {
     """)
   data_map?: DataMap;
 
-  @doc("Function-specific URL to send status callbacks and reports to. Takes precedence over a default setting. Authentication can also be set in the url in the format of `username:password@url.`")
+  @doc("""
+      Function-specific URL to send status callbacks and reports to. Takes precedence over a default setting. Authentication can also be set in the url in the format of `username:password@url.`
+      """)
   @example("username:password:https://statuscallback.com")
   web_hook_url?: string;
 
-  @doc("A file to play while the function is running. `wait_file_loops` can specify the amount of times that files should continuously play. Default is not set.")
+  @doc("""
+      A file to play while the function is running. `wait_file_loops` can specify the amount of times that files should continuously play. Default is not set.
+      """)
   @example("https://cdn.signalwire.com/default-music/welcome.mp3")
   wait_file?: url;
 
-  @doc("The number of times to loop playing the file. Default is not set.")
+  @doc("""
+      The number of times to loop playing the file. Default is not set.
+      """)
   @example(5)
   wait_file_loops?: integer | string;
 }
diff --git a/specs/signalwire-rest/fabric-api/ai-agent/models/ai/swaig/main.tsp b/specs/signalwire-rest/fabric-api/ai-agent/models/ai/swaig/main.tsp
index 7fbe52125..0c532ee7c 100644
--- a/specs/signalwire-rest/fabric-api/ai-agent/models/ai/swaig/main.tsp
+++ b/specs/signalwire-rest/fabric-api/ai-agent/models/ai/swaig/main.tsp
@@ -5,10 +5,14 @@ import "./functions";
 
 @summary("swaig")
 model SWAIG {
-  @doc("Default settings for all SWAIG functions. If `defaults` is not set, settings may be set in each function object. Default is not set.")
+  @doc("""
+      Default settings for all SWAIG functions. If `defaults` is not set, settings may be set in each function object. Default is not set.
+      """)
   defaults?: SWAIGDefaults;
 
-  @doc("Prebuilt functions the AI agent is able to call from this list of available native functions")
+  @doc("""
+      Prebuilt functions the AI agent is able to call from this list of available native functions
+      """)
   native_functions?: SWAIGNativeFunction[];
 
   @doc("""
diff --git a/specs/signalwire-rest/fabric-api/call-flows/addresses/main.tsp b/specs/signalwire-rest/fabric-api/call-flows/addresses/main.tsp
index 6e7fea224..406e43f5d 100644
--- a/specs/signalwire-rest/fabric-api/call-flows/addresses/main.tsp
+++ b/specs/signalwire-rest/fabric-api/call-flows/addresses/main.tsp
@@ -13,7 +13,15 @@ namespace FabricAPI.CallFlow.Addresses {
   @tag(CALL_FLOWS_TAG)
   interface CallFlowAddresses {
     @summary("List Call Flow Addresses")
-    @doc("This endpoint returns a list of addresses associated with a specific Call Flow.")
+    @doc("""
+      This endpoint returns a list of addresses associated with a specific Call Flow.
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     list(...CallFlowAddressPathID):
       | CallFlowAddressListResponse
       | StatusCode401
diff --git a/specs/signalwire-rest/fabric-api/call-flows/main.tsp b/specs/signalwire-rest/fabric-api/call-flows/main.tsp
index a7dc1dba0..5b88bb1d2 100644
--- a/specs/signalwire-rest/fabric-api/call-flows/main.tsp
+++ b/specs/signalwire-rest/fabric-api/call-flows/main.tsp
@@ -18,7 +18,15 @@ namespace FabricAPI.CallFlows {
   @friendlyName("Call Flows")
   interface CallFlows {
     @summary("List Call Flows")
-    @doc("A list of Call Flows")
+    @doc("""
+      A list of Call Flows
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     list():
       | CallFlowListResponse
       | StatusCode401
@@ -26,7 +34,15 @@ namespace FabricAPI.CallFlows {
       | StatusCode500;
 
     @summary("Get Call Flow")
-    @doc("Returns a Call Flow by ID")
+    @doc("""
+      Returns a Call Flow by ID
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     read(...CallFlowPathID):
       | {
           @statusCode statusCode: 200;
@@ -37,7 +53,15 @@ namespace FabricAPI.CallFlows {
       | StatusCode500;
 
     @summary("Create Call Flow")
-    @doc("Creates a Call Flow")
+    @doc("""
+      Creates a Call Flow
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @post
     create(@body request: CallFlowCreateRequest):
       | {
@@ -50,7 +74,15 @@ namespace FabricAPI.CallFlows {
       | StatusCode500;
 
     @summary("Update Call Flow")
-    @doc("Updates a Call Flow by ID")
+    @doc("""
+      Updates a Call Flow by ID
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @put
     update(...CallFlowPathID, @body request: CallFlowUpdateRequest):
       | {
@@ -63,7 +95,15 @@ namespace FabricAPI.CallFlows {
       | StatusCode500;
 
     @summary("Delete Call Flow")
-    @doc("Deletes a Call Flow by ID")
+    @doc("""
+      Deletes a Call Flow by ID
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @delete
     delete(...CallFlowPathID):
       | {
diff --git a/specs/signalwire-rest/fabric-api/call-flows/versions/main.tsp b/specs/signalwire-rest/fabric-api/call-flows/versions/main.tsp
index 28d13f8da..577596ce9 100644
--- a/specs/signalwire-rest/fabric-api/call-flows/versions/main.tsp
+++ b/specs/signalwire-rest/fabric-api/call-flows/versions/main.tsp
@@ -14,7 +14,15 @@ namespace FabricAPI.CallFlow.Versions {
   @tag(CALL_FLOWS_TAG)
   interface CallFlowVersions {
     @summary("List Call Flow Versions")
-    @doc("Returns a list of versions of a Call Flow.")
+    @doc("""
+      Returns a list of versions of a Call Flow.
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     list(...CallFlowVersionPathID):
       | CallFlowVersionListResponse
       | StatusCode401
@@ -22,7 +30,15 @@ namespace FabricAPI.CallFlow.Versions {
       | StatusCode500;
 
     @summary("Deploy a Call Flow Version")
-    @doc("Deploys a specific version of a Call Flow.")
+    @doc("""
+      Deploys a specific version of a Call Flow.
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @post
     deploy(
       ...CallFlowVersionPathID,
diff --git a/specs/signalwire-rest/fabric-api/conference-rooms/addresses/main.tsp b/specs/signalwire-rest/fabric-api/conference-rooms/addresses/main.tsp
index bcfac1928..5d6311891 100644
--- a/specs/signalwire-rest/fabric-api/conference-rooms/addresses/main.tsp
+++ b/specs/signalwire-rest/fabric-api/conference-rooms/addresses/main.tsp
@@ -13,7 +13,15 @@ namespace FabricAPI.ConferenceRoom.Addresses {
   @tag(CONFERENCE_ROOM_TAG)
   interface ConferenceRoomAddresses {
     @summary("List Conference Room Addresses")
-    @doc("This endpoint returns a list of addresses associated with a specific Conference Room.")
+    @doc("""
+      This endpoint returns a list of addresses associated with a specific Conference Room.
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     list(...ConferenceRoomAddressPathID):
       | ConferenceRoomAddressListResponse
       | StatusCode401
diff --git a/specs/signalwire-rest/fabric-api/conference-rooms/main.tsp b/specs/signalwire-rest/fabric-api/conference-rooms/main.tsp
index 96db39bea..dd8575bd4 100644
--- a/specs/signalwire-rest/fabric-api/conference-rooms/main.tsp
+++ b/specs/signalwire-rest/fabric-api/conference-rooms/main.tsp
@@ -17,7 +17,15 @@ namespace FabricAPI.ConferenceRooms {
   @friendlyName("Conference Rooms")
   interface ConferenceRooms {
     @summary("List Conference Rooms")
-    @doc("Returns a list of conference rooms.")
+    @doc("""
+      Returns a list of conference rooms.
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     list():
       | ConferenceRoomListResponse
       | StatusCode401
@@ -25,7 +33,15 @@ namespace FabricAPI.ConferenceRooms {
       | StatusCode500;
 
     @summary("Get Conference Room")
-    @doc("Returns a Conference Room by ID")
+    @doc("""
+      Returns a Conference Room by ID
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     read(...ConferenceRoomPathID):
       | {
           @statusCode statusCode: 200;
@@ -36,7 +52,15 @@ namespace FabricAPI.ConferenceRooms {
       | StatusCode500;
 
     @summary("Create Conference Room")
-    @doc("Creates a Conference Room")
+    @doc("""
+      Creates a Conference Room
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @post
     create(@body request: ConferenceRoomCreateRequest):
       | {
@@ -49,7 +73,15 @@ namespace FabricAPI.ConferenceRooms {
       | StatusCode500;
 
     @summary("Update Conference Room")
-    @doc("Updates a Conference Room by ID")
+    @doc("""
+      Updates a Conference Room by ID
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @put
     update(
       ...ConferenceRoomPathID,
@@ -65,7 +97,15 @@ namespace FabricAPI.ConferenceRooms {
       | StatusCode500;
 
     @summary("Delete Conference Room")
-    @doc("Deletes a Conference Room by ID")
+    @doc("""
+      Deletes a Conference Room by ID
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @delete
     delete(...ConferenceRoomPathID):
       | {
diff --git a/specs/signalwire-rest/fabric-api/cxml-applications/addresses/main.tsp b/specs/signalwire-rest/fabric-api/cxml-applications/addresses/main.tsp
index ff6422757..a1905c370 100644
--- a/specs/signalwire-rest/fabric-api/cxml-applications/addresses/main.tsp
+++ b/specs/signalwire-rest/fabric-api/cxml-applications/addresses/main.tsp
@@ -13,7 +13,15 @@ namespace FabricAPI.CxmlApplication.Addresses {
   @tag(CXML_APPLICATIONS_TAG)
   interface CxmlApplicationAddresses {
     @summary("List cXML Application Addresses")
-    @doc("This endpoint returns a list of addresses associated with a specific LaML Application.")
+    @doc("""
+      This endpoint returns a list of addresses associated with a specific LaML Application.
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     list(...CxmlApplicationAddressPathID):
       | CxmlApplicationAddressListResponse
       | StatusCode401
diff --git a/specs/signalwire-rest/fabric-api/cxml-applications/main.tsp b/specs/signalwire-rest/fabric-api/cxml-applications/main.tsp
index a78a7f2ba..6b5535651 100644
--- a/specs/signalwire-rest/fabric-api/cxml-applications/main.tsp
+++ b/specs/signalwire-rest/fabric-api/cxml-applications/main.tsp
@@ -17,7 +17,15 @@ namespace FabricAPI.CxmlApplications {
   @friendlyName("cXML Applications")
   interface CxmlApplications {
     @summary("List cXML Applications")
-    @doc("A list of cXML Applications")
+    @doc("""
+      A list of cXML Applications
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     list():
       | CxmlApplicationListResponse
       | StatusCode401
@@ -25,7 +33,15 @@ namespace FabricAPI.CxmlApplications {
       | StatusCode500;
 
     @summary("Get cXML Application")
-    @doc("Returns a cXML Application by ID")
+    @doc("""
+      Returns a cXML Application by ID
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     read(...CxmlApplicationPathID):
       | {
           @statusCode statusCode: 200;
@@ -36,7 +52,15 @@ namespace FabricAPI.CxmlApplications {
       | StatusCode500;
 
     @summary("Update cXML Application")
-    @doc("Updates a cXML Application by ID")
+    @doc("""
+      Updates a cXML Application by ID
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @put
     update(
       ...CxmlApplicationPathID,
@@ -52,7 +76,15 @@ namespace FabricAPI.CxmlApplications {
       | StatusCode500;
 
     @summary("Delete LAML Application")
-    @doc("Deletes a LAML Application by ID")
+    @doc("""
+      Deletes a LAML Application by ID
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @delete
     delete(...CxmlApplicationPathID):
       | {
diff --git a/specs/signalwire-rest/fabric-api/cxml-scripts/addresses/main.tsp b/specs/signalwire-rest/fabric-api/cxml-scripts/addresses/main.tsp
index fdfec7815..d877d1ff5 100644
--- a/specs/signalwire-rest/fabric-api/cxml-scripts/addresses/main.tsp
+++ b/specs/signalwire-rest/fabric-api/cxml-scripts/addresses/main.tsp
@@ -13,7 +13,15 @@ namespace FabricAPI.CXMLScript.Addresses {
   @tag(CXML_SCRIPTS_TAG)
   interface CXMLScriptAddresses {
     @summary("List cXML Script Addresses")
-    @doc("This endpoint returns a list of addresses associated with a specific cXML Script.")
+    @doc("""
+      This endpoint returns a list of addresses associated with a specific cXML Script.
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     list(...CXMLScriptAddressPathID):
       | CXMLScriptAddressListResponse
       | StatusCode401
diff --git a/specs/signalwire-rest/fabric-api/cxml-scripts/main.tsp b/specs/signalwire-rest/fabric-api/cxml-scripts/main.tsp
index 4c8ba64aa..b365d234e 100644
--- a/specs/signalwire-rest/fabric-api/cxml-scripts/main.tsp
+++ b/specs/signalwire-rest/fabric-api/cxml-scripts/main.tsp
@@ -18,7 +18,15 @@ namespace FabricAPI.CXMLScripts {
   @summary("CXML Scripts")
   interface CXMLScripts {
     @summary("List cXML Scripts")
-    @doc("A list of cXML Scripts")
+    @doc("""
+      A list of cXML Scripts
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     list():
       | CXMLScriptListResponse
       | StatusCode401
@@ -26,7 +34,15 @@ namespace FabricAPI.CXMLScripts {
       | StatusCode500;
 
     @summary("Get cXML Script")
-    @doc("Returns a cXML Script by ID")
+    @doc("""
+      Returns a cXML Script by ID
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     read(...CXMLScriptPathID):
       | {
           @statusCode statusCode: 200;
@@ -37,7 +53,15 @@ namespace FabricAPI.CXMLScripts {
       | StatusCode500;
 
     @summary("Create cXML Script")
-    @doc("Creates a cXML Script")
+    @doc("""
+      Creates a cXML Script
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @post
     create(@body request: CXMLScriptCreateRequest):
       | {
@@ -50,7 +74,15 @@ namespace FabricAPI.CXMLScripts {
       | StatusCode500;
 
     @summary("Update cXML Script")
-    @doc("Updates a cXML Script by ID")
+    @doc("""
+      Updates a cXML Script by ID
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @put
     update(...CXMLScriptPathID, @body request: CXMLScriptUpdateRequest):
       | {
@@ -63,7 +95,15 @@ namespace FabricAPI.CXMLScripts {
       | StatusCode500;
 
     @summary("Delete cXML Script")
-    @doc("Deletes a cXML Script by ID")
+    @doc("""
+      Deletes a cXML Script by ID
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @delete
     delete(...CXMLScriptPathID):
       | {
diff --git a/specs/signalwire-rest/fabric-api/cxml-webhooks/addresses/main.tsp b/specs/signalwire-rest/fabric-api/cxml-webhooks/addresses/main.tsp
index fd8e4ed58..edbd8b568 100644
--- a/specs/signalwire-rest/fabric-api/cxml-webhooks/addresses/main.tsp
+++ b/specs/signalwire-rest/fabric-api/cxml-webhooks/addresses/main.tsp
@@ -14,7 +14,15 @@ namespace FabricAPI.CXMLWebhook.Addresses {
   @friendlyName("cXML Webhooks")
   interface CXMLWebhookAddresses {
     @summary("List cXML Webhook Addresses")
-    @doc("This endpoint returns a list of addresses associated with a specific cXML Webhook.")
+    @doc("""
+      This endpoint returns a list of addresses associated with a specific cXML Webhook.
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     list(...CXMLWebhookIDPath):
       | CXMLWebhookAddressListResponse
       | StatusCode401
diff --git a/specs/signalwire-rest/fabric-api/cxml-webhooks/main.tsp b/specs/signalwire-rest/fabric-api/cxml-webhooks/main.tsp
index b8d63ae10..ff0da54f6 100644
--- a/specs/signalwire-rest/fabric-api/cxml-webhooks/main.tsp
+++ b/specs/signalwire-rest/fabric-api/cxml-webhooks/main.tsp
@@ -17,7 +17,15 @@ namespace FabricAPI.CXMLWebhooks {
   @friendlyName("cXML Webhooks")
   interface CXMLWebhooks {
     @summary("List cXML Webhooks")
-    @doc("A list of cXML Webhooks")
+    @doc("""
+      A list of cXML Webhooks
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     list():
       | CXMLWebhookListResponse
       | StatusCode401
@@ -25,7 +33,15 @@ namespace FabricAPI.CXMLWebhooks {
       | StatusCode500;
 
     @summary("Get cXML Webhook")
-    @doc("Returns an cXML Webhook by ID")
+    @doc("""
+      Returns an cXML Webhook by ID
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     read(...CXMLWebhookID):
       | {
           @statusCode statusCode: 200;
@@ -36,7 +52,15 @@ namespace FabricAPI.CXMLWebhooks {
       | StatusCode500;
 
     @summary("Create cXML Webhook")
-    @doc("Creates an cXML Webhook")
+    @doc("""
+      Creates an cXML Webhook
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @post
     create(...CXMLWebhookCreateRequest):
       | {
@@ -49,7 +73,15 @@ namespace FabricAPI.CXMLWebhooks {
       | StatusCode500;
 
     @summary("Update cXML Webhook")
-    @doc("Updates an cXML Webhook by ID")
+    @doc("""
+      Updates an cXML Webhook by ID
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @patch(#{ implicitOptionality: true })
     update(...CXMLWebhookID, ...CXMLWebhookUpdateRequest):
       | {
@@ -62,7 +94,15 @@ namespace FabricAPI.CXMLWebhooks {
       | StatusCode500;
 
     @summary("Delete cXML Webhook")
-    @doc("Deletes an cXML Webhook by ID")
+    @doc("""
+      Deletes an cXML Webhook by ID
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @delete
     delete(...CXMLWebhookID):
       | {
diff --git a/specs/signalwire-rest/fabric-api/dialogflow-agents/addresses/main.tsp b/specs/signalwire-rest/fabric-api/dialogflow-agents/addresses/main.tsp
index 6808bc093..593668af8 100644
--- a/specs/signalwire-rest/fabric-api/dialogflow-agents/addresses/main.tsp
+++ b/specs/signalwire-rest/fabric-api/dialogflow-agents/addresses/main.tsp
@@ -13,7 +13,15 @@ namespace FabricAPI.DialogflowAgent.Addresses {
   @tag(AI_DIALOGFLOW_TAG)
   interface DialogflowAgentAddresses {
     @summary("List Dialogflow Agent Addresses")
-    @doc("This endpoint returns a list of addresses associated with a specific Dialogflow Agent.")
+    @doc("""
+      This endpoint returns a list of addresses associated with a specific Dialogflow Agent.
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     list(...DialogflowAgentAddressPathID):
       | DialogflowAgentAddressListResponse
       | StatusCode401
diff --git a/specs/signalwire-rest/fabric-api/dialogflow-agents/main.tsp b/specs/signalwire-rest/fabric-api/dialogflow-agents/main.tsp
index afd3568e6..2fceafdc2 100644
--- a/specs/signalwire-rest/fabric-api/dialogflow-agents/main.tsp
+++ b/specs/signalwire-rest/fabric-api/dialogflow-agents/main.tsp
@@ -16,7 +16,15 @@ namespace FabricAPI.DialogflowAgents {
   @tag(AI_DIALOGFLOW_TAG)
   interface DialogflowAgents {
     @summary("List Dialogflow Agents")
-    @doc("A list of Dialogflow Agents")
+    @doc("""
+      A list of Dialogflow Agents
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     list():
       | DialogflowAgentListResponse
       | StatusCode401
@@ -24,7 +32,15 @@ namespace FabricAPI.DialogflowAgents {
       | StatusCode500;
 
     @summary("Get Dialogflow Agent")
-    @doc("Returns a Dialogflow Agent by ID")
+    @doc("""
+      Returns a Dialogflow Agent by ID
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     read(...DialogflowAgentPathID):
       | {
           @statusCode statusCode: 200;
@@ -35,7 +51,15 @@ namespace FabricAPI.DialogflowAgents {
       | StatusCode500;
 
     @summary("Update Dialogflow Agent")
-    @doc("Updates a Dialogflow Agent by ID")
+    @doc("""
+      Updates a Dialogflow Agent by ID
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @put
     update(
       ...DialogflowAgentPathID,
@@ -51,7 +75,15 @@ namespace FabricAPI.DialogflowAgents {
       | StatusCode500;
 
     @summary("Delete Dialogflow Agent")
-    @doc("Deletes a Dialogflow Agent by ID")
+    @doc("""
+      Deletes a Dialogflow Agent by ID
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @delete
     delete(...DialogflowAgentPathID):
       | {
diff --git a/specs/signalwire-rest/fabric-api/domain-applications/main.tsp b/specs/signalwire-rest/fabric-api/domain-applications/main.tsp
index 5e0884d64..80bc0cd1a 100644
--- a/specs/signalwire-rest/fabric-api/domain-applications/main.tsp
+++ b/specs/signalwire-rest/fabric-api/domain-applications/main.tsp
@@ -20,6 +20,13 @@ namespace FabricAPI.DomainApplications {
       :::important
       Currently only supports `calling` as a handler and automatically defaults to it.
       :::
+      
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       """)
     @post
     assign(
diff --git a/specs/signalwire-rest/fabric-api/embeds-tokens/main.tsp b/specs/signalwire-rest/fabric-api/embeds-tokens/main.tsp
index 3285cc61f..9994f3577 100644
--- a/specs/signalwire-rest/fabric-api/embeds-tokens/main.tsp
+++ b/specs/signalwire-rest/fabric-api/embeds-tokens/main.tsp
@@ -19,7 +19,15 @@ namespace FabricAPI.EmbedsTokens {
   @friendlyName("Embeds Tokens")
   interface EmbedsTokens {
     @summary("Create Embeds Tokens")
-    @doc("Exchanges a public Click-to-Call (C2C) token for a short-lived, private embed guest token used to authorize a call. This allows secure activation of the C2C widget without exposing sensitive credentials.")
+    @doc("""
+      Exchanges a public Click-to-Call (C2C) token for a short-lived, private embed guest token used to authorize a call. This allows secure activation of the C2C widget without exposing sensitive credentials.
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @post
     create(@body body: EmbedsTokensRequest):
       | {
diff --git a/specs/signalwire-rest/fabric-api/freeswitch-connectors/addresses/main.tsp b/specs/signalwire-rest/fabric-api/freeswitch-connectors/addresses/main.tsp
index f21603331..e8dbf90ce 100644
--- a/specs/signalwire-rest/fabric-api/freeswitch-connectors/addresses/main.tsp
+++ b/specs/signalwire-rest/fabric-api/freeswitch-connectors/addresses/main.tsp
@@ -13,7 +13,15 @@ namespace FabricAPI.FreeswitchConnectorAddresses {
   @tag(FREESWITCH_CONNECTOR_TAG)
   interface FreeswitchConnectorAddresses {
     @summary("List FreeSWITCH Connector Addresses")
-    @doc("This endpoint returns a list of addresses associated with a specific FreeSWITCH Connector.")
+    @doc("""
+      This endpoint returns a list of addresses associated with a specific FreeSWITCH Connector.
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     list(...FreeswitchConnectorAddressPathID):
       | FreeswitchConnectorAddressListResponse
       | StatusCode401
diff --git a/specs/signalwire-rest/fabric-api/freeswitch-connectors/main.tsp b/specs/signalwire-rest/fabric-api/freeswitch-connectors/main.tsp
index f2933eecd..28e6df543 100644
--- a/specs/signalwire-rest/fabric-api/freeswitch-connectors/main.tsp
+++ b/specs/signalwire-rest/fabric-api/freeswitch-connectors/main.tsp
@@ -17,7 +17,15 @@ namespace FabricAPI.FreeswitchConnectors {
   @friendlyName("FreeSWITCH Connectors")
   interface FreeswitchConnectors {
     @summary("List FreeSWITCH Connectors")
-    @doc("A list of FreeSWITCH Connectors")
+    @doc("""
+      A list of FreeSWITCH Connectors
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     list():
       | FreeswitchConnectorListResponse
       | StatusCode401
@@ -25,7 +33,15 @@ namespace FabricAPI.FreeswitchConnectors {
       | StatusCode500;
 
     @summary("Get FreeSWITCH Connector")
-    @doc("Returns a FreeSWITCH Connector by ID")
+    @doc("""
+      Returns a FreeSWITCH Connector by ID
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     read(...FreeswitchConnectorPathID):
       | {
           @statusCode statusCode: 200;
@@ -36,7 +52,15 @@ namespace FabricAPI.FreeswitchConnectors {
       | StatusCode500;
 
     @summary("Create FreeSWITCH Connector")
-    @doc("Creates a FreeSWITCH Connector")
+    @doc("""
+      Creates a FreeSWITCH Connector
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @post
     create(@body request: FreeswitchConnectorCreateRequest):
       | {
@@ -49,7 +73,15 @@ namespace FabricAPI.FreeswitchConnectors {
       | StatusCode500;
 
     @summary("Update FreeSWITCH Connector")
-    @doc("Updates a FreeSWITCH Connector by ID")
+    @doc("""
+      Updates a FreeSWITCH Connector by ID
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @put
     update(
       ...FreeswitchConnectorPathID,
@@ -65,7 +97,15 @@ namespace FabricAPI.FreeswitchConnectors {
       | StatusCode500;
 
     @summary("Delete FreeSWITCH Connector")
-    @doc("Deletes a FreeSWITCH Connector by ID")
+    @doc("""
+      Deletes a FreeSWITCH Connector by ID
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @delete
     delete(...FreeswitchConnectorPathID):
       | {
diff --git a/specs/signalwire-rest/fabric-api/main.tsp b/specs/signalwire-rest/fabric-api/main.tsp
index 8389886a8..2f8bac8af 100644
--- a/specs/signalwire-rest/fabric-api/main.tsp
+++ b/specs/signalwire-rest/fabric-api/main.tsp
@@ -69,5 +69,13 @@ using TypeSpec.OpenAPI;
   }
 )
 @useAuth(BasicAuth)
-@doc("API to access/manage SignalWire's Call Fabric objects.")
+@doc("""
+      API to access/manage SignalWire's Call Fabric objects.
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
 namespace FabricAPI;
diff --git a/specs/signalwire-rest/fabric-api/phone-routes/main.tsp b/specs/signalwire-rest/fabric-api/phone-routes/main.tsp
index 599f480ea..bb3cc8fa3 100644
--- a/specs/signalwire-rest/fabric-api/phone-routes/main.tsp
+++ b/specs/signalwire-rest/fabric-api/phone-routes/main.tsp
@@ -18,6 +18,13 @@ namespace FabricAPI.PhoneRoutes {
     @summary("Assign a Resource to a Phone Route")
     @doc("""
       This endpoint assigns a specific resource to a phone route, allowing inbound calls & messages to be handled by the resource.
+      
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       """)
     @post
     assign(...PhoneRoutePathID, @body request: PhoneRouteAssignRequest):
diff --git a/specs/signalwire-rest/fabric-api/relay-applications/addresses/main.tsp b/specs/signalwire-rest/fabric-api/relay-applications/addresses/main.tsp
index ae045c0a3..a425b7784 100644
--- a/specs/signalwire-rest/fabric-api/relay-applications/addresses/main.tsp
+++ b/specs/signalwire-rest/fabric-api/relay-applications/addresses/main.tsp
@@ -13,7 +13,15 @@ namespace FabricAPI.RelayApplication.Addresses {
   @tag(RELAY_APPLICATION_TAG)
   interface RelayApplicationAddresses {
     @summary("List Relay Application Addresses")
-    @doc("This endpoint returns a paginated list of addresses associated with a Relay Application.")
+    @doc("""
+      This endpoint returns a paginated list of addresses associated with a Relay Application.
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     list(...RelayApplicationAddressPathID):
       | RelayApplicationAddressListResponse
       | StatusCode401
diff --git a/specs/signalwire-rest/fabric-api/relay-applications/main.tsp b/specs/signalwire-rest/fabric-api/relay-applications/main.tsp
index a4bb864a8..65ea300a2 100644
--- a/specs/signalwire-rest/fabric-api/relay-applications/main.tsp
+++ b/specs/signalwire-rest/fabric-api/relay-applications/main.tsp
@@ -17,7 +17,15 @@ namespace FabricAPI.RelayApplications {
   @friendlyName("Relay Applications")
   interface RelayApplications {
     @summary("List Relay Applications")
-    @doc("A list of Relay Applications")
+    @doc("""
+      A list of Relay Applications
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     list():
       | RelayApplicationListResponse
       | StatusCode401
@@ -25,7 +33,15 @@ namespace FabricAPI.RelayApplications {
       | StatusCode500;
 
     @summary("Get Relay Application")
-    @doc("Returns a Relay Application by ID")
+    @doc("""
+      Returns a Relay Application by ID
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     read(...RelayApplicationPathID):
       | {
           @statusCode statusCode: 200;
@@ -36,7 +52,15 @@ namespace FabricAPI.RelayApplications {
       | StatusCode500;
 
     @summary("Create Relay Application")
-    @doc("Creates a Relay Application")
+    @doc("""
+      Creates a Relay Application
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @post
     create(@body request: RelayApplicationCreateRequest):
       | {
@@ -49,7 +73,15 @@ namespace FabricAPI.RelayApplications {
       | StatusCode500;
 
     @summary("Update Relay Application")
-    @doc("Updates a Relay Application by ID")
+    @doc("""
+      Updates a Relay Application by ID
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @put
     update(
       ...RelayApplicationPathID,
@@ -65,7 +97,15 @@ namespace FabricAPI.RelayApplications {
       | StatusCode500;
 
     @summary("Delete Relay Application")
-    @doc("Deletes a Relay Application by ID")
+    @doc("""
+      Deletes a Relay Application by ID
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @delete
     delete(...RelayApplicationPathID):
       | {
diff --git a/specs/signalwire-rest/fabric-api/resources/addresses/main.tsp b/specs/signalwire-rest/fabric-api/resources/addresses/main.tsp
index 914e7603d..699289463 100644
--- a/specs/signalwire-rest/fabric-api/resources/addresses/main.tsp
+++ b/specs/signalwire-rest/fabric-api/resources/addresses/main.tsp
@@ -13,7 +13,15 @@ namespace FabricAPI.Resource.Addresses {
   @tag(RESOURCES_TAG)
   interface ResourceAddresses {
     @summary("List Resource Addresses")
-    @doc("This endpoint is used to retrieve addresses associated with a specific Resource.")
+    @doc("""
+      This endpoint is used to retrieve addresses associated with a specific Resource.
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     list(...ResourceAddressPathID):
       | ResourceAddressListResponse
       | StatusCode401
diff --git a/specs/signalwire-rest/fabric-api/resources/main.tsp b/specs/signalwire-rest/fabric-api/resources/main.tsp
index f30332ab8..7827d5b30 100644
--- a/specs/signalwire-rest/fabric-api/resources/main.tsp
+++ b/specs/signalwire-rest/fabric-api/resources/main.tsp
@@ -17,7 +17,15 @@ namespace FabricAPI.Resources {
   @friendlyName("Resources")
   interface Resources {
     @summary("List Resources")
-    @doc("A list of Fabric Resources")
+    @doc("""
+      A list of Fabric Resources
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     list():
       | ResourceListResponse
       | StatusCode401
@@ -25,7 +33,15 @@ namespace FabricAPI.Resources {
       | StatusCode500;
 
     @summary("Get Resource")
-    @doc("Returns a Resource by ID")
+    @doc("""
+      Returns a Resource by ID
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     read(...ResourcePathID):
       | {
           @statusCode statusCode: 200;
@@ -36,7 +52,15 @@ namespace FabricAPI.Resources {
       | StatusCode500;
 
     @summary("Delete Resource")
-    @doc("Deletes a Resource by ID")
+    @doc("""
+      Deletes a Resource by ID
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @delete
     delete(...ResourcePathID):
       | {
diff --git a/specs/signalwire-rest/fabric-api/sip-endpoints/addresses/main.tsp b/specs/signalwire-rest/fabric-api/sip-endpoints/addresses/main.tsp
index 698635e8a..fd0fae003 100644
--- a/specs/signalwire-rest/fabric-api/sip-endpoints/addresses/main.tsp
+++ b/specs/signalwire-rest/fabric-api/sip-endpoints/addresses/main.tsp
@@ -13,7 +13,15 @@ namespace FabricAPI.SipEndpoint.Addresses {
   @tag(SIP_ENDPOINTS_TAG)
   interface SipEndpointAddresses {
     @summary("List SIP Endpoint Addresses")
-    @doc("A list of SIP Endpoint Addresses.")
+    @doc("""
+      A list of SIP Endpoint Addresses.
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     list(...SipEndpointAddressPathID):
       | SipEndpointAddressListResponse
       | StatusCode401
diff --git a/specs/signalwire-rest/fabric-api/sip-endpoints/main.tsp b/specs/signalwire-rest/fabric-api/sip-endpoints/main.tsp
index 803110e3a..16c467be8 100644
--- a/specs/signalwire-rest/fabric-api/sip-endpoints/main.tsp
+++ b/specs/signalwire-rest/fabric-api/sip-endpoints/main.tsp
@@ -16,10 +16,26 @@ using Types.StatusCodes;
 namespace FabricAPI.SipEndpoints {
   @tag(SIP_ENDPOINTS_TAG)
   @friendlyName("SIP Endpoints")
-  @doc("SIP Endpoints API category.")
+  @doc("""
+      SIP Endpoints API category.
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
   interface SipEndpoints {
     @summary("List SIP Endpoints")
-    @doc("A list of SIP Endpoints")
+    @doc("""
+      A list of SIP Endpoints
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     list():
       | SipEndpointListResponse[]
       | StatusCode401
@@ -27,7 +43,15 @@ namespace FabricAPI.SipEndpoints {
       | StatusCode500;
 
     @summary("Get SIP Endpoint")
-    @doc("Returns a SIP Endpoint by ID")
+    @doc("""
+      Returns a SIP Endpoint by ID
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     read(...SipEndpointPathID):
       | {
           @statusCode statusCode: 200;
@@ -38,7 +62,15 @@ namespace FabricAPI.SipEndpoints {
       | StatusCode500;
 
     @summary("Create SIP Endpoint")
-    @doc("Creates a SIP Endpoint")
+    @doc("""
+      Creates a SIP Endpoint
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @post
     create(@body request: SipEndpointCreateRequest):
       | {
@@ -51,7 +83,15 @@ namespace FabricAPI.SipEndpoints {
       | StatusCode500;
 
     @summary("Update SIP Endpoint")
-    @doc("Updates a SIP Endpoint by ID")
+    @doc("""
+      Updates a SIP Endpoint by ID
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @put
     update(...SipEndpointPathID, @body request: SipEndpointUpdateRequest):
       | {
@@ -64,7 +104,15 @@ namespace FabricAPI.SipEndpoints {
       | StatusCode500;
 
     @summary("Delete SIP Endpoint")
-    @doc("Deletes a SIP Endpoint by ID")
+    @doc("""
+      Deletes a SIP Endpoint by ID
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @delete
     delete(...SipEndpointPathID):
       | {
diff --git a/specs/signalwire-rest/fabric-api/sip-endpoints/resource/main.tsp b/specs/signalwire-rest/fabric-api/sip-endpoints/resource/main.tsp
index 5f4685136..5c3801a4d 100644
--- a/specs/signalwire-rest/fabric-api/sip-endpoints/resource/main.tsp
+++ b/specs/signalwire-rest/fabric-api/sip-endpoints/resource/main.tsp
@@ -20,6 +20,13 @@ namespace FabricAPI.SipEndpoints.Resource {
       :::important
       Currently only supports `calling` as a handler and automatically defaults to it.
       :::
+      
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       """)
     @post
     assign(
diff --git a/specs/signalwire-rest/fabric-api/sip_gateways/addresses/main.tsp b/specs/signalwire-rest/fabric-api/sip_gateways/addresses/main.tsp
index 6d19b8a27..2d996292d 100644
--- a/specs/signalwire-rest/fabric-api/sip_gateways/addresses/main.tsp
+++ b/specs/signalwire-rest/fabric-api/sip_gateways/addresses/main.tsp
@@ -14,7 +14,15 @@ namespace FabricAPI.SipGateways.Addresses {
   @friendlyName("SIP Gateway")
   interface RelayApplicationAddresses {
     @summary("List Fabric Addresses assigned to a SIP Gateway")
-    @doc("Returns a paginated list of Fabric Addresses associated with the specified SIP Gateway.")
+    @doc("""
+      Returns a paginated list of Fabric Addresses associated with the specified SIP Gateway.
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     readAddressesByResourceId(...SipGatewayAddressRequest):
       | SipGatewayAddressListResponse
       | StatusCode401
diff --git a/specs/signalwire-rest/fabric-api/sip_gateways/main.tsp b/specs/signalwire-rest/fabric-api/sip_gateways/main.tsp
index d926b6b10..9e4bd2b9e 100644
--- a/specs/signalwire-rest/fabric-api/sip_gateways/main.tsp
+++ b/specs/signalwire-rest/fabric-api/sip_gateways/main.tsp
@@ -16,7 +16,15 @@ namespace FabricAPI.SipGateways {
   @friendlyName("SIP Gateway")
   interface SipGateways {
     @summary("List SIP Gateways")
-    @doc("Returns a paginated list of SIP Gateways for the authenticated project.")
+    @doc("""
+      Returns a paginated list of SIP Gateways for the authenticated project.
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     list():
       | SipGatewayListResponse
       | StatusCode401
@@ -24,7 +32,15 @@ namespace FabricAPI.SipGateways {
       | StatusCode500;
 
     @summary("Get SIP Gateway")
-    @doc("Returns an SIP Gateway by ID")
+    @doc("""
+      Returns an SIP Gateway by ID
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     read(...SipGatewayID):
       | {
           @statusCode statusCode: 200;
@@ -35,7 +51,15 @@ namespace FabricAPI.SipGateways {
       | StatusCode500;
 
     @summary("Create SIP Gateway")
-    @doc("Creates a SIP Gateway that can be used to dial external SIP entities.")
+    @doc("""
+      Creates a SIP Gateway that can be used to dial external SIP entities.
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @post
     create(...SipGatewayRequest):
       | {
@@ -48,7 +72,15 @@ namespace FabricAPI.SipGateways {
       | StatusCode500;
 
     @summary("Update SIP Gateway")
-    @doc("Updates a SIP Gateway by ID")
+    @doc("""
+      Updates a SIP Gateway by ID
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @patch(#{ implicitOptionality: true })
     update(...SipGatewayID, ...SipGatewayRequest):
       | {
@@ -61,7 +93,15 @@ namespace FabricAPI.SipGateways {
       | StatusCode500;
 
     @summary("Delete SIP Gateway")
-    @doc("Deletes a SIP Gateway} by ID")
+    @doc("""
+      Deletes a SIP Gateway} by ID
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @delete
     delete(...SipGatewayID):
       | {
diff --git a/specs/signalwire-rest/fabric-api/subscribers/guest-tokens/main.tsp b/specs/signalwire-rest/fabric-api/subscribers/guest-tokens/main.tsp
index 4f7bd6f9c..ded932e54 100644
--- a/specs/signalwire-rest/fabric-api/subscribers/guest-tokens/main.tsp
+++ b/specs/signalwire-rest/fabric-api/subscribers/guest-tokens/main.tsp
@@ -14,7 +14,15 @@ namespace FabricAPI.SubscriberGuestTokens {
   @friendlyName("Guest Token")
   interface GuestTokens {
     @summary("Create Subscriber Guest Token")
-    @doc("Creates a Subscriber Guest Token. The token is authorized using an existing API token.")
+    @doc("""
+      Creates a Subscriber Guest Token. The token is authorized using an existing API token.
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @post
     create(...SubscriberGuestTokenCreateRequest):
       | {
diff --git a/specs/signalwire-rest/fabric-api/subscribers/invite-tokens/main.tsp b/specs/signalwire-rest/fabric-api/subscribers/invite-tokens/main.tsp
index 1587192c6..cf0a9ae28 100644
--- a/specs/signalwire-rest/fabric-api/subscribers/invite-tokens/main.tsp
+++ b/specs/signalwire-rest/fabric-api/subscribers/invite-tokens/main.tsp
@@ -14,7 +14,15 @@ namespace FabricAPI.SubscriberInviteTokens {
   @friendlyName("Invite Token")
   interface InviteTokens {
     @summary("Create a Subscriber Invite Token")
-    @doc("Creates a Subscriber Invite Token to be used for client-side API calls. The token is authorized using a subscriber's SAT (Subscriber Access Token)")
+    @doc("""
+      Creates a Subscriber Invite Token to be used for client-side API calls. The token is authorized using a subscriber's SAT (Subscriber Access Token)
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @post
     create(...SubscriberInviteTokenCreateRequest):
       | {
diff --git a/specs/signalwire-rest/fabric-api/subscribers/main.tsp b/specs/signalwire-rest/fabric-api/subscribers/main.tsp
index 580ab6e33..2e8d2128b 100644
--- a/specs/signalwire-rest/fabric-api/subscribers/main.tsp
+++ b/specs/signalwire-rest/fabric-api/subscribers/main.tsp
@@ -22,7 +22,15 @@ namespace FabricAPI.Subscribers {
   @friendlyName("Subscribers")
   interface Subscribers {
     @summary("List Subscribers")
-    @doc("Retrieve a list of all subscribers")
+    @doc("""
+      Retrieve a list of all subscribers
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     list():
       | SubscriberListResponse
       | StatusCode401
@@ -30,7 +38,15 @@ namespace FabricAPI.Subscribers {
       | StatusCode500;
 
     @summary("Create Subscriber")
-    @doc("Create a new Subscriber")
+    @doc("""
+      Create a new Subscriber
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @post
     create(@body body: SubscriberRequest):
       | {
@@ -43,7 +59,15 @@ namespace FabricAPI.Subscribers {
       | StatusCode500;
 
     @summary("Get Subscriber")
-    @doc("Fetch an existing Subscriber")
+    @doc("""
+      Fetch an existing Subscriber
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     get(...SubscriberPathID):
       | {
           @statusCode statusCode: 200;
@@ -54,7 +78,15 @@ namespace FabricAPI.Subscribers {
       | StatusCode500;
 
     @summary("Update Subscriber")
-    @doc("Update an existing Subsriber")
+    @doc("""
+      Update an existing Subsriber
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @put
     update(...SubscriberPathID, ...SubscriberRequest):
       | {
@@ -67,7 +99,15 @@ namespace FabricAPI.Subscribers {
       | StatusCode500;
 
     @summary("Delete Subscriber")
-    @doc("Delete an existing Subscriber")
+    @doc("""
+      Delete an existing Subscriber
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @delete
     delete(...SubscriberPathID):
       | {
diff --git a/specs/signalwire-rest/fabric-api/subscribers/refresh-tokens/main.tsp b/specs/signalwire-rest/fabric-api/subscribers/refresh-tokens/main.tsp
index a20f2fa51..d747a2213 100644
--- a/specs/signalwire-rest/fabric-api/subscribers/refresh-tokens/main.tsp
+++ b/specs/signalwire-rest/fabric-api/subscribers/refresh-tokens/main.tsp
@@ -14,7 +14,15 @@ namespace FabricAPI.SubscriberRefreshTokens {
   @friendlyName("Refresh Token")
   interface RefreshTokens {
     @summary("Exchange a refresh token for a new subscriber access token")
-    @doc("Exchanges a valid refresh token for a new subscriber access token and a new refresh token. The new access token is valid for 2 hours, and the new refresh token is valid for 2 hours and 5 minutes.")
+    @doc("""
+      Exchanges a valid refresh token for a new subscriber access token and a new refresh token. The new access token is valid for 2 hours, and the new refresh token is valid for 2 hours and 5 minutes.
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @post
     create(...SubscriberRefreshTokenRequest):
       | {
diff --git a/specs/signalwire-rest/fabric-api/subscribers/subscriber-addresses/main.tsp b/specs/signalwire-rest/fabric-api/subscribers/subscriber-addresses/main.tsp
index c8580d55f..17cd950da 100644
--- a/specs/signalwire-rest/fabric-api/subscribers/subscriber-addresses/main.tsp
+++ b/specs/signalwire-rest/fabric-api/subscribers/subscriber-addresses/main.tsp
@@ -14,7 +14,15 @@ namespace FabricAPI.Subscribers.Addresses {
   @summary("Subscriber Addresses")
   interface SubscriberAddresses {
     @summary("List Subscriber Addresses")
-    @doc("List Subscriber Addresses")
+    @doc("""
+      List Subscriber Addresses
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     list(...SubscriberAddressID):
       | SubscriberAddressesResponse[]
       | StatusCode401
diff --git a/specs/signalwire-rest/fabric-api/subscribers/subscriber-sip-endpoint/main.tsp b/specs/signalwire-rest/fabric-api/subscribers/subscriber-sip-endpoint/main.tsp
index 49f5f3a59..4ab855051 100644
--- a/specs/signalwire-rest/fabric-api/subscribers/subscriber-sip-endpoint/main.tsp
+++ b/specs/signalwire-rest/fabric-api/subscribers/subscriber-sip-endpoint/main.tsp
@@ -16,7 +16,15 @@ namespace FabricAPI.Subscribers.SipEndpoints {
   @friendlyName("SIP Endpoints")
   interface SubscriberSipEndpoint {
     @summary("List Subscriber SIP Endpoints")
-    @doc("A list of Sip Endpoints of the Subscriber")
+    @doc("""
+      A list of Sip Endpoints of the Subscriber
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     list(...FabricSubscriberID):
       | SubscriberSipEndpointListResponse
       | StatusCode401
@@ -24,7 +32,15 @@ namespace FabricAPI.Subscribers.SipEndpoints {
       | StatusCode500;
 
     @summary("Get Subscriber SIP Endpoint")
-    @doc("Returns a Subscriber Sip Endpoint by ID")
+    @doc("""
+      Returns a Subscriber Sip Endpoint by ID
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     read(...SIPEndpointID, ...FabricSubscriberID):
       | {
           @statusCode statusCode: 200;
@@ -35,7 +51,15 @@ namespace FabricAPI.Subscribers.SipEndpoints {
       | StatusCode500;
 
     @summary("Create Subscriber SIP Endpoint")
-    @doc("Creates a Subscriber Sip Endpoint")
+    @doc("""
+      Creates a Subscriber Sip Endpoint
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @post
     create(...FabricSubscriberID, @body body: SubscriberSipEndpointRequest):
       | {
@@ -48,7 +72,15 @@ namespace FabricAPI.Subscribers.SipEndpoints {
       | StatusCode500;
 
     @summary("Update Subscriber SIP Endpoint")
-    @doc("Updates a Subscriber Sip Endpoint by ID")
+    @doc("""
+      Updates a Subscriber Sip Endpoint by ID
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @patch(#{ implicitOptionality: true })
     update(
       ...SIPEndpointID,
@@ -65,7 +97,15 @@ namespace FabricAPI.Subscribers.SipEndpoints {
       | StatusCode500;
 
     @summary("Delete Subscriber SIP Endpoint")
-    @doc("Deletes a Subscriber Sip Endpoint by ID")
+    @doc("""
+      Deletes a Subscriber Sip Endpoint by ID
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @delete
     delete(...SIPEndpointID, ...FabricSubscriberID):
       | {
diff --git a/specs/signalwire-rest/fabric-api/subscribers/subscriber-tokens/main.tsp b/specs/signalwire-rest/fabric-api/subscribers/subscriber-tokens/main.tsp
index acd8b1b6a..a8160ef75 100644
--- a/specs/signalwire-rest/fabric-api/subscribers/subscriber-tokens/main.tsp
+++ b/specs/signalwire-rest/fabric-api/subscribers/subscriber-tokens/main.tsp
@@ -14,7 +14,15 @@ namespace FabricAPI.SubscriberTokens {
   @tag(SUBSCRIBERS_TAG)
   interface SubscriberTokens {
     @summary("Create Subscriber Token")
-    @doc("Create a Subscriber Token")
+    @doc("""
+      Create a Subscriber Token
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     create(...SubscriberTokenRequest):
       | SubscriberTokenResponse
       | StatusCode401
diff --git a/specs/signalwire-rest/fabric-api/swml-scripts/addresses/main.tsp b/specs/signalwire-rest/fabric-api/swml-scripts/addresses/main.tsp
index acd26a3e9..5a0ccdeb4 100644
--- a/specs/signalwire-rest/fabric-api/swml-scripts/addresses/main.tsp
+++ b/specs/signalwire-rest/fabric-api/swml-scripts/addresses/main.tsp
@@ -13,7 +13,15 @@ namespace FabricAPI.SWMLScript.Addresses {
   @tag(SWML_SCRIPTS_TAG)
   interface SWMLScriptAddresses {
     @summary("List SWML Script Addresses")
-    @doc("This endpoints returns a list of addresses associated with a specific SWML script.")
+    @doc("""
+      This endpoints returns a list of addresses associated with a specific SWML script.
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     list(...SWMLScriptAddressPathID):
       | SWMLScriptAddressListResponse
       | StatusCode401
diff --git a/specs/signalwire-rest/fabric-api/swml-scripts/main.tsp b/specs/signalwire-rest/fabric-api/swml-scripts/main.tsp
index 0f47027af..d4789d21f 100644
--- a/specs/signalwire-rest/fabric-api/swml-scripts/main.tsp
+++ b/specs/signalwire-rest/fabric-api/swml-scripts/main.tsp
@@ -17,7 +17,15 @@ namespace FabricAPI.SwmlScripts {
   @friendlyName("SWML Scripts")
   interface SwmlScripts {
     @summary("List SWML Scripts")
-    @doc("A list of SWML Scripts")
+    @doc("""
+      A list of SWML Scripts
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     list():
       | SwmlScriptListResponse[]
       | StatusCode401
@@ -25,7 +33,15 @@ namespace FabricAPI.SwmlScripts {
       | StatusCode500;
 
     @summary("Get SWML Script")
-    @doc("Returns a SWML Script by ID")
+    @doc("""
+      Returns a SWML Script by ID
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     read(...SwmlScriptPathID):
       | {
           @statusCode statusCode: 200;
@@ -36,7 +52,15 @@ namespace FabricAPI.SwmlScripts {
       | StatusCode500;
 
     @summary("Create SWML Script")
-    @doc("Creates a SWML Script")
+    @doc("""
+      Creates a SWML Script
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @post
     create(@body request: SwmlScriptCreateRequest):
       | {
@@ -49,7 +73,15 @@ namespace FabricAPI.SwmlScripts {
       | StatusCode500;
 
     @summary("Update SWML Script")
-    @doc("Updates a SWML Script by ID")
+    @doc("""
+      Updates a SWML Script by ID
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @put
     update(...SwmlScriptPathID, @body request: SwmlScriptUpdateRequest):
       | {
@@ -62,7 +94,15 @@ namespace FabricAPI.SwmlScripts {
       | StatusCode500;
 
     @summary("Delete SWML Script")
-    @doc("Deletes a SWML Script by ID")
+    @doc("""
+      Deletes a SWML Script by ID
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @delete
     delete(...SwmlScriptPathID):
       | {
diff --git a/specs/signalwire-rest/fabric-api/swml-webhook/addresses/main.tsp b/specs/signalwire-rest/fabric-api/swml-webhook/addresses/main.tsp
index 3cc8d2e79..959d152e1 100644
--- a/specs/signalwire-rest/fabric-api/swml-webhook/addresses/main.tsp
+++ b/specs/signalwire-rest/fabric-api/swml-webhook/addresses/main.tsp
@@ -14,7 +14,15 @@ namespace FabricAPI.SWMLWebhookAddresses {
   @friendlyName("SWML Webhooks")
   interface SWMLWebhookAddresses {
     @summary("List SWML Webhook Addresses")
-    @doc("This endpoint returns a list of addresses associated with a specific SWML webhook.")
+    @doc("""
+      This endpoint returns a list of addresses associated with a specific SWML webhook.
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     list(...SWMLWebhookIDPath):
       | SWMLWebhookAddressListResponse
       | StatusCode401
diff --git a/specs/signalwire-rest/fabric-api/swml-webhook/main.tsp b/specs/signalwire-rest/fabric-api/swml-webhook/main.tsp
index 29456db3c..2f1db58e6 100644
--- a/specs/signalwire-rest/fabric-api/swml-webhook/main.tsp
+++ b/specs/signalwire-rest/fabric-api/swml-webhook/main.tsp
@@ -17,7 +17,15 @@ namespace FabricAPI.SWMLWebhooks {
   @friendlyName("SWML Webhooks")
   interface SWMLWebhooks {
     @summary("List SWML Webhooks")
-    @doc("A list of SWML Webhooks")
+    @doc("""
+      A list of SWML Webhooks
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     list():
       | SWMLWebhookListResponse
       | StatusCode401
@@ -25,7 +33,15 @@ namespace FabricAPI.SWMLWebhooks {
       | StatusCode500;
 
     @summary("Get SWML Webhook")
-    @doc("Returns an SWML Webhook by ID")
+    @doc("""
+      Returns an SWML Webhook by ID
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     read(...SWMLWebhookID):
       | {
           @statusCode statusCode: 200;
@@ -36,7 +52,15 @@ namespace FabricAPI.SWMLWebhooks {
       | StatusCode500;
 
     @summary("Create SWML Webhook")
-    @doc("Creates an SWML Webhook")
+    @doc("""
+      Creates an SWML Webhook
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @post
     create(...SWMLWebhookCreateRequest):
       | {
@@ -49,7 +73,15 @@ namespace FabricAPI.SWMLWebhooks {
       | StatusCode500;
 
     @summary("Update SWML Webhook")
-    @doc("Updates an SWML Webhook by ID")
+    @doc("""
+      Updates an SWML Webhook by ID
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @patch(#{ implicitOptionality: true })
     update(...SWMLWebhookID, ...SWMLWebhookUpdateRequest):
       | {
@@ -62,7 +94,15 @@ namespace FabricAPI.SWMLWebhooks {
       | StatusCode500;
 
     @summary("Delete SWML Webhook")
-    @doc("Deletes an SWML Webhook by ID")
+    @doc("""
+      Deletes an SWML Webhook by ID
+
+      #### Permissions
+
+      The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+      """)
     @delete
     delete(...SWMLWebhookID):
       | {
diff --git a/specs/signalwire-rest/fabric-api/tsp-output/@typespec/openapi3/openapi.yaml b/specs/signalwire-rest/fabric-api/tsp-output/@typespec/openapi3/openapi.yaml
index b91705025..325481c97 100644
--- a/specs/signalwire-rest/fabric-api/tsp-output/@typespec/openapi3/openapi.yaml
+++ b/specs/signalwire-rest/fabric-api/tsp-output/@typespec/openapi3/openapi.yaml
@@ -10,7 +10,14 @@ info:
     name: MIT
     url: https://github.com/signalwire/docs/blob/main/LICENSE
   termsOfService: https://signalwire.com/legal/signalwire-cloud-agreement
-  description: API to access/manage SignalWire's Call Fabric objects.
+  description: |-
+    API to access/manage SignalWire's Call Fabric objects.
+
+    #### Permissions
+
+    The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+    [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
 externalDocs:
   url: https://developer.signalwire.com/rest/signalwire-rest/endpoints/fabric
   description: The Fabric API holds a collection of endpoints that will help you in managing and creating your SignalWire Resources.
@@ -128,6 +135,13 @@ paths:
       description: |-
         A list of Fabric Addresses. This endpoint uses the bearer token authentication method with the SAT (Subscriber Access Token) which can be
         generated using the [Create Subscriber Token endpoint](/rest/signalwire-rest/endpoints/fabric/subscriber-tokens-create).
+
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters: []
       responses:
         '200':
@@ -165,6 +179,13 @@ paths:
       description: |-
         Returns a Fabric Address by ID. This endpoint uses the bearer token authentication method with the SAT (Subscriber Access Token) which can be
         generated using the [Create Subscriber Token endpoint](/rest/signalwire-rest/endpoints/fabric/subscriber-tokens-create).
+
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/FabricAddressID'
       responses:
@@ -200,7 +221,14 @@ paths:
     post:
       operationId: EmbedsTokens_create
       summary: Create Embeds Tokens
-      description: Exchanges a public Click-to-Call (C2C) token for a short-lived, private embed guest token used to authorize a call. This allows secure activation of the C2C widget without exposing sensitive credentials.
+      description: |-
+        Exchanges a public Click-to-Call (C2C) token for a short-lived, private embed guest token used to authorize a call. This allows secure activation of the C2C widget without exposing sensitive credentials.
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters: []
       responses:
         '201':
@@ -253,7 +281,14 @@ paths:
     post:
       operationId: GuestTokens_create
       summary: Create Subscriber Guest Token
-      description: Creates a Subscriber Guest Token. The token is authorized using an existing API token.
+      description: |-
+        Creates a Subscriber Guest Token. The token is authorized using an existing API token.
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters: []
       responses:
         '201':
@@ -298,7 +333,14 @@ paths:
     get:
       operationId: Resources_list
       summary: List Resources
-      description: A list of Fabric Resources
+      description: |-
+        A list of Fabric Resources
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters: []
       responses:
         '200':
@@ -331,7 +373,14 @@ paths:
     get:
       operationId: AIAgents_list
       summary: List AI Agents
-      description: A list of AI Agents
+      description: |-
+        A list of AI Agents
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters: []
       responses:
         '200':
@@ -363,7 +412,14 @@ paths:
     post:
       operationId: AIAgents_create
       summary: Create AI Agent
-      description: Creates an AI Agent
+      description: |-
+        Creates an AI Agent
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters: []
       responses:
         '201':
@@ -408,7 +464,14 @@ paths:
     get:
       operationId: AIAgentAddresses_list
       summary: List AI Agent Addresses
-      description: This endpoint returns a list of addresses associated with a specific AI Agent.
+      description: |-
+        This endpoint returns a list of addresses associated with a specific AI Agent.
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/AIAgentIDPath'
       responses:
@@ -442,7 +505,14 @@ paths:
     get:
       operationId: AIAgents_read
       summary: Get AI Agent
-      description: Returns an AI Agent by ID
+      description: |-
+        Returns an AI Agent by ID
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/AIAgentPathID'
       responses:
@@ -475,7 +545,14 @@ paths:
     patch:
       operationId: AIAgents_update
       summary: Update AI Agent
-      description: Updates an AI Agent by ID
+      description: |-
+        Updates an AI Agent by ID
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/AIAgentPathID'
       responses:
@@ -520,7 +597,14 @@ paths:
     delete:
       operationId: AIAgents_delete
       summary: Delete AI Agent
-      description: Deletes an AI Agent by ID
+      description: |-
+        Deletes an AI Agent by ID
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/AIAgentPathID'
       responses:
@@ -550,7 +634,14 @@ paths:
     get:
       operationId: CallFlowAddresses_list
       summary: List Call Flow Addresses
-      description: This endpoint returns a list of addresses associated with a specific Call Flow.
+      description: |-
+        This endpoint returns a list of addresses associated with a specific Call Flow.
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/CallFlowAddressPathID'
       responses:
@@ -584,7 +675,14 @@ paths:
     get:
       operationId: CallFlowVersions_list
       summary: List Call Flow Versions
-      description: Returns a list of versions of a Call Flow.
+      description: |-
+        Returns a list of versions of a Call Flow.
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/CallFlowVersionPathID'
       responses:
@@ -617,7 +715,14 @@ paths:
     post:
       operationId: CallFlowVersions_deploy
       summary: Deploy a Call Flow Version
-      description: Deploys a specific version of a Call Flow.
+      description: |-
+        Deploys a specific version of a Call Flow.
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/CallFlowVersionPathID'
       responses:
@@ -663,7 +768,14 @@ paths:
     get:
       operationId: CallFlows_list
       summary: List Call Flows
-      description: A list of Call Flows
+      description: |-
+        A list of Call Flows
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters: []
       responses:
         '200':
@@ -695,7 +807,14 @@ paths:
     post:
       operationId: CallFlows_create
       summary: Create Call Flow
-      description: Creates a Call Flow
+      description: |-
+        Creates a Call Flow
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters: []
       responses:
         '201':
@@ -740,7 +859,14 @@ paths:
     get:
       operationId: CallFlows_read
       summary: Get Call Flow
-      description: Returns a Call Flow by ID
+      description: |-
+        Returns a Call Flow by ID
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/CallFlowPathID'
       responses:
@@ -773,7 +899,14 @@ paths:
     put:
       operationId: CallFlows_update
       summary: Update Call Flow
-      description: Updates a Call Flow by ID
+      description: |-
+        Updates a Call Flow by ID
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/CallFlowPathID'
       responses:
@@ -818,7 +951,14 @@ paths:
     delete:
       operationId: CallFlows_delete
       summary: Delete Call Flow
-      description: Deletes a Call Flow by ID
+      description: |-
+        Deletes a Call Flow by ID
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/CallFlowPathID'
       responses:
@@ -848,7 +988,14 @@ paths:
     get:
       operationId: ConferenceRoomAddresses_list
       summary: List Conference Room Addresses
-      description: This endpoint returns a list of addresses associated with a specific Conference Room.
+      description: |-
+        This endpoint returns a list of addresses associated with a specific Conference Room.
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/ConferenceRoomAddressPathID'
       responses:
@@ -882,7 +1029,14 @@ paths:
     get:
       operationId: ConferenceRooms_list
       summary: List Conference Rooms
-      description: Returns a list of conference rooms.
+      description: |-
+        Returns a list of conference rooms.
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters: []
       responses:
         '200':
@@ -914,7 +1068,14 @@ paths:
     post:
       operationId: ConferenceRooms_create
       summary: Create Conference Room
-      description: Creates a Conference Room
+      description: |-
+        Creates a Conference Room
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters: []
       responses:
         '200':
@@ -959,7 +1120,14 @@ paths:
     get:
       operationId: ConferenceRooms_read
       summary: Get Conference Room
-      description: Returns a Conference Room by ID
+      description: |-
+        Returns a Conference Room by ID
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/ConferenceRoomPathID'
       responses:
@@ -992,7 +1160,14 @@ paths:
     put:
       operationId: ConferenceRooms_update
       summary: Update Conference Room
-      description: Updates a Conference Room by ID
+      description: |-
+        Updates a Conference Room by ID
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/ConferenceRoomPathID'
       responses:
@@ -1037,7 +1212,14 @@ paths:
     delete:
       operationId: ConferenceRooms_delete
       summary: Delete Conference Room
-      description: Deletes a Conference Room by ID
+      description: |-
+        Deletes a Conference Room by ID
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/ConferenceRoomPathID'
       responses:
@@ -1067,7 +1249,14 @@ paths:
     get:
       operationId: CxmlApplications_list
       summary: List cXML Applications
-      description: A list of cXML Applications
+      description: |-
+        A list of cXML Applications
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters: []
       responses:
         '200':
@@ -1100,7 +1289,14 @@ paths:
     get:
       operationId: CxmlApplications_read
       summary: Get cXML Application
-      description: Returns a cXML Application by ID
+      description: |-
+        Returns a cXML Application by ID
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/CxmlApplicationPathID'
       responses:
@@ -1133,7 +1329,14 @@ paths:
     put:
       operationId: CxmlApplications_update
       summary: Update cXML Application
-      description: Updates a cXML Application by ID
+      description: |-
+        Updates a cXML Application by ID
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/CxmlApplicationPathID'
       responses:
@@ -1178,7 +1381,14 @@ paths:
     delete:
       operationId: CxmlApplications_delete
       summary: Delete LAML Application
-      description: Deletes a LAML Application by ID
+      description: |-
+        Deletes a LAML Application by ID
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/CxmlApplicationPathID'
       responses:
@@ -1208,7 +1418,14 @@ paths:
     get:
       operationId: CxmlApplicationAddresses_list
       summary: List cXML Application Addresses
-      description: This endpoint returns a list of addresses associated with a specific LaML Application.
+      description: |-
+        This endpoint returns a list of addresses associated with a specific LaML Application.
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/CxmlApplicationAddressPathID'
       responses:
@@ -1242,7 +1459,14 @@ paths:
     get:
       operationId: CXMLScripts_list
       summary: List cXML Scripts
-      description: A list of cXML Scripts
+      description: |-
+        A list of cXML Scripts
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters: []
       responses:
         '200':
@@ -1274,7 +1498,14 @@ paths:
     post:
       operationId: CXMLScripts_create
       summary: Create cXML Script
-      description: Creates a cXML Script
+      description: |-
+        Creates a cXML Script
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters: []
       responses:
         '200':
@@ -1319,7 +1550,14 @@ paths:
     get:
       operationId: CXMLScripts_read
       summary: Get cXML Script
-      description: Returns a cXML Script by ID
+      description: |-
+        Returns a cXML Script by ID
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/CXMLScriptPathID'
       responses:
@@ -1352,7 +1590,14 @@ paths:
     put:
       operationId: CXMLScripts_update
       summary: Update cXML Script
-      description: Updates a cXML Script by ID
+      description: |-
+        Updates a cXML Script by ID
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/CXMLScriptPathID'
       responses:
@@ -1397,7 +1642,14 @@ paths:
     delete:
       operationId: CXMLScripts_delete
       summary: Delete cXML Script
-      description: Deletes a cXML Script by ID
+      description: |-
+        Deletes a cXML Script by ID
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/CXMLScriptPathID'
       responses:
@@ -1427,7 +1679,14 @@ paths:
     get:
       operationId: CXMLScriptAddresses_list
       summary: List cXML Script Addresses
-      description: This endpoint returns a list of addresses associated with a specific cXML Script.
+      description: |-
+        This endpoint returns a list of addresses associated with a specific cXML Script.
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/CXMLScriptAddressPathID'
       responses:
@@ -1461,7 +1720,14 @@ paths:
     get:
       operationId: CXMLWebhooks_list
       summary: List cXML Webhooks
-      description: A list of cXML Webhooks
+      description: |-
+        A list of cXML Webhooks
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters: []
       responses:
         '200':
@@ -1493,7 +1759,14 @@ paths:
     post:
       operationId: CXMLWebhooks_create
       summary: Create cXML Webhook
-      description: Creates an cXML Webhook
+      description: |-
+        Creates an cXML Webhook
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters: []
       responses:
         '201':
@@ -1538,7 +1811,14 @@ paths:
     get:
       operationId: CXMLWebhookAddresses_list
       summary: List cXML Webhook Addresses
-      description: This endpoint returns a list of addresses associated with a specific cXML Webhook.
+      description: |-
+        This endpoint returns a list of addresses associated with a specific cXML Webhook.
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/CXMLWebhookIDPath'
       responses:
@@ -1572,7 +1852,14 @@ paths:
     get:
       operationId: CXMLWebhooks_read
       summary: Get cXML Webhook
-      description: Returns an cXML Webhook by ID
+      description: |-
+        Returns an cXML Webhook by ID
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/CXMLWebhookID'
       responses:
@@ -1605,7 +1892,14 @@ paths:
     patch:
       operationId: CXMLWebhooks_update
       summary: Update cXML Webhook
-      description: Updates an cXML Webhook by ID
+      description: |-
+        Updates an cXML Webhook by ID
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/CXMLWebhookID'
       responses:
@@ -1650,7 +1944,14 @@ paths:
     delete:
       operationId: CXMLWebhooks_delete
       summary: Delete cXML Webhook
-      description: Deletes an cXML Webhook by ID
+      description: |-
+        Deletes an cXML Webhook by ID
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/CXMLWebhookID'
       responses:
@@ -1680,7 +1981,14 @@ paths:
     get:
       operationId: DialogflowAgents_list
       summary: List Dialogflow Agents
-      description: A list of Dialogflow Agents
+      description: |-
+        A list of Dialogflow Agents
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters: []
       responses:
         '200':
@@ -1713,7 +2021,14 @@ paths:
     get:
       operationId: DialogflowAgents_read
       summary: Get Dialogflow Agent
-      description: Returns a Dialogflow Agent by ID
+      description: |-
+        Returns a Dialogflow Agent by ID
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/DialogflowAgentPathID'
       responses:
@@ -1746,7 +2061,14 @@ paths:
     put:
       operationId: DialogflowAgents_update
       summary: Update Dialogflow Agent
-      description: Updates a Dialogflow Agent by ID
+      description: |-
+        Updates a Dialogflow Agent by ID
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/DialogflowAgentPathID'
       responses:
@@ -1791,7 +2113,14 @@ paths:
     delete:
       operationId: DialogflowAgents_delete
       summary: Delete Dialogflow Agent
-      description: Deletes a Dialogflow Agent by ID
+      description: |-
+        Deletes a Dialogflow Agent by ID
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/DialogflowAgentPathID'
       responses:
@@ -1821,7 +2150,14 @@ paths:
     get:
       operationId: DialogflowAgentAddresses_list
       summary: List Dialogflow Agent Addresses
-      description: This endpoint returns a list of addresses associated with a specific Dialogflow Agent.
+      description: |-
+        This endpoint returns a list of addresses associated with a specific Dialogflow Agent.
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/DialogflowAgentAddressPathID'
       responses:
@@ -1855,7 +2191,14 @@ paths:
     get:
       operationId: FreeswitchConnectors_list
       summary: List FreeSWITCH Connectors
-      description: A list of FreeSWITCH Connectors
+      description: |-
+        A list of FreeSWITCH Connectors
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters: []
       responses:
         '200':
@@ -1887,7 +2230,14 @@ paths:
     post:
       operationId: FreeswitchConnectors_create
       summary: Create FreeSWITCH Connector
-      description: Creates a FreeSWITCH Connector
+      description: |-
+        Creates a FreeSWITCH Connector
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters: []
       responses:
         '200':
@@ -1932,7 +2282,14 @@ paths:
     get:
       operationId: FreeswitchConnectors_read
       summary: Get FreeSWITCH Connector
-      description: Returns a FreeSWITCH Connector by ID
+      description: |-
+        Returns a FreeSWITCH Connector by ID
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/FreeswitchConnectorPathID'
       responses:
@@ -1965,7 +2322,14 @@ paths:
     put:
       operationId: FreeswitchConnectors_update
       summary: Update FreeSWITCH Connector
-      description: Updates a FreeSWITCH Connector by ID
+      description: |-
+        Updates a FreeSWITCH Connector by ID
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/FreeswitchConnectorPathID'
       responses:
@@ -2010,7 +2374,14 @@ paths:
     delete:
       operationId: FreeswitchConnectors_delete
       summary: Delete FreeSWITCH Connector
-      description: Deletes a FreeSWITCH Connector by ID
+      description: |-
+        Deletes a FreeSWITCH Connector by ID
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/FreeswitchConnectorPathID'
       responses:
@@ -2040,7 +2411,14 @@ paths:
     get:
       operationId: FreeswitchConnectorAddresses_list
       summary: List FreeSWITCH Connector Addresses
-      description: This endpoint returns a list of addresses associated with a specific FreeSWITCH Connector.
+      description: |-
+        This endpoint returns a list of addresses associated with a specific FreeSWITCH Connector.
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/FreeswitchConnectorAddressPathID'
       responses:
@@ -2074,7 +2452,14 @@ paths:
     get:
       operationId: RelayApplications_list
       summary: List Relay Applications
-      description: A list of Relay Applications
+      description: |-
+        A list of Relay Applications
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters: []
       responses:
         '200':
@@ -2106,7 +2491,14 @@ paths:
     post:
       operationId: RelayApplications_create
       summary: Create Relay Application
-      description: Creates a Relay Application
+      description: |-
+        Creates a Relay Application
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters: []
       responses:
         '200':
@@ -2151,7 +2543,14 @@ paths:
     get:
       operationId: RelayApplications_read
       summary: Get Relay Application
-      description: Returns a Relay Application by ID
+      description: |-
+        Returns a Relay Application by ID
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/RelayApplicationPathID'
       responses:
@@ -2184,7 +2583,14 @@ paths:
     put:
       operationId: RelayApplications_update
       summary: Update Relay Application
-      description: Updates a Relay Application by ID
+      description: |-
+        Updates a Relay Application by ID
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/RelayApplicationPathID'
       responses:
@@ -2229,7 +2635,14 @@ paths:
     delete:
       operationId: RelayApplications_delete
       summary: Delete Relay Application
-      description: Deletes a Relay Application by ID
+      description: |-
+        Deletes a Relay Application by ID
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/RelayApplicationPathID'
       responses:
@@ -2259,7 +2672,14 @@ paths:
     get:
       operationId: RelayApplicationAddresses_list
       summary: List Relay Application Addresses
-      description: This endpoint returns a paginated list of addresses associated with a Relay Application.
+      description: |-
+        This endpoint returns a paginated list of addresses associated with a Relay Application.
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/RelayApplicationAddressPathID'
       responses:
@@ -2293,7 +2713,14 @@ paths:
     get:
       operationId: SipEndpoints_list
       summary: List SIP Endpoints
-      description: A list of SIP Endpoints
+      description: |-
+        A list of SIP Endpoints
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters: []
       responses:
         '200':
@@ -2327,7 +2754,14 @@ paths:
     post:
       operationId: SipEndpoints_create
       summary: Create SIP Endpoint
-      description: Creates a SIP Endpoint
+      description: |-
+        Creates a SIP Endpoint
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters: []
       responses:
         '200':
@@ -2377,6 +2811,13 @@ paths:
         :::important
         Currently only supports `calling` as a handler and automatically defaults to it.
         :::
+
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/ResourceSipEndpointPathID'
       responses:
@@ -2422,7 +2863,14 @@ paths:
     get:
       operationId: SipEndpoints_read
       summary: Get SIP Endpoint
-      description: Returns a SIP Endpoint by ID
+      description: |-
+        Returns a SIP Endpoint by ID
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/SipEndpointPathID'
       responses:
@@ -2455,7 +2903,14 @@ paths:
     put:
       operationId: SipEndpoints_update
       summary: Update SIP Endpoint
-      description: Updates a SIP Endpoint by ID
+      description: |-
+        Updates a SIP Endpoint by ID
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/SipEndpointPathID'
       responses:
@@ -2500,7 +2955,14 @@ paths:
     delete:
       operationId: SipEndpoints_delete
       summary: Delete SIP Endpoint
-      description: Deletes a SIP Endpoint by ID
+      description: |-
+        Deletes a SIP Endpoint by ID
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/SipEndpointPathID'
       responses:
@@ -2530,7 +2992,14 @@ paths:
     get:
       operationId: SipEndpointAddresses_list
       summary: List SIP Endpoint Addresses
-      description: A list of SIP Endpoint Addresses.
+      description: |-
+        A list of SIP Endpoint Addresses.
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/SipEndpointAddressPathID'
       responses:
@@ -2564,7 +3033,14 @@ paths:
     get:
       operationId: SipGateways_list
       summary: List SIP Gateways
-      description: Returns a paginated list of SIP Gateways for the authenticated project.
+      description: |-
+        Returns a paginated list of SIP Gateways for the authenticated project.
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters: []
       responses:
         '200':
@@ -2596,7 +3072,14 @@ paths:
     post:
       operationId: SipGateways_create
       summary: Create SIP Gateway
-      description: Creates a SIP Gateway that can be used to dial external SIP entities.
+      description: |-
+        Creates a SIP Gateway that can be used to dial external SIP entities.
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters: []
       responses:
         '201':
@@ -2641,7 +3124,14 @@ paths:
     get:
       operationId: RelayApplicationAddresses_readAddressesByResourceId
       summary: List Fabric Addresses assigned to a SIP Gateway
-      description: Returns a paginated list of Fabric Addresses associated with the specified SIP Gateway.
+      description: |-
+        Returns a paginated list of Fabric Addresses associated with the specified SIP Gateway.
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/SipGatewayAddressRequest'
       responses:
@@ -2675,7 +3165,14 @@ paths:
     get:
       operationId: SipGateways_read
       summary: Get SIP Gateway
-      description: Returns an SIP Gateway by ID
+      description: |-
+        Returns an SIP Gateway by ID
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/SipGatewayID'
       responses:
@@ -2708,7 +3205,14 @@ paths:
     patch:
       operationId: SipGateways_update
       summary: Update SIP Gateway
-      description: Updates a SIP Gateway by ID
+      description: |-
+        Updates a SIP Gateway by ID
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/SipGatewayID'
       responses:
@@ -2753,7 +3257,14 @@ paths:
     delete:
       operationId: SipGateways_delete
       summary: Delete SIP Gateway
-      description: Deletes a SIP Gateway} by ID
+      description: |-
+        Deletes a SIP Gateway} by ID
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/SipGatewayID'
       responses:
@@ -2783,7 +3294,14 @@ paths:
     get:
       operationId: Subscribers_list
       summary: List Subscribers
-      description: Retrieve a list of all subscribers
+      description: |-
+        Retrieve a list of all subscribers
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters: []
       responses:
         '200':
@@ -2815,7 +3333,14 @@ paths:
     post:
       operationId: Subscribers_create
       summary: Create Subscriber
-      description: Create a new Subscriber
+      description: |-
+        Create a new Subscriber
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters: []
       responses:
         '201':
@@ -2860,7 +3385,14 @@ paths:
     get:
       operationId: SubscriberSipEndpoint_list
       summary: List Subscriber SIP Endpoints
-      description: A list of Sip Endpoints of the Subscriber
+      description: |-
+        A list of Sip Endpoints of the Subscriber
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/FabricSubscriberID'
       responses:
@@ -2893,7 +3425,14 @@ paths:
     post:
       operationId: SubscriberSipEndpoint_create
       summary: Create Subscriber SIP Endpoint
-      description: Creates a Subscriber Sip Endpoint
+      description: |-
+        Creates a Subscriber Sip Endpoint
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/FabricSubscriberID'
       responses:
@@ -2939,7 +3478,14 @@ paths:
     get:
       operationId: SubscriberSipEndpoint_read
       summary: Get Subscriber SIP Endpoint
-      description: Returns a Subscriber Sip Endpoint by ID
+      description: |-
+        Returns a Subscriber Sip Endpoint by ID
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/SIPEndpointID'
         - $ref: '#/components/parameters/FabricSubscriberID'
@@ -2973,7 +3519,14 @@ paths:
     patch:
       operationId: SubscriberSipEndpoint_update
       summary: Update Subscriber SIP Endpoint
-      description: Updates a Subscriber Sip Endpoint by ID
+      description: |-
+        Updates a Subscriber Sip Endpoint by ID
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/SIPEndpointID'
         - $ref: '#/components/parameters/FabricSubscriberID'
@@ -3019,7 +3572,14 @@ paths:
     delete:
       operationId: SubscriberSipEndpoint_delete
       summary: Delete Subscriber SIP Endpoint
-      description: Deletes a Subscriber Sip Endpoint by ID
+      description: |-
+        Deletes a Subscriber Sip Endpoint by ID
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/SIPEndpointID'
         - $ref: '#/components/parameters/FabricSubscriberID'
@@ -3050,7 +3610,14 @@ paths:
     get:
       operationId: Subscribers_get
       summary: Get Subscriber
-      description: Fetch an existing Subscriber
+      description: |-
+        Fetch an existing Subscriber
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/SubscriberPathID'
       responses:
@@ -3083,7 +3650,14 @@ paths:
     put:
       operationId: Subscribers_update
       summary: Update Subscriber
-      description: Update an existing Subsriber
+      description: |-
+        Update an existing Subsriber
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/SubscriberPathID'
       responses:
@@ -3128,7 +3702,14 @@ paths:
     delete:
       operationId: Subscribers_delete
       summary: Delete Subscriber
-      description: Delete an existing Subscriber
+      description: |-
+        Delete an existing Subscriber
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/SubscriberPathID'
       responses:
@@ -3158,7 +3739,14 @@ paths:
     get:
       operationId: SubscriberAddresses_list
       summary: List Subscriber Addresses
-      description: List Subscriber Addresses
+      description: |-
+        List Subscriber Addresses
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/SubscriberAddressID'
       responses:
@@ -3194,7 +3782,14 @@ paths:
     get:
       operationId: SwmlScripts_list
       summary: List SWML Scripts
-      description: A list of SWML Scripts
+      description: |-
+        A list of SWML Scripts
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters: []
       responses:
         '200':
@@ -3228,7 +3823,14 @@ paths:
     post:
       operationId: SwmlScripts_create
       summary: Create SWML Script
-      description: Creates a SWML Script
+      description: |-
+        Creates a SWML Script
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters: []
       responses:
         '200':
@@ -3273,7 +3875,14 @@ paths:
     get:
       operationId: SwmlScripts_read
       summary: Get SWML Script
-      description: Returns a SWML Script by ID
+      description: |-
+        Returns a SWML Script by ID
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/SwmlScriptPathID'
       responses:
@@ -3306,7 +3915,14 @@ paths:
     put:
       operationId: SwmlScripts_update
       summary: Update SWML Script
-      description: Updates a SWML Script by ID
+      description: |-
+        Updates a SWML Script by ID
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/SwmlScriptPathID'
       responses:
@@ -3351,7 +3967,14 @@ paths:
     delete:
       operationId: SwmlScripts_delete
       summary: Delete SWML Script
-      description: Deletes a SWML Script by ID
+      description: |-
+        Deletes a SWML Script by ID
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/SwmlScriptPathID'
       responses:
@@ -3381,7 +4004,14 @@ paths:
     get:
       operationId: SWMLScriptAddresses_list
       summary: List SWML Script Addresses
-      description: This endpoints returns a list of addresses associated with a specific SWML script.
+      description: |-
+        This endpoints returns a list of addresses associated with a specific SWML script.
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/SWMLScriptAddressPathID'
       responses:
@@ -3415,7 +4045,14 @@ paths:
     get:
       operationId: SWMLWebhooks_list
       summary: List SWML Webhooks
-      description: A list of SWML Webhooks
+      description: |-
+        A list of SWML Webhooks
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters: []
       responses:
         '200':
@@ -3447,7 +4084,14 @@ paths:
     post:
       operationId: SWMLWebhooks_create
       summary: Create SWML Webhook
-      description: Creates an SWML Webhook
+      description: |-
+        Creates an SWML Webhook
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters: []
       responses:
         '201':
@@ -3492,7 +4136,14 @@ paths:
     get:
       operationId: SWMLWebhooks_read
       summary: Get SWML Webhook
-      description: Returns an SWML Webhook by ID
+      description: |-
+        Returns an SWML Webhook by ID
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/SWMLWebhookID'
       responses:
@@ -3525,7 +4176,14 @@ paths:
     patch:
       operationId: SWMLWebhooks_update
       summary: Update SWML Webhook
-      description: Updates an SWML Webhook by ID
+      description: |-
+        Updates an SWML Webhook by ID
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/SWMLWebhookID'
       responses:
@@ -3570,7 +4228,14 @@ paths:
     delete:
       operationId: SWMLWebhooks_delete
       summary: Delete SWML Webhook
-      description: Deletes an SWML Webhook by ID
+      description: |-
+        Deletes an SWML Webhook by ID
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/SWMLWebhookID'
       responses:
@@ -3600,7 +4265,14 @@ paths:
     get:
       operationId: SWMLWebhookAddresses_list
       summary: List SWML Webhook Addresses
-      description: This endpoint returns a list of addresses associated with a specific SWML webhook.
+      description: |-
+        This endpoint returns a list of addresses associated with a specific SWML webhook.
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/SWMLWebhookIDPath'
       responses:
@@ -3634,7 +4306,14 @@ paths:
     get:
       operationId: Resources_read
       summary: Get Resource
-      description: Returns a Resource by ID
+      description: |-
+        Returns a Resource by ID
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/ResourcePathID'
       responses:
@@ -3667,7 +4346,14 @@ paths:
     delete:
       operationId: Resources_delete
       summary: Delete Resource
-      description: Deletes a Resource by ID
+      description: |-
+        Deletes a Resource by ID
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/ResourcePathID'
       responses:
@@ -3697,7 +4383,14 @@ paths:
     get:
       operationId: ResourceAddresses_list
       summary: List Resource Addresses
-      description: This endpoint is used to retrieve addresses associated with a specific Resource.
+      description: |-
+        This endpoint is used to retrieve addresses associated with a specific Resource.
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/ResourceAddressPathID'
       responses:
@@ -3736,6 +4429,13 @@ paths:
         :::important
         Currently only supports `calling` as a handler and automatically defaults to it.
         :::
+
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/DomainApplicationPathID'
       responses:
@@ -3781,7 +4481,15 @@ paths:
     post:
       operationId: PhoneRoutes_assign
       summary: Assign a Resource to a Phone Route
-      description: This endpoint assigns a specific resource to a phone route, allowing inbound calls & messages to be handled by the resource.
+      description: |-
+        This endpoint assigns a specific resource to a phone route, allowing inbound calls & messages to be handled by the resource.
+
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/PhoneRoutePathID'
       responses:
@@ -3827,7 +4535,14 @@ paths:
     post:
       operationId: InviteTokens_create
       summary: Create a Subscriber Invite Token
-      description: Creates a Subscriber Invite Token to be used for client-side API calls. The token is authorized using a subscriber's SAT (Subscriber Access Token)
+      description: |-
+        Creates a Subscriber Invite Token to be used for client-side API calls. The token is authorized using a subscriber's SAT (Subscriber Access Token)
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters: []
       responses:
         '201':
@@ -3872,7 +4587,14 @@ paths:
     post:
       operationId: SubscriberTokens_create
       summary: Create Subscriber Token
-      description: Create a Subscriber Token
+      description: |-
+        Create a Subscriber Token
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters: []
       responses:
         '200':
@@ -3917,7 +4639,14 @@ paths:
     post:
       operationId: RefreshTokens_create
       summary: Exchange a refresh token for a new subscriber access token
-      description: Exchanges a valid refresh token for a new subscriber access token and a new refresh token. The new access token is valid for 2 hours, and the new refresh token is valid for 2 hours and 5 minutes.
+      description: |-
+        Exchanges a valid refresh token for a new subscriber access token and a new refresh token. The new access token is valid for 2 hours, and the new refresh token is valid for 2 hours and 5 minutes.
+
+        #### Permissions
+
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters: []
       responses:
         '201':
diff --git a/specs/signalwire-rest/fax-api/_spec_.yaml b/specs/signalwire-rest/fax-api/_spec_.yaml
index dae2c8be3..2da8588ce 100644
--- a/specs/signalwire-rest/fax-api/_spec_.yaml
+++ b/specs/signalwire-rest/fax-api/_spec_.yaml
@@ -90,7 +90,7 @@ paths:
         List the available logs.
 
         #### Permissions
-        The API token must include the following scopes: _Fax_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Fax_.
       tags:
         - Logs
       parameters:
@@ -239,7 +239,7 @@ paths:
         Find a log by ID.
 
         #### Permissions
-        The API token must include the following scopes: _Fax_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Fax_.
       tags:
         - Logs
       parameters:
diff --git a/specs/signalwire-rest/fax-api/logs/main.tsp b/specs/signalwire-rest/fax-api/logs/main.tsp
index 9c167120c..40a7c9b12 100644
--- a/specs/signalwire-rest/fax-api/logs/main.tsp
+++ b/specs/signalwire-rest/fax-api/logs/main.tsp
@@ -21,7 +21,9 @@ namespace FaxAPI.Logs {
       
       #### Permissions 
       
-      The API token must include the following scopes: _Fax_.
+      The API token used to authenticate must have the following scopes enabled to make a successful request: _Fax_.
+      
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       """)
     list(...LogListRequest):
       | LogListResponse
@@ -35,7 +37,9 @@ namespace FaxAPI.Logs {
       
       #### Permissions
       
-      The API token must include the following scopes: _Fax_.
+      The API token used to authenticate must have the following scopes enabled to make a successful request: _Fax_.
+      
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       """)
     read(...LogPathID):
       | LogResponse
diff --git a/specs/signalwire-rest/fax-api/tsp-output/@typespec/openapi3/openapi.yaml b/specs/signalwire-rest/fax-api/tsp-output/@typespec/openapi3/openapi.yaml
index 10d8196e0..b64ecc54b 100644
--- a/specs/signalwire-rest/fax-api/tsp-output/@typespec/openapi3/openapi.yaml
+++ b/specs/signalwire-rest/fax-api/tsp-output/@typespec/openapi3/openapi.yaml
@@ -30,7 +30,9 @@ paths:
 
         #### Permissions 
 
-        The API token must include the following scopes: _Fax_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Fax_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/LogListRequest.include_deleted'
         - $ref: '#/components/parameters/LogListRequest.created_before'
@@ -73,7 +75,9 @@ paths:
 
         #### Permissions
 
-        The API token must include the following scopes: _Fax_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Fax_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/LogPathID'
       responses:
diff --git a/specs/signalwire-rest/logs-api/conferences/main.tsp b/specs/signalwire-rest/logs-api/conferences/main.tsp
index c6fc8d4bb..824c9cc25 100644
--- a/specs/signalwire-rest/logs-api/conferences/main.tsp
+++ b/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;
   }
 }
diff --git a/specs/signalwire-rest/logs-api/tsp-output/@typespec/openapi3/openapi.yaml b/specs/signalwire-rest/logs-api/tsp-output/@typespec/openapi3/openapi.yaml
index 4de5af3f3..f38d87753 100644
--- a/specs/signalwire-rest/logs-api/tsp-output/@typespec/openapi3/openapi.yaml
+++ b/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':
diff --git a/specs/signalwire-rest/message-api/_spec_.yaml b/specs/signalwire-rest/message-api/_spec_.yaml
index 86a9dd049..53ab42ba5 100644
--- a/specs/signalwire-rest/message-api/_spec_.yaml
+++ b/specs/signalwire-rest/message-api/_spec_.yaml
@@ -45,7 +45,7 @@ paths:
         List the available logs.
 
         #### Permissions
-        The API token must include the following scopes: _Messaging_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Messaging_.
       tags:
         - Logs
       parameters:
@@ -184,7 +184,7 @@ paths:
         Find a log by ID.
 
         #### Permissions
-        The API token must include the following scopes: _Messaging_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Messaging_.
       tags:
         - Logs
       parameters:
diff --git a/specs/signalwire-rest/message-api/logs/main.tsp b/specs/signalwire-rest/message-api/logs/main.tsp
index b92051e6e..060104881 100644
--- a/specs/signalwire-rest/message-api/logs/main.tsp
+++ b/specs/signalwire-rest/message-api/logs/main.tsp
@@ -20,7 +20,9 @@ namespace MessageAPI.Logs {
       
       #### Permissions
       
-      The API token must include the following scopes: _Messaging_.
+      The API token used to authenticate must have the following scopes enabled to make a successful request: _Messaging_.
+      
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       """)
     list(...LogListRequest):
       | LogListResponse
@@ -34,7 +36,9 @@ namespace MessageAPI.Logs {
       
       #### Permissions
       
-      The API token must include the following scopes: _Messaging_.
+      The API token used to authenticate must have the following scopes enabled to make a successful request: _Messaging_.
+      
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       """)
     retrieve(...LogPathID):
       | LogRetrieveResponse
diff --git a/specs/signalwire-rest/message-api/tsp-output/@typespec/openapi3/openapi.yaml b/specs/signalwire-rest/message-api/tsp-output/@typespec/openapi3/openapi.yaml
index ffa465a00..ed2b70857 100644
--- a/specs/signalwire-rest/message-api/tsp-output/@typespec/openapi3/openapi.yaml
+++ b/specs/signalwire-rest/message-api/tsp-output/@typespec/openapi3/openapi.yaml
@@ -30,7 +30,9 @@ paths:
 
         #### Permissions
 
-        The API token must include the following scopes: _Messaging_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Messaging_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/LogListRequest.include_deleted'
         - $ref: '#/components/parameters/LogListRequest.created_before'
@@ -73,7 +75,9 @@ paths:
 
         #### Permissions
 
-        The API token must include the following scopes: _Messaging_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Messaging_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/LogPathID'
       responses:
diff --git a/specs/signalwire-rest/project-api/_spec_.yaml b/specs/signalwire-rest/project-api/_spec_.yaml
index 19ed4f9cd..892e56acb 100644
--- a/specs/signalwire-rest/project-api/_spec_.yaml
+++ b/specs/signalwire-rest/project-api/_spec_.yaml
@@ -35,6 +35,13 @@ paths:
 
 
         #### Permissions
+        
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Management_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+
+
+        #### Token Permissions
 
         You must set the functions allowed by this API Token by selecting which
         types of requests this API Token is allowed to make.
@@ -149,6 +156,13 @@ paths:
 
 
         #### Permissions
+        
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Management_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
+
+
+        #### Token Permissions
 
         You can modify the functions allowed by this API Token by selecting
         which types of requests this API Token is allowed to make.
@@ -252,6 +266,12 @@ paths:
       summary: Delete an API Token
       description: |
         Delete an API Token. This action cannot be undone.
+
+        #### Permissions
+        
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Management_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Tokens
       parameters:
diff --git a/specs/signalwire-rest/pubsub-api/_spec_.yaml b/specs/signalwire-rest/pubsub-api/_spec_.yaml
index fdeb089cb..4ee2eba10 100644
--- a/specs/signalwire-rest/pubsub-api/_spec_.yaml
+++ b/specs/signalwire-rest/pubsub-api/_spec_.yaml
@@ -36,7 +36,7 @@ paths:
 
         #### Permissions
 
-        The API token must include the following scopes: _PubSub_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _PubSub_.
       tags:
         - Tokens
       requestBody:
diff --git a/specs/signalwire-rest/pubsub-api/tokens/main.tsp b/specs/signalwire-rest/pubsub-api/tokens/main.tsp
index cc671317f..4dde23e79 100644
--- a/specs/signalwire-rest/pubsub-api/tokens/main.tsp
+++ b/specs/signalwire-rest/pubsub-api/tokens/main.tsp
@@ -22,7 +22,9 @@ namespace PubSubAPI.Tokens {
       
       #### Permissions
       
-      The API token must include the following scopes: _PubSub_.
+      The API token used to authenticate must have the following scopes enabled to make a successful request: _PubSub_.
+      
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       """)
     @post
     @operationId("create_token")
diff --git a/specs/signalwire-rest/pubsub-api/tsp-output/@typespec/openapi3/openapi.yaml b/specs/signalwire-rest/pubsub-api/tsp-output/@typespec/openapi3/openapi.yaml
index e1e55cc3d..74cc8b906 100644
--- a/specs/signalwire-rest/pubsub-api/tsp-output/@typespec/openapi3/openapi.yaml
+++ b/specs/signalwire-rest/pubsub-api/tsp-output/@typespec/openapi3/openapi.yaml
@@ -31,7 +31,9 @@ paths:
 
         #### Permissions
 
-        The API token must include the following scopes: _PubSub_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _PubSub_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters: []
       responses:
         '200':
diff --git a/specs/signalwire-rest/space-api/_spec_.yaml b/specs/signalwire-rest/space-api/_spec_.yaml
index 29f063072..c8c62f231 100644
--- a/specs/signalwire-rest/space-api/_spec_.yaml
+++ b/specs/signalwire-rest/space-api/_spec_.yaml
@@ -598,7 +598,9 @@ paths:
 
         #### Permissions
 
-        The API token must include the following scopes: _Numbers_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Numbers_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Addresses
       responses:
@@ -724,7 +726,9 @@ paths:
         To create a new Address, make a POST request to the Address resource.
 
         #### Permissions
-        The API token must include the following scopes: _Numbers_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Numbers_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Addresses
       requestBody:
@@ -920,7 +924,9 @@ paths:
 
         #### Permissions
 
-        The API token must include the following scopes: _Numbers_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Numbers_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Addresses
       parameters:
@@ -1045,7 +1051,9 @@ paths:
 
         #### Permissions
 
-        The API token must include the following scopes: _Numbers_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Numbers_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Addresses
       parameters:
@@ -1077,7 +1085,9 @@ paths:
         future.**
 
         #### Permissions
-        The API token must include the following scopes: _Messaging_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Messaging_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Campaign Registry (Beta)
       requestBody:
@@ -1262,7 +1272,9 @@ paths:
         filterable by sending in any of the following parameters.
 
         #### Permissions
-        The API token must include the following scopes: _Messaging_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Messaging_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Campaign Registry (Beta)
       parameters:
@@ -1410,7 +1422,9 @@ paths:
         the specific Brand.
 
         #### Permissions
-        The API token must include the following scopes: _Messaging_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Messaging_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Campaign Registry (Beta)
       parameters:
@@ -1532,7 +1546,9 @@ paths:
         parameters.
 
         #### Permissions
-        The API token must include the following scopes: _Messaging_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Messaging_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Campaign Registry (Beta)
       parameters:
@@ -1819,7 +1835,9 @@ paths:
         and is no longer required.*
 
         #### Permissions
-        The API token must include the following scopes: _Messaging_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Messaging_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Campaign Registry (Beta)
       parameters:
@@ -2254,7 +2272,9 @@ paths:
         identify the specific Campaign.
 
         #### Permissions
-        The API token must include the following scopes: _Messaging_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Messaging_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Campaign Registry (Beta)
       parameters:
@@ -2488,7 +2508,9 @@ paths:
         Allows updating the friendly name associated with a campaign
 
         #### Permissions
-        The API token must include the following scopes: _Messaging_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Messaging_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Campaign Registry (Beta)
       parameters:
@@ -2739,7 +2761,9 @@ paths:
         following parameters.
 
         #### Permissions
-        The API token must include the following scopes: _Messaging_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Messaging_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Campaign Registry (Beta)
       parameters:
@@ -2832,7 +2856,9 @@ paths:
         following parameters.
 
         #### Permissions
-        The API token must include the following scopes: _Messaging_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Messaging_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Campaign Registry (Beta)
       parameters:
@@ -2917,7 +2943,9 @@ paths:
         A list of `phone_numbers` in E164 format is required. 
 
         #### Permissions
-        The API token must include the following scopes: _Messaging_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Messaging_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Campaign Registry (Beta)
       parameters:
@@ -2998,7 +3026,9 @@ paths:
         Returns a phone number assignment order.
 
         #### Permissions
-        The API token must include the following scopes: _Messaging_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Messaging_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Campaign Registry (Beta)
       parameters:
@@ -3063,7 +3093,9 @@ paths:
 
         #### Permissions
 
-        The API token must include the following scopes: _Messaging_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Messaging_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Campaign Registry (Beta)
       parameters:
@@ -3088,7 +3120,9 @@ paths:
         of the following parameters.
 
         #### Permissions
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Domain Applications
       parameters:
@@ -3400,7 +3434,9 @@ paths:
         domain application resource.
 
         #### Permissions
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Domain Applications
       requestBody:
@@ -3929,7 +3965,9 @@ paths:
         request to identify the specific domain application.
 
         #### Permissions
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Domain Applications
       parameters:
@@ -4201,7 +4239,9 @@ paths:
         parameters passed in. Any parameters not provided will be unchanged.
 
         #### Permissions
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Domain Applications
       parameters:
@@ -4730,7 +4770,9 @@ paths:
         deregister any connections.
 
         #### Permissions
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Domain Applications
       parameters:
@@ -4754,7 +4796,9 @@ paths:
         filterable by sending in any of the following parameters.
 
         #### Permissions
-        The API token must include the following scopes: _Numbers_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Numbers_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Number Groups
       parameters:
@@ -4837,7 +4881,9 @@ paths:
         Group resource.
 
         #### Permissions
-        The API token must include the following scopes: _Numbers_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Numbers_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Number Groups
       requestBody:
@@ -4920,7 +4966,9 @@ paths:
         request to identify the specific Number Group.
 
         #### Permissions
-        The API token must include the following scopes: _Numbers_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Numbers_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Number Groups
       parameters:
@@ -4983,7 +5031,9 @@ paths:
         parameters passed in. Any parameters not provided will be unchanged.
 
         #### Permissions
-        The API token must include the following scopes: _Numbers_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Numbers_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Number Groups
       parameters:
@@ -5063,7 +5113,9 @@ paths:
         the Number Group.
 
         #### Permissions
-        The API token must include the following scopes: _Numbers_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Numbers_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Number Groups
       parameters:
@@ -5087,7 +5139,9 @@ paths:
         first.
 
         #### Permissions
-        The API token must include the following scopes: _Numbers_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Numbers_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Number Group Membership
       parameters:
@@ -5167,7 +5221,9 @@ paths:
         the Number Group Membership resource.
 
         #### Permissions
-        The API token must include the following scopes: _Numbers_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Numbers_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Number Group Membership
       parameters:
@@ -5249,7 +5305,9 @@ paths:
         previous request to identify the specific Number Group Membership.
 
         #### Permissions
-        The API token must include the following scopes: _Numbers_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Numbers_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Number Group Membership
       parameters:
@@ -5314,7 +5372,9 @@ paths:
         the Phone Number from the Number Group.
 
         #### Permissions
-        The API token must include the following scopes: _Numbers_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Numbers_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Number Group Membership
       parameters:
@@ -5339,7 +5399,9 @@ paths:
         [Sales](https://signalwire.com/company/contact?utm_campaign=devex_sent_em).
 
         #### Permissions
-        The API token must include the following scopes: _Numbers_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Numbers_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Imported Phone Numbers
       requestBody:
@@ -5604,7 +5666,9 @@ paths:
         parameters.
 
         #### Permissions
-        The API token must include the following scopes: _Numbers_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Numbers_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Phone Numbers
       parameters:
@@ -5938,7 +6002,9 @@ paths:
         Purchase a number and add it to your project.
 
         #### Permissions
-        The API token must include the following scopes: _Numbers_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Numbers_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Phone Numbers
       requestBody:
@@ -6248,7 +6314,9 @@ paths:
         created.
 
         #### Permissions
-        The API token must include the following scopes: _Numbers_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Numbers_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Phone Numbers
       parameters:
@@ -6541,7 +6609,9 @@ paths:
         parameters passed in. Any parameters not provided will be unchanged.
 
         #### Permissions
-        The API token must include the following scopes: _Numbers_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Numbers_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Phone Numbers
       parameters:
@@ -7065,7 +7135,9 @@ paths:
 
         #### Permissions
 
-        The API token must include the following scopes: _Numbers_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Numbers_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Phone Numbers
       parameters:
@@ -7088,7 +7160,9 @@ paths:
         given search criteria parameters.
 
         #### Permissions
-        The API token must include the following scopes: _Numbers_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Numbers_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Phone Numbers
       parameters:
@@ -7237,7 +7311,9 @@ paths:
         information about the number such as carrier and caller ID data.
 
         #### Permissions
-        The API token must include the following scopes: _Numbers_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Numbers_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Phone Number Lookup
       parameters:
@@ -7418,8 +7494,9 @@ paths:
         parameters.
 
         #### Permissions
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
 
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - SIP Endpoints
       responses:
@@ -7696,8 +7773,9 @@ paths:
         Endpoint resource.
 
         #### Permissions
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
 
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - SIP Endpoints
       requestBody:
@@ -8192,8 +8270,9 @@ paths:
         request to identify the specific SIP Endpoint.
 
         #### Permissions
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
 
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - SIP Endpoints
       parameters:
@@ -8450,8 +8529,9 @@ paths:
         parameters passed in. Any parameters not provided will be unchanged.
 
         #### Permissions
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
 
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - SIP Endpoints
       parameters:
@@ -8949,7 +9029,9 @@ paths:
         any connections.
 
         #### Permissions
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - SIP Endpoints
       parameters:
@@ -8973,7 +9055,9 @@ paths:
         identify the specific SIP Profile.
 
         #### Permissions
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - SIP Profile
       responses:
@@ -9051,7 +9135,9 @@ paths:
         parameters passed in. Any parameters not provided will be unchanged.
 
         #### Permissions
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - SIP Profile
       requestBody:
@@ -9192,8 +9278,10 @@ paths:
 
         #### Permissions
 
-        The API token must include one of the following scopes: _Voice_ or
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_ or
         _Messaging_ or _Fax_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Multi-Factor Authentication
       requestBody:
@@ -9298,8 +9386,10 @@ paths:
 
         #### Permissions
 
-        The API token must include one of the following scopes: _Voice_ or
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_ or
         _Messaging_ or _Fax_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Multi-Factor Authentication
       requestBody:
@@ -9410,8 +9500,10 @@ paths:
 
         #### Permissions
 
-        The API token must include one of the following scopes: _Voice_ or
+        The API token used to authenticate must have one of the following scopes enabled to make a successful request: _Voice_ or
         _Messaging_ or _Fax_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Multi-Factor Authentication
       parameters:
@@ -9462,7 +9554,9 @@ paths:
 
         #### Permissions
 
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Verified Caller IDs
       requestBody:
@@ -9599,7 +9693,9 @@ paths:
         following parameters.
 
         #### Permissions
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Verified Caller IDs
       parameters:
@@ -9729,7 +9825,9 @@ paths:
         Caller ID.
 
         #### Permissions
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Verified Caller IDs
       parameters:
@@ -9834,7 +9932,9 @@ paths:
         a Verified Caller ID endpoint.
 
         #### Permissions
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Verified Caller IDs
       parameters:
@@ -9950,7 +10050,9 @@ paths:
         to place calls from this phone number.
 
         #### Permissions
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Verified Caller IDs
       parameters:
@@ -9977,7 +10079,9 @@ paths:
          - There is a limit of 5 attempts to enter a validation code for a number. Once exhausted, you may request a redial of the verification call to reset the code and try again.
 
         #### Permissions
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Verified Caller IDs
       parameters:
@@ -10100,7 +10204,9 @@ paths:
 
         #### Permissions
 
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Verified Caller IDs
       parameters:
@@ -10196,6 +10302,14 @@ paths:
     get:
       operationId: Recordings_list
       summary: List Relay Recordings
+      description: |
+        Returns a list of recordings. The recordings are returned sorted by creation date, with the most recent appearing first.
+
+        #### Permissions
+
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters: []
       responses:
         '200':
@@ -10226,6 +10340,14 @@ paths:
     get:
       operationId: Recordings_get
       summary: Get Relay Recording
+      description: |
+        Retrieves the details of a recording.
+
+        #### Permissions
+
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/RecordingPathID'
       responses:
@@ -10256,6 +10378,14 @@ paths:
     delete:
       operationId: Recordings_delete
       summary: Delete Relay Recording
+      description: |
+        Deletes a recording.
+
+        #### Permissions
+
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/RecordingPathID'
       responses:
@@ -10284,7 +10414,14 @@ paths:
       tags:
         - Queues
       summary: List Queues
-      description: Returns a paginated list of queues.
+      description: |
+        Returns a paginated list of queues.
+
+        #### Permissions
+
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       responses:
         '200':
           description: A list of queues
@@ -10296,7 +10433,14 @@ paths:
       tags:
         - Queues
       summary: Create a Queue
-      description: Creates a new queue.
+      description: |
+        Creates a new queue.
+
+        #### Permissions
+
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       requestBody:
         required: true
         content:
@@ -10325,7 +10469,14 @@ paths:
       tags:
         - Queues
       summary: Retrieve a Queue
-      description: Returns information about a specific queue.
+      description: |
+        Returns information about a specific queue.
+
+        #### Permissions
+
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/QueuePathID'
       responses:
@@ -10349,7 +10500,14 @@ paths:
       tags:
         - Queues
       summary: Update a Queue
-      description: Updates the properties of a specific queue.
+      description: |
+        Updates the properties of a specific queue.
+
+        #### Permissions
+
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/QueuePathID'
       requestBody:
@@ -10381,7 +10539,14 @@ paths:
       tags:
         - Queues
       summary: Delete a Queue
-      description: Deletes a specific queue.
+      description: |
+        Deletes a specific queue.
+
+        #### Permissions
+
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/QueuePathID'
       responses:
@@ -10406,7 +10571,9 @@ paths:
       description: |
         Retrieves a list of all members currently in the queue.
         #### Permissions
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Queue Members
       parameters:
@@ -10445,7 +10612,9 @@ paths:
       description: |
         Retrieves the details of a queue member.
         #### Permissions
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Queue Members
       parameters:
@@ -10477,7 +10646,9 @@ paths:
       description: |
         Retrieves the details of next member on the queue.
         #### Permissions
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Queue Members
       parameters:
@@ -10502,7 +10673,9 @@ paths:
       description: |
         Dequeues next member on the queue.
         #### Permissions
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Queue Members
       parameters:
@@ -10527,7 +10700,9 @@ paths:
       description: |
         Dequeues member on the queue.
         #### Permissions
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Queue Members
       parameters:
diff --git a/specs/signalwire-rest/video-api/_spec_.yaml b/specs/signalwire-rest/video-api/_spec_.yaml
index 33ff46191..737fece65 100644
--- a/specs/signalwire-rest/video-api/_spec_.yaml
+++ b/specs/signalwire-rest/video-api/_spec_.yaml
@@ -97,7 +97,9 @@ paths:
         Create a room.
 
         #### Permissions
-        The API token must include the following scopes: _Video_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Rooms
       requestBody:
@@ -421,7 +423,9 @@ paths:
         List rooms.
 
         #### Permissions
-        The API token must include the following scopes: _Video_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Rooms
       parameters:
@@ -691,7 +695,9 @@ paths:
         Find a room by its unique name.
 
         #### Permissions
-        The API token must include the following scopes: _Video_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Rooms
       parameters:
@@ -937,7 +943,9 @@ paths:
         Find a room by ID.
 
         #### Permissions
-        The API token must include the following scopes: _Video_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Rooms
       parameters:
@@ -1175,7 +1183,9 @@ paths:
         Update a room.
 
         #### Permissions
-        The API token must include the following scopes: _Video_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Rooms
       parameters:
@@ -1499,7 +1509,9 @@ paths:
         Delete a room.
 
         #### Permissions
-        The API token must include the following scopes: _Video_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Rooms
       parameters:
@@ -1519,7 +1531,9 @@ paths:
       summary: List Streams by Room Id
       description: |
         #### Permissions
-        The API token must include the following scopes: _Video_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Streams
       parameters:
@@ -1582,7 +1596,9 @@ paths:
       summary: Create a Stream for a Room
       description: |
         #### Permissions
-        The API token must include the following scopes: _Video_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Streams
       parameters:
@@ -1657,7 +1673,9 @@ paths:
         A list of past and in-progress Room Sessions.
 
         #### Permissions
-        The API token must include the following scopes: _Video_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - name: room_id
           in: query
@@ -1820,7 +1838,9 @@ paths:
         Find a Room Session by ID.
 
         #### Permissions
-        The API token must include the following scopes: _Video_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - name: id
           in: path
@@ -1945,7 +1965,9 @@ paths:
         A list of Room Recordings for a particular Room Session.
 
         #### Permissions
-        The API token must include the following scopes: _Video_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - name: id
           in: path
@@ -2043,7 +2065,9 @@ paths:
         A list of Members for a particular Room Session.
 
         #### Permissions
-        The API token must include the following scopes: _Video_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - name: id
           in: path
@@ -2112,7 +2136,9 @@ paths:
         Generate a Room Token allowing a client to join a Room.
 
         #### Permissions
-        The API token must include the following scopes: _Video_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Room Tokens
       requestBody:
@@ -2304,7 +2330,9 @@ paths:
         A list of all Room Recordings.
 
         #### Permissions
-        The API token must include the following scopes: _Video_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - name: media_ttl
           in: query
@@ -2395,7 +2423,9 @@ paths:
         A detailed summary of a particular Room Recording.
 
         #### Permissions
-        The API token must include the following scopes: _Video_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - name: id
           in: path
@@ -2476,7 +2506,9 @@ paths:
         Delete a Room Recording.
 
         #### Permissions
-        The API token must include the following scopes: _Video_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Room Recordings
       parameters:
@@ -2498,7 +2530,9 @@ paths:
         Create a Video Conference.
 
         #### Permissions
-        The API token must include the following scopes: _Video_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Conferences
       requestBody:
@@ -2874,7 +2908,9 @@ paths:
         List Video Conferences.
 
         #### Permissions
-        The API token must include the following scopes: _Video_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Conferences
       parameters:
@@ -3172,7 +3208,9 @@ paths:
         Find a Video Conference by ID.
 
         #### Permissions
-        The API token must include the following scopes: _Video_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Conferences
       parameters:
@@ -3442,7 +3480,9 @@ paths:
         Update a Video conference.
 
         #### Permissions
-        The API token must include the following scopes: _Video_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Conferences
       parameters:
@@ -3826,7 +3866,9 @@ paths:
         Delete a Video Conference.
 
         #### Permissions
-        The API token must include the following scopes: _Video_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Conferences
       parameters:
@@ -3846,7 +3888,9 @@ paths:
       summary: List Streams by Conference
       description: |
         #### Permissions
-        The API token must include the following scopes: _Video_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Streams
       parameters:
@@ -3908,7 +3952,9 @@ paths:
       summary: Create a Stream for a Conference
       description: |
         #### Permissions
-        The API token must include the following scopes: _Video_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Streams
       parameters:
@@ -3982,7 +4028,9 @@ paths:
         List conference tokens.
 
         #### Permissions
-        The API token must include the following scopes: _Video_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Conference Tokens
       parameters:
@@ -4043,7 +4091,9 @@ paths:
         Find a conference token by ID.
 
         #### Permissions
-        The API token must include the following scopes: _Video_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Conference Tokens
       parameters:
@@ -4088,7 +4138,9 @@ paths:
         Reset a conference token by ID.
 
         #### Permissions
-        The API token must include the following scopes: _Video_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Conference Tokens
       parameters:
@@ -4133,7 +4185,9 @@ paths:
         List the available logs.
 
         #### Permissions
-        The API token must include the following scopes: _Video_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Logs
       parameters:
@@ -4266,7 +4320,9 @@ paths:
         Find a log by ID.
 
         #### Permissions
-        The API token must include the following scopes: _Video_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Logs
       parameters:
@@ -4350,7 +4406,9 @@ paths:
       summary: Find a Stream by ID
       description: |
         #### Permissions
-        The API token must include the following scopes: _Video_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Streams
       parameters:
@@ -4407,7 +4465,9 @@ paths:
       summary: Delete a Stream
       description: |
         #### Permissions
-        The API token must include the following scopes: _Video_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Streams
       parameters:
@@ -4426,7 +4486,9 @@ paths:
       summary: Update a Stream
       description: |
         #### Permissions
-        The API token must include the following scopes: _Video_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Video_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       tags:
         - Streams
       parameters:
diff --git a/specs/signalwire-rest/voice-api/_spec_.yaml b/specs/signalwire-rest/voice-api/_spec_.yaml
index f157dd239..ffb01f995 100644
--- a/specs/signalwire-rest/voice-api/_spec_.yaml
+++ b/specs/signalwire-rest/voice-api/_spec_.yaml
@@ -47,7 +47,7 @@ paths:
         List the available logs.
 
         #### Permissions
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
       tags:
         - Logs
       parameters:
@@ -191,7 +191,7 @@ paths:
         Find a log by ID.
 
         #### Permissions
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
       tags:
         - Logs
       parameters:
diff --git a/specs/signalwire-rest/voice-api/logs/main.tsp b/specs/signalwire-rest/voice-api/logs/main.tsp
index d59547601..5911b5fc8 100644
--- a/specs/signalwire-rest/voice-api/logs/main.tsp
+++ b/specs/signalwire-rest/voice-api/logs/main.tsp
@@ -20,7 +20,9 @@ namespace VoiceAPI.Logs {
       
       #### Permissions
       
-      The API token must include the following scopes: _Voice_.
+      The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+      
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       """)
     list(...LogListRequest):
       | LogListResponse
@@ -33,8 +35,10 @@ namespace VoiceAPI.Logs {
       Find a log by ID.
 
       #### Permissions
-
-      The API token must include the following scopes: _Voice_.
+      
+      The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+      
+      [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       """)
     retrieve(...LogPathID):
       | LogRetrieveResponse
diff --git a/specs/signalwire-rest/voice-api/tsp-output/@typespec/openapi3/openapi.yaml b/specs/signalwire-rest/voice-api/tsp-output/@typespec/openapi3/openapi.yaml
index a9fab7440..04c22c3f7 100644
--- a/specs/signalwire-rest/voice-api/tsp-output/@typespec/openapi3/openapi.yaml
+++ b/specs/signalwire-rest/voice-api/tsp-output/@typespec/openapi3/openapi.yaml
@@ -30,7 +30,9 @@ paths:
 
         #### Permissions
 
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/LogListRequest.include_deleted'
         - $ref: '#/components/parameters/LogListRequest.created_before'
@@ -73,7 +75,9 @@ paths:
 
         #### Permissions
 
-        The API token must include the following scopes: _Voice_.
+        The API token used to authenticate must have the following scopes enabled to make a successful request: _Voice_.
+
+        [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).
       parameters:
         - $ref: '#/components/parameters/LogPathID'
       responses:
diff --git a/specs/swml/Methods/ai/ai_params.tsp b/specs/swml/Methods/ai/ai_params.tsp
index 577d9b760..1e11f38be 100644
--- a/specs/swml/Methods/ai/ai_params.tsp
+++ b/specs/swml/Methods/ai/ai_params.tsp
@@ -376,9 +376,9 @@ model AIParams {
   @example(1024)
   max_response_tokens?: integer | SWMLVar;
 
-  @doc("The ASR (Automatic Speech Recognition) engine to use. Common values include `nova-2` and `nova-3`.")
+  @doc("The ASR (Automatic Speech Recognition) engine to use. Common values include `deepgram:nova-2`, `deepgram:nova-3`, and other supported ASR engines.")
   @example("nova-3")
-  openai_asr_engine?: string = "gcloud_speech_v2_async";
+  openai_asr_engine?: "nova-2" | "nova-3";
 
   @doc("Sets a time duration for the outbound call recipient to respond to the AI agent before timeout, in a range from `10000` to `600000`. **Default:** `120000` ms (2 minutes).")
   @minValue(10000)