chore: update all examples (openapi-ts#1640)

* chore: update all examples

* Add additional examples to script

* Update docs deps

Author: drwpow

examples/digital-ocean-api.ts

@@ -159,50 +159,8 @@ tags:
       which is used in some of the following requests. Each slug denotes the node's identifier,
       CPU count, and amount of RAM, in that order.
 
-      For **Basic nodes**, reference the following table for its slug:
-
-      Slug               | CPU     | RAM
-      -------------------|---------|---------
-      db-s-1vcpu-1gb     | 1 vCPU  | 1 GB
-      db-s-1vcpu-2gb     | 1 vCPU  | 2 GB
-      db-s-2vcpu-4gb     | 2 vCPU  | 4 GB
-      db-s-4vcpu-8gb     | 4 vCPU  | 8 GB
-      db-s-6vcpu-16gb    | 6 vCPU  | 16 GB
-      db-s-8vcpu-32gb    | 8 vCPU  | 32 GB
-      db-s-16vcpu-64gb   | 16 vCPU | 64 GB
-
-      For **General Purpose nodes**, reference the following table for its slug:
-
-      Slug               | CPU     | RAM
-      -------------------|---------|---------
-      gd-2vcpu-8gb       | 2 vCPU  | 8 GB
-      gd-4vcpu-16gb      | 4 vCPU  | 16 GB
-      gd-8vcpu-32gb      | 8 vCPU  | 32 GB
-      gd-16vcpu-64gb     | 16 vCPU | 64 GB
-      gd-32vcpu-128gb    | 32 vCPU | 128 GB
-      gd-40vcpu-160gb    | 40 vCPU | 160 GB
-
-      For **Storage-Optimized nodes**, reference the following table for its slug:
-
-      Slug               | CPU     | RAM
-      -------------------|---------|---------
-      so1_5-2vcpu-16gb   | 2 vCPU  | 16 GB
-      so1_5-4vcpu-32gb   | 4 vCPU  | 32 GB
-      so1_5-8vcpu-64gb   | 8 vCPU  | 64 GB
-      so1_5-16vcpu-128gb | 16 vCPU | 128 GB
-      so1_5-24vcpu-192gb | 24 vCPU | 192 GB
-      so1_5-32vcpu-256gb | 32 vCPU | 256 GB
-
-      For **Memory-Optimized nodes**, reference the following table for its slug:
-
-      Slug               | CPU     | RAM
-      -------------------|---------|---------
-      m-2vcpu-16gb       | 2 vCPU  | 16 GB
-      m-4vcpu-32gb       | 4 vCPU  | 32 GB
-      m-8vcpu-64gb       | 8 vCPU  | 64 GB
-      m-16vcpu-128gb     | 16 vCPU | 128 GB
-      m-24vcpu-192gb     | 24 vCPU | 192 GB
-      m-32vcpu-256gb     | 32 vCPU | 256 GB
+      For a list of currently available database slugs and options, use the `/v2/databases/options` endpoint or use the 
+      `doctl databases options` [command](https://docs.digitalocean.com/reference/doctl/reference/databases/options).
 
   - name: Domain Records
     description: |-
@@ -793,6 +751,10 @@ paths:
       $ref: 'resources/databases/databases_list_replicas.yml'
     post:
       $ref: 'resources/databases/databases_create_replica.yml'
+  
+  /v2/databases/{database_cluster_uuid}/events:
+    get:
+      $ref: 'resources/databases/databases_events_logs.yml'
 
   /v2/databases/{database_cluster_uuid}/replicas/{replica_name}:
     get:
@@ -815,6 +777,8 @@ paths:
       $ref: 'resources/databases/databases_get_user.yml'
     delete:
       $ref: 'resources/databases/databases_delete_user.yml'
+    put:
+      $ref: 'resources/databases/databases_update_user.yml'
 
   /v2/databases/{database_cluster_uuid}/users/{username}/reset_auth:
     post:
@@ -876,6 +840,12 @@ paths:
     delete:
        $ref: 'resources/databases/databases_delete_kafka_topic.yml'
 
+  /v2/databases/metrics/credentials:
+    get:
+      $ref: 'resources/databases/databases_get_cluster_metrics_credentials.yml'
+    put:
+      $ref: 'resources/databases/databases_update_cluster_metrics_credentials.yml'
+
   /v2/domains:
     get:
       $ref: 'resources/domains/domains_list.yml'
@@ -1577,8 +1547,9 @@ components:
         authenticate.
 
         The DigitalOcean API handles this through OAuth, an open standard for
-        authorization. OAuth allows you to delegate access to your account in full
-        or in read-only mode.
+        authorization. OAuth allows you to delegate access to your account.
+        Scopes can be used to grant full access, read-only access, or access to
+        a specific set of endpoints.
 
         You can generate an OAuth token by visiting the [Apps & API](https://cloud.digitalocean.com/account/api/tokens)
         section of the DigitalOcean control panel for your account.
@@ -1597,6 +1568,31 @@ components:
         - `doo_v1_` for tokens generated by applications using [the OAuth flow](https://docs.digitalocean.com/reference/api/oauth-api/)
         - `dor_v1_` for OAuth refresh tokens
 
+        ### Scopes
+
+        Scopes act like permissions assigned to an API token. These permissions
+        determine what actions the token can perform. You can create API
+        tokens that grant read-only access, full access, or limited access to
+        specific endpoints by using custom scopes.
+
+        Generally, scopes are designed to match HTTP verbs and common CRUD
+        operations (Create, Read, Update, Delete).
+
+        | HTTP Verb | CRUD Operation | Scope |
+        |---|---|---|
+        | GET | Read | `<resource>:read` |
+        | POST | Create | `<resource>:create` |
+        | PUT/PATCH | Update | `<resource>:update` |
+        | DELETE | Delete | `<resource>:delete` |
+
+        For example, creating a new Droplet by making a `POST` request to the
+        `/v2/droplets` endpoint requires the `droplet:create` scope while
+        listing Droplets by making a `GET` request to the `/v2/droplets`
+        endpoint requires the `droplet:read` scope.
+
+        Each endpoint below specifies which scope is required to access it when
+        using custom scopes.
+
         ### How to Authenticate with OAuth
 
         In order to make an authenticated request, include a bearer-type

examples/digital-ocean-api/DigitalOcean-public.v2.yaml

@@ -40,4 +40,4 @@ x-codeSamples:
 
 security:
   - bearer_auth:
-    - 'write'
+    - '1click:create'

examples/digital-ocean-api/resources/1-clicks/oneClicks_install_kubernetes.yml

@@ -38,5 +38,5 @@ x-codeSamples:
 
 security:
   - bearer_auth:
-    - 'read'
+    - '1click:read'
 

examples/digital-ocean-api/resources/1-clicks/oneClicks_list.yml

@@ -30,5 +30,5 @@ x-codeSamples:
 
 security:
   - bearer_auth:
-    - 'read'
+    - 'account:read'
 

examples/digital-ocean-api/resources/account/account_get.yml

@@ -37,5 +37,5 @@ x-codeSamples:
 
 security:
   - bearer_auth:
-    - 'read'
+    - 'actions:read'
 

examples/digital-ocean-api/resources/actions/actions_get.yml

@@ -37,5 +37,5 @@ x-codeSamples:
 
 security:
   - bearer_auth:
-    - 'read'
+    - 'actions:read'
 

examples/digital-ocean-api/resources/actions/actions_list.yml

@@ -45,4 +45,4 @@ x-codeSamples:
 
 security:
   - bearer_auth:
-    - 'write'
+    - 'app:update'

examples/digital-ocean-api/resources/apps/apps_assign_alertDestinations.yml

@@ -36,4 +36,4 @@ x-codeSamples:
 
 security:
   - bearer_auth:
-    - 'write'
+    - 'app:update'

examples/digital-ocean-api/resources/apps/apps_cancel_deployment.yml

@@ -36,4 +36,4 @@ x-codeSamples:
 
 security:
   - bearer_auth:
-    - 'write'
+    - 'app:update'