Add Code Snippets to Spec Files

Author: DX-Bandwidth

site/specs/numbers.yml

@@ -40118,24 +40118,26 @@ paths:
       summary: Submit a toll-free verification request
       tags:
         - Toll-Free Verification
-  /accounts/{accountId}/tollFreeVerification/subscriptions/{id}:
-    delete:
-      description: Delete a webhook subscription by ID.
-      operationId: deleteWebhookSubscription
+  /accounts/{accountId}/tollFreeVerification/webhooks/subscriptions:
+    get:
+      description: >-
+        Provides a list of webhook subscriptions that are registered to receive
+        status updates for the toll-free verification requests submitted under
+        this account (password will not be returned through this API; if
+        `basicAuthentication` is defined, the `password` property of that object
+        will be null).
+      operationId: listWebhookSubscriptions
       parameters:
         - $ref: '#/components/parameters/AccountIdPathParam'
-        - $ref: '#/components/parameters/WebhookSubscriptionIdPathParam'
       responses:
-        '204':
-          $ref: '#/components/responses/webhookSubscriptionDeleted'
+        '200':
+          $ref: '#/components/responses/webhookSubscriptionsList'
         '400':
-          $ref: '#/components/responses/tfvBadRequestResponse'
+          $ref: '#/components/responses/tfvPostBadRequestResponse'
         '401':
           $ref: '#/components/responses/tfvUnauthorizedResponse'
         '403':
           $ref: '#/components/responses/tfvForbiddenResponse'
-        '404':
-          $ref: '#/components/responses/tfvNotFoundResponse'
         '405':
           $ref: '#/components/responses/tfvNotAllowedResponse'
         '429':
@@ -40144,22 +40146,26 @@ paths:
           $ref: '#/components/responses/tfvServerErrorResponse'
         '503':
           $ref: '#/components/responses/tfvServiceUnavailableResponse'
-      summary: Delete a webhook subscription
+      summary: List all webhook subscriptions registered for this account
       tags:
         - Toll-Free Verification
-    put:
+    post:
       description: >-
-        Update an existing webhook subscription (`callbackUrl` and
-        `basicAuthentication` can be updated).
-      operationId: updateWebhookSubscription
+        Create a new webhook subscription (this webhook will be called for every
+        update on every submission; is is also possible to register a one-time
+        callback URL as part of a submission itself). In addition to a
+        `callbackUrl`, this subscription can provide HTTP Basic authentication
+        credentials (a username and a password). The returned subscription
+        object will contain an ID that can be used to modify or delete the
+        subscription at a later time.
+      operationId: createWebhookSubscription
       parameters:
         - $ref: '#/components/parameters/AccountIdPathParam'
-        - $ref: '#/components/parameters/WebhookSubscriptionIdPathParam'
       requestBody:
         $ref: '#/components/requestBodies/webhookSubscriptionRequest'
       responses:
-        '200':
-          $ref: '#/components/responses/webhookSubscriptionUpdated'
+        '201':
+          $ref: '#/components/responses/webhookSubscriptionCreated'
         '400':
           $ref: '#/components/responses/tfvBadRequestResponse'
         '401':
@@ -40176,29 +40182,27 @@ paths:
           $ref: '#/components/responses/tfvServerErrorResponse'
         '503':
           $ref: '#/components/responses/tfvServiceUnavailableResponse'
-      summary: Update an existing webhook subscription
+      summary: Create a new webhook subscription
       tags:
         - Toll-Free Verification
-  /accounts/{accountId}/tollFreeVerification/webhooks/subscriptions:
-    get:
-      description: >-
-        Provides a list of webhook subscriptions that are registered to receive
-        status updates for the toll-free verification requests submitted under
-        this account (password will not be returned through this API; if
-        `basicAuthentication` is defined, the `password` property of that object
-        will be null).
-      operationId: listWebhookSubscriptions
+  /accounts/{accountId}/tollFreeVerification/webhooks/subscriptions/{id}:
+    delete:
+      description: Delete a webhook subscription by ID.
+      operationId: deleteWebhookSubscription
       parameters:
         - $ref: '#/components/parameters/AccountIdPathParam'
+        - $ref: '#/components/parameters/WebhookSubscriptionIdPathParam'
       responses:
-        '200':
-          $ref: '#/components/responses/webhookSubscriptionsList'
+        '204':
+          $ref: '#/components/responses/webhookSubscriptionDeleted'
         '400':
-          $ref: '#/components/responses/tfvPostBadRequestResponse'
+          $ref: '#/components/responses/tfvBadRequestResponse'
         '401':
           $ref: '#/components/responses/tfvUnauthorizedResponse'
         '403':
           $ref: '#/components/responses/tfvForbiddenResponse'
+        '404':
+          $ref: '#/components/responses/tfvNotFoundResponse'
         '405':
           $ref: '#/components/responses/tfvNotAllowedResponse'
         '429':
@@ -40207,26 +40211,22 @@ paths:
           $ref: '#/components/responses/tfvServerErrorResponse'
         '503':
           $ref: '#/components/responses/tfvServiceUnavailableResponse'
-      summary: List all webhook subscriptions registered for this account
+      summary: Delete a webhook subscription
       tags:
         - Toll-Free Verification
-    post:
+    put:
       description: >-
-        Create a new webhook subscription (this webhook will be called for every
-        update on every submission; is is also possible to register a one-time
-        callback URL as part of a submission itself). In addition to a
-        `callbackUrl`, this subscription can provide HTTP Basic authentication
-        credentials (a username and a password). The returned subscription
-        object will contain an ID that can be used to modify or delete the
-        subscription at a later time.
-      operationId: createWebhookSubscription
+        Update an existing webhook subscription (`callbackUrl` and
+        `basicAuthentication` can be updated).
+      operationId: updateWebhookSubscription
       parameters:
         - $ref: '#/components/parameters/AccountIdPathParam'
+        - $ref: '#/components/parameters/WebhookSubscriptionIdPathParam'
       requestBody:
         $ref: '#/components/requestBodies/webhookSubscriptionRequest'
       responses:
-        '201':
-          $ref: '#/components/responses/webhookSubscriptionCreated'
+        '200':
+          $ref: '#/components/responses/webhookSubscriptionUpdated'
         '400':
           $ref: '#/components/responses/tfvBadRequestResponse'
         '401':
@@ -40243,7 +40243,7 @@ paths:
           $ref: '#/components/responses/tfvServerErrorResponse'
         '503':
           $ref: '#/components/responses/tfvServiceUnavailableResponse'
-      summary: Create a new webhook subscription
+      summary: Update an existing webhook subscription
       tags:
         - Toll-Free Verification
   /accounts/{accountId}/totalSeats: