feat(spec/search): add vault endpoints to spec (APIC-196)

specs/search/paths/vault/appendSource.yml

@@ -1 +1,24 @@
 post:
+  tags:
+    - vault
+  operationId: appendSource
+  description: Add a single source to the list of allowed sources.
+  requestBody:
+    required: true
+    description: The sources to allow
+    content:
+      application/json:
+        schema:
+          $ref: './common/schemas.yml#/sourceObject'
+  responses:
+    '200':
+      description: OK
+      content:
+        application/json:
+          schema:
+            title: appendSourceResponse
+            type: object
+            additionalProperties: false
+            properties:
+              createdAt:
+                $ref: '../../../common/parameters.yml#/updatedAt'

specs/search/paths/vault/common/schemas.yml

@@ -0,0 +1,2 @@
+updatedAt:
+  $ref: '../../../common/parameters.yml#/updatedAt'

specs/search/paths/vault/deleteSource.yml

@@ -1 +1,25 @@
 delete:
+  tags:
+    - vault
+  operationId: deleteSource
+  description: Remove a single source from the list of allowed sources.
+  parameters:
+    - name: source
+      in: path
+      required: true
+      description: The IP range of the source
+      schema:
+        type: string
+        example: "10.0.0.1/32"
+  responses:
+    '200':
+      description: OK
+      content:
+        application/json:
+          schema:
+            title: deleteSourceResponse
+            type: object
+            additionalProperties: false
+            properties:
+              deletedAt:
+                $ref: '../../../common/parameters.yml#/updatedAt'

specs/search/paths/vault/vaultSources.yml

@@ -1,2 +1,43 @@
 get:
+  tags:
+    - vault
+  operationId: getSources
+  description: List all allowed sources.
+  responses:
+    '200':
+      description: OK
+      content:
+        application/json:
+          schema:
+            title: listSourceResponse
+            type: array
+            items:
+              $ref: './common/schemas.yml#/sourceObject'
+
 put:
+  tags:
+    - vault
+  operationId: replaceSources
+  description: Replace all allowed sources.
+  requestBody:
+    required: true
+    description: The sources to allow
+    content:
+      application/json:
+        schema:
+          title: sourceObjectList
+          type: array
+          items:
+            $ref: './common/schemas.yml#/sourceObject'
+  responses:
+    '200':
+      description: OK
+      content:
+        application/json:
+          schema:
+            title: replaceSourceResponse
+            type: object
+            additionalProperties: false
+            properties:
+              updatedAt:
+                $ref: '../../../common/parameters.yml#/updatedAt'

specs/search/spec.yml

@@ -120,12 +120,12 @@ paths:
   # #######################
   # ### Vault Endpoints ###
   # #######################
-  # /1/security/sources:
-  #   $ref: './paths/vault/vaultSources.yml'
-  # /1/security/sources/append:
-  #   $ref: './paths/vault/appendSource.yml'
-  # /1/security/sources/{source}:
-  #   $ref: './paths/vault/deleteSource.yml'
+  /1/security/sources:
+    $ref: './paths/vault/vaultSources.yml'
+  /1/security/sources/append:
+    $ref: './paths/vault/appendSource.yml'
+  /1/security/sources/{source}:
+    $ref: './paths/vault/deleteSource.yml'
 
   # ##########################
   # ### Advanced Endpoints ###