add links to ssh key endpoints

resources/ssh_keys/create_a_new_key.yml

@@ -38,6 +38,19 @@ responses:
       application/json:
         schema:
           $ref: 'models/wrapped_ssh_key.yml'
+
+    links:
+      GetSSHKeyById:
+        $ref: 'links/get_ssh_key_by_id.yml'
+
+      GetSSHKeyByFingerprint:
+        $ref: 'links/get_ssh_key_by_fingerprint.yml'
+
+      DeleteSSHKeyById:
+        $ref: 'links/delete_ssh_key_by_id.yml'
+
+      DeleteSSHKeyByFingerprint:
+        $ref: 'links/delete_ssh_key_by_fingerprint.yml'
 
   '401':
     $ref: '../../shared/responses/unauthorized.yml'

resources/ssh_keys/links/delete_ssh_key_by_fingerprint.yml

@@ -0,0 +1,8 @@
+operationId: destroy_a_key
+
+parameters:
+  ssh_key_identifier: '$response.body#/ssh_key/fingerprint'
+
+description: >-
+  The `fingerprint` value returned in the response can be used as the 
+  `ssh_key_identifier` parameter in `DELETE /v2/account/keys/{ssh_key_identifier}`.

resources/ssh_keys/links/delete_ssh_key_by_id.yml

@@ -0,0 +1,8 @@
+operationId: destroy_a_key
+
+parameters:
+  ssh_key_identifier: '$response.body#/ssh_key/id'
+
+description: >-
+  The `id` value returned in the response can be used as the 
+  `ssh_key_identifier` parameter in `DELETE /v2/account/keys/{ssh_key_identifier}`.

resources/ssh_keys/links/get_ssh_key_by_fingerprint.yml

@@ -0,0 +1,9 @@
+operationId: retrieve_an_existing_key
+
+parameters:
+  ssh_key_identifier: '$response.body#/ssh_key/fingerprint'
+
+description: >-
+  The `fingerprint` value returned in the response can be used as the 
+  `ssh_key_identifier` parameter in `GET /v2/account/keys/{ssh_key_identifier}`.
+

resources/ssh_keys/links/get_ssh_key_by_id.yml

@@ -0,0 +1,9 @@
+operationId: retrieve_an_existing_key
+
+parameters:
+  ssh_key_identifier: '$response.body#/ssh_key/id'
+
+description: >-
+  The `id` value returned in the response can be used as the 
+  `ssh_key_identifier` parameter in `GET /v2/account/keys/{ssh_key_identifier}`.
+

resources/ssh_keys/responses/existing_key.yml

@@ -13,4 +13,18 @@ headers:
 content:
   application/json:
     schema:
-      $ref: '../models/ssh_key.yml'
+      $ref: '../models/wrapped_ssh_key.yml'
+
+links:
+  GetSSHKeyById:
+    $ref: '../links/get_ssh_key_by_id.yml'
+
+  GetSSHKeyByFingerprint:
+    $ref: '../links/get_ssh_key_by_fingerprint.yml'
+
+  DeleteSSHKeyById:
+    $ref: '../links/delete_ssh_key_by_id.yml'
+
+  DeleteSSHKeyByFingerprint:
+    $ref: '../links/delete_ssh_key_by_fingerprint.yml'
+

resources/ssh_keys/update_a_key.yml

@@ -28,21 +28,8 @@ requestBody:
 
 responses:
   '200':
-    description: OK
-
-    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'
-
+    $ref: 'responses/existing_key.yml'
+
   '401':
     $ref: '../../shared/responses/unauthorized.yml'