Autonomous Identity 2022.11.10

Assignments

The following endpoint has been added to support the extraction of assignments. New APIs introduced in this release are marked with .

POST /api/assignments

POST /api/assignments

Get a list of all assignments or filtered assignments when the following optional filtering is sent as a JSON request body.

The endpoint requires a valid API key passed in a X-API-KEY header for authorization (refer to Generate an API key) or an authorized admin-level bearer token.

Endpoint

+

/api/assignments

Headers

+

Content-Type      application/json

Body Parameters

Parameter Type Description

cursor

string

Cursor to send for the next page of assignments (the response returns null if there are no more pages)

pageSize

integer

Number of assignments to return per page

ent_id

string

Entitlement ID to filter by

usr_id

string

User ID to filter by

app_id

string

Application ID to filter by

Example Request

+

curl -k -X POST \
https://autoid-ui.forgerock.com/api/assignments \
-H 'X-API-KEY: <api key value>' \
-H 'Content-Type: application/json' \
-d '{
  "pageSize": 20,
  "cursor": "WyJhYXJvbi5maXNjaGVyIiwiV0VCX3VzZXJfU2hhcmVkX0VkaXRfQURNSU5fSUkiXQ=="
}'

Example Response

+

{
  "cursor": "WyJhYXJvbi5mb2x0eiIsIldlYl9TZXJ2aWNlQW5hbHl0aWNzIDogS1BJIEFnZW50IGFuZCBQb3dlciBBY2Nlc3NfSUkiXQ==",
  "assignments": [
   {
      "ent_id": "WEB_user_Web_Local Access 32 All_II_Europe",
      "usr_id": "aaron.fischer",
      "score": null,
      "justification": []
    },
   {
      "ent_id": "WEB_user_Web_Shared_Edit_ADMIN_Europe",
      "usr_id": "aaron.fischer",
      "score": null,
      "justification": []
   },
   {
      "ent_id": "WEB_user_Web_WEB RCQ Flare NonIT Distribution_Europe",
      "usr_id": "aaron.fischer",
      "score": 0.98,
      "justification": [
       {
          "id": "CHIEF_YES_NO",
          "title": "chief_yes_no",
          "value": "Yes"
       },
       {
          "id": "USR_DEPARTMENT_NAME",
          "title": "USR_DEPARTMENT_NAME",
          "value": "Information Systems 1"
       }
      ]
   },
   {
      "ent_id": "Web_Flare NonIT Distribution",
      "usr_id": "aaron.fischer",
      "score": 0.6,
      "justification": [
       {
         "id": "CITY",
         "title": "city",
         "value": "Jacksonville"
       },
       {
         "id": "USR_EMP_TYPE",
         "title": "usr_emp_type",
         "value": "Employee"
       },
       {
         "id": "LINE_OF_BUSINESS",
         "title": "line_of_business",
         "value": "Strategy and Policy"
       }
      ]
    }
  ]
}