add DELETE /v2/account/keys/{ssh_key_identifier}

DigitalOcean-public.v2.yaml

@@ -35,6 +35,9 @@ paths:
     get:
       $ref: 'resources/ssh_keys/retrieve_an_existing_key.yml'
 
+    delete:
+      $ref: 'resources/ssh_keys/destroy_a_key.yml'
+
 components:
   securitySchemes:
     bearerAuth:

resources/ssh_keys/destroy_a_key.yml

@@ -0,0 +1,30 @@
+operationId: destroy_a_key
+
+summary: Delete an existing SSH key from your account.
+
+description: >-
+  To destroy a public SSH key that you have in your account, send a DELETE request 
+  to `/v2/account/keys/$KEY_ID` or `/v2/account/keys/$KEY_FINGERPRINT`.
+
+  A 204 status will be returned, indicating that the action was successful and that 
+  the response body is empty.
+
+tags:
+  - Account
+  - SSH Keys
+
+parameters:
+  - $ref: 'parameters/ssh_key_identifier.yml'
+
+responses:
+  '204':
+    $ref: '../../shared/responses/no_content.yml'
+
+  '401':
+    $ref: '../../shared/responses/unauthorized.yml'
+
+  '404':
+    $ref: '../../shared/responses/not_found.yml'
+
+  default:
+    $ref: '../../shared/responses/unexpected_error.yml'

shared/responses/no_content.yml

@@ -0,0 +1,9 @@
+description: The action was successful and the response body is empty.
+
+headers:
+  ratelimit-limit:
+    $ref: '../headers.yml#/ratelimit-limit'
+  ratelimit-remaining:
+    $ref: '../headers.yml#/ratelimit-remaining'
+  ratelimit-reset:
+    $ref: '../headers.yml#/ratelimit-reset'