From 98fae664dcafe63c4d17607a52310e60f90902e7 Mon Sep 17 00:00:00 2001
From: developer-relations-sp <devrel-service@sailpoint.com>
Date: Fri, 10 Jan 2025 15:35:40 +0000
Subject: [PATCH] Automated commit 'Merge pull request #59 from
 sailpoint/NERRA-1795

NERRA-1795: Add documentation for the isc_accounts API endpoint' by github action: 12712499763
---
 nerm/parameters/query/category.yaml   |  7 +++++++
 nerm/parameters/query/use_schema.yaml |  8 ++++++++
 nerm/paths/isc_account.yaml           | 15 +++++++++++++++
 nerm/paths/isc_accounts.yaml          | 18 ++++++++++++++++++
 nerm/responses/IscAccounts.yaml       | 10 ++++++++++
 5 files changed, 58 insertions(+)
 create mode 100644 nerm/parameters/query/category.yaml
 create mode 100644 nerm/parameters/query/use_schema.yaml
 create mode 100644 nerm/paths/isc_account.yaml
 create mode 100644 nerm/paths/isc_accounts.yaml
 create mode 100644 nerm/responses/IscAccounts.yaml

diff --git a/nerm/parameters/query/category.yaml b/nerm/parameters/query/category.yaml
new file mode 100644
index 00000000..5cb6498f
--- /dev/null
+++ b/nerm/parameters/query/category.yaml
@@ -0,0 +1,7 @@
+name: category
+in: query
+description: The category parameter is used to retrieve profiles belonging to profile types categorized under the allowed schema mapping categories. The permitted categories allowed are 'non-employee' and 'assignment'.
+required: false
+schema:
+  type: string
+  example: non-employee
diff --git a/nerm/parameters/query/use_schema.yaml b/nerm/parameters/query/use_schema.yaml
new file mode 100644
index 00000000..09d1ba22
--- /dev/null
+++ b/nerm/parameters/query/use_schema.yaml
@@ -0,0 +1,8 @@
+name: use_schema
+in: query
+description: The use_schema parameter returns schema-mapped field names in the Profiles API response when set to true.
+required: false
+schema:
+  type: boolean
+  default: false
+  example: true
diff --git a/nerm/paths/isc_account.yaml b/nerm/paths/isc_account.yaml
new file mode 100644
index 00000000..9fe78570
--- /dev/null
+++ b/nerm/paths/isc_account.yaml
@@ -0,0 +1,15 @@
+get:
+  summary: Retrieve single schema-mapped profile
+  operationId: getSingleSchemaMappedProfile
+  description: It returns a single stored profile, optionally with schema-mapped field names.
+  tags:
+    - isc accounts
+  parameters:
+    - $ref: "../parameters/path/id.yaml"
+  responses:
+    '200':
+      $ref: "../responses/Profile.yaml"
+    '400':
+      $ref: "../responses/400.yaml"
+    '500':
+      $ref: "../responses/500.yaml"
diff --git a/nerm/paths/isc_accounts.yaml b/nerm/paths/isc_accounts.yaml
new file mode 100644
index 00000000..1cf2787f
--- /dev/null
+++ b/nerm/paths/isc_accounts.yaml
@@ -0,0 +1,18 @@
+get:
+  summary: Retrieve schema-mapped profiles collection
+  operationId: getSchemaMappedProfilesCollection
+  description: It returns a collection of stored profiles, optionally using schema-mapped field names if requested.
+  tags:
+    - isc accounts
+  parameters:
+    - $ref: "../parameters/query/category.yaml"
+    - $ref: "../parameters/query/page.yaml"
+    - $ref: "../parameters/query/per_page.yaml"
+    - $ref: "../parameters/query/use_schema.yaml"
+  responses:
+    '200':
+      $ref: "../responses/IscAccounts.yaml"
+    '400':
+      $ref: "../responses/400.yaml"
+    '500':
+      $ref: "../responses/500.yaml"
diff --git a/nerm/responses/IscAccounts.yaml b/nerm/responses/IscAccounts.yaml
new file mode 100644
index 00000000..12ee4fe0
--- /dev/null
+++ b/nerm/responses/IscAccounts.yaml
@@ -0,0 +1,10 @@
+description: Expected response to a valid request
+content:
+  application/json:
+    schema:
+      type: object
+      properties:
+        profiles:
+          type: array
+          items:
+            $ref: '../schemas/GET/Profile.yaml'