chore: add docs for okta scim role support

Author: b4s36t4

images/scim/okta/add-attribute.png

@@ -59,6 +59,43 @@ Whenever you assign a `User` or `Group` to the application, Okta automatically p
 
 ---
 
+### Organisation role support
+
+Portkey supports the following organisation roles:
+
+- **`owner`**  (Organization Owner)
+- **`admin`**  (Organization Admin)
+- **`member`**  (Organization Member)
+
+Users assigned any other role will default to the **member** role.
+
+#### Editing Attributes
+
+Okta by default doesn't support role attributes. To support role attributes, you need to edit the attributes in Okta.
+
+1. Navigate to the app settings. Under general settings, click on the `Provisioning` tab.
+
+2. Click on the `Go to Profile Editor` button, found under **Attribute Mappings** section.
+
+3. Click on the `Add Attribute` button.
+
+4. Fill the form with the following details:
+
+    ![Edit Attribute List](/images/scim/okta/add-attribute.png)
+
+5. Click on the `Save` button.
+
+#### Verifying the changes
+
+To verify the changes, you can assign a user to the application with the desired role (e.g., **`owner`**, **`member`**, or **`admin`**) for the organization.
+
+    ![Assigning Roles](/images/scim/okta/select-roles.png)
+
+<Warning>
+    Make sure to select only **one** role for a user, if multiple selected user will be assigned to highest qualified role.
+</Warning>
+---
+
 ### Group Provisioning with Okta
 
 Portkey supports RBAC (Role-Based Access Control) for workspaces mapped to groups in Okta. Use the following naming convention for groups: