add Create SSH Key endpoint

DigitalOcean-public.v2.yaml

@@ -33,6 +33,9 @@ paths:
     get:
       $ref: 'resources/ssh_keys/list_all_keys.yml'
 
+    post:
+      $ref: 'resources/ssh_keys/create_a_new_key.yml'
+
   /account/keys/{ssh_key_identifier}:
     get:
       $ref: 'resources/ssh_keys/retrieve_an_existing_key.yml'

resources/ssh_keys/attributes/ssh_key_fingerprint.yml

@@ -2,6 +2,9 @@ type: string
 
 description: >-
   A unique identifier that differentiates this key from other keys using 
-  a format that SSH recognizes.
+  a format that SSH recognizes. The fingerprint is created when the key
+  is added to your account.
+
+readOnly: true
 
 example: 3b:16:bf:e4:8b:00:8b:b8:59:8c:a9:d3:f0:19:45:fa

resources/ssh_keys/attributes/ssh_key_id.yml

@@ -4,4 +4,6 @@ description: >-
   A unique identification number for this key. Can be used to embed a 
   specific SSH key into a Droplet.
 
+readOnly: true
+
 example: 512189

resources/ssh_keys/create_a_new_key.yml

@@ -0,0 +1,51 @@
+operationId: create_a_new_key
+
+summary: Add a SSH public key to your account.
+
+description: >-
+  To add a new SSH public key to your DigitalOcean account, send a POST request to `/v2/account/keys`. 
+  Set the "name" attribute to the name you wish to use and the "public_key" attribute 
+  to the full public key you are adding.
+
+tags:
+  - SSH Keys
+
+requestBody:
+  description: >-
+    Set the "name" attribute to the name you wish to use and the "public_key" attribute
+    to the full public key you are adding.
+
+  required: true
+
+  content:
+    application/json:
+      schema:
+        $ref: 'models/ssh_key.yml'
+
+responses:
+  '201':
+    description: Created
+
+    headers:
+      ratelimit-limit:
+        $ref: '../../shared/headers.yml#/ratelimit-limit'
+      ratelimit-remaining:
+        $ref: '../../shared/headers.yml#/ratelimit-remaining'
+      ratelimit-reset:
+        $ref: '../../shared/headers.yml#/ratelimit-reset'
+
+    content:
+      application/json:
+        schema:
+          $ref: 'models/wrapped_ssh_key.yml'
+
+  '401':
+    $ref: '../../shared/responses/unauthorized.yml'
+
+  '500':
+    $ref: '../../shared/responses/server_error.yml'
+
+  default:
+    $ref: '../../shared/responses/unexpected_error.yml'
+
+

resources/ssh_keys/destroy_a_key.yml

@@ -10,7 +10,6 @@ description: >-
   the response body is empty.
 
 tags:
-  - Account
   - SSH Keys
 
 parameters:

resources/ssh_keys/list_all_keys.yml

@@ -9,7 +9,6 @@ description: >-
   the standard ssh_key attributes.
 
 tags:
-  - Account
   - SSH Keys
 
 parameters:

resources/ssh_keys/models/wrapped_ssh_key.yml

@@ -0,0 +1,8 @@
+type: object
+
+properties:
+  ssh_key:
+    $ref: 'ssh_key.yml'
+
+required:
+  - ssh_key

resources/ssh_keys/retrieve_an_existing_key.yml

@@ -10,7 +10,6 @@ description: >-
   object which contains the standard ssh_key attributes.
 
 tags:
-  - Account
   - SSH Keys
 
 parameters: