Automated commit 'Merge pull request #1534 from sailpoint/iiatsenko/PLTUI-7030

PLTUI-7030: Added spec for api method to update icon' by github action: 8420645682

idn/beta/paths/icon.yaml

@@ -0,0 +1,103 @@
+put:
+  operationId: setIcon
+  tags:
+    - Icons
+  summary: Update an icon
+  description: >-
+    This API endpoint updates an icon by object type and object id.
+    A token with ORG_ADMIN authority is required to call this API.
+  parameters:
+    - in: path
+      name: objectType
+      schema:
+        type: string
+      required: true
+      description: Object type. Available options ['application']
+      example: application
+    - in: path
+      name: objectId
+      schema:
+        type: string
+      required: true
+      description: Object id.
+      example: a291e870-48c3-4953-b656-fb5ce2a93169
+  requestBody:
+    required: true
+    content:
+      multipart/form-data:
+        schema:
+          type: object
+          required:
+            - image
+          properties:
+            image:
+              type: string
+              format: binary
+              description: file with icon. Allowed mime-types ['image/png', 'image/jpeg']
+              example: \x00\x00\x00\x02
+  security:
+    - UserContextAuth: [ ]
+  responses:
+    '200':
+      description:  Icon updated
+      content:
+        application/json:
+          schema:
+            type: object
+            properties:
+              icon:
+                type: string
+                description: url to file with icon
+                example: ""
+    '400':
+      $ref: '../../v3/responses/400.yaml'
+    '401':
+      $ref: '../../v3/responses/401.yaml'
+    '403':
+      $ref: '../../v3/responses/403.yaml'
+    '404':
+      $ref: '../../v3/responses/404.yaml'
+    '429':
+      $ref: '../../v3/responses/429.yaml'
+    '500':
+      $ref: '../../v3/responses/500.yaml'
+delete:
+  operationId: deleteIcon
+  tags:
+    - Icons
+  summary: Delete an icon
+  description: >-
+    This API endpoint delete an icon by object type and object id.
+    A token with ORG_ADMIN authority is required to call this API.
+  parameters:
+    - in: path
+      name: objectType
+      schema:
+        type: string
+      required: true
+      description: Object type. Available options ['application']
+      example: application
+    - in: path
+      name: objectId
+      schema:
+        type: string
+      required: true
+      description: Object id.
+      example: a291e870-48c3-4953-b656-fb5ce2a93169
+  security:
+    - UserContextAuth: [ ]
+  responses:
+    '204':
+      $ref: '../../v3/responses/204.yaml'
+    '400':
+      $ref: '../../v3/responses/400.yaml'
+    '401':
+      $ref: '../../v3/responses/401.yaml'
+    '403':
+      $ref: '../../v3/responses/403.yaml'
+    '404':
+      $ref: '../../v3/responses/404.yaml'
+    '429':
+      $ref: '../../v3/responses/429.yaml'
+    '500':
+      $ref: '../../v3/responses/500.yaml'

idn/sailpoint-api.beta.yaml

@@ -972,6 +972,10 @@ tags:
   - name: Workflows
     description: |
       Workflows allow administrators to create custom automation scripts directly within IdentityNow.  These automation scripts respond to [event triggers](https://developer.sailpoint.com/idn/docs/event-triggers#how-to-get-started-with-event-triggers) and perform a series of actions to perform tasks that are either too cumbersome or not available in the IdentityNow UI.  Workflows can be configured via a graphical user interface within IdentityNow, or by creating and uploading a JSON formatted script to the Workflow service.  The Workflows API collection provides the necessary functionality to create, manage, and test your workflows via REST.
+  - name: Icons
+    description: |
+      Use this API to implement functionality related to object icons (application icons for example). 
+      With this functionality in place, administrators can set or remove an icon for specific object type for use throughout IdentityNow.
 security:
   - UserContextAuth: [ ]
 
@@ -1725,3 +1729,5 @@ paths:
     $ref: "./beta/paths/account-usages.yaml"
   /access-request-identity-metrics/{identityId}/requested-objects/{requestedObjectId}/type/{type}:
     $ref: "./beta/paths/access-request-identity-metrics.yaml"
+  /icons/{objectType}/{objectId}:
+    $ref: './beta/paths/icon.yaml'

idn/v3/paths/branding.yaml

@@ -8,7 +8,7 @@ get:
     
     A token with API, ORG_ADMIN authority is required to call this API.
   security:
-    - UserContextAuth: [ idn:branding:read ]
+    - UserContextAuth: [ ]
   parameters:
     - in: path
       name: name
@@ -60,7 +60,7 @@ put:
         schema:
           $ref: '../schemas/BrandingItemCreate.yaml'
   security:
-    - UserContextAuth: [ idn:branding:write ]
+    - UserContextAuth: [ ]
   responses:
     '200':
       description:  Branding item updated
@@ -90,7 +90,7 @@ delete:
     
     A token with API, ORG_ADMIN authority is required to call this API.
   security:
-    - UserContextAuth: [ idn:branding:write ]
+    - UserContextAuth: [ ]
   parameters:
     - in: path
       name: name

idn/v3/paths/brandings.yaml

@@ -9,7 +9,7 @@ get:
 
     A token with API, ORG_ADMIN authority is required to call this API.
   security:
-    - UserContextAuth: [ idn:branding:read ]
+    - UserContextAuth: [ ]
   responses:
     '200':
       description: A list of branding items.
@@ -45,7 +45,7 @@ post:
         schema:
           $ref: '../schemas/BrandingItemCreate.yaml'
   security:
-    - UserContextAuth: [ idn:branding:write ]
+    - UserContextAuth: [ ]
   responses:
     '201':
       description:  Branding item created