Entitlements

The following are Autonomous Identity filtering by entitlements endpoints:

GET Filters by Entt Owners

Get filterable attributes and values by entitlement owner. NOTE: This endpoint has been moved to the Filters API.

Endpoint

/api/entitlements/filters?by=entitlementOwner&ownerId=timothy.slack

Authorization

<Bearer Token JWT-value>

GET Filters by Supervisor: Get filterable attributes and values by supervisors. NOTE: This endpoint has been moved to the Filters API.

Endpoint

/api/entitlements/filters?by=supervisor&ownerId=albert.pardini

Authorization

<Bearer Token JWT-value>

Body

by	     supervisor
ownerId	 albert.pardini

Example Request

curl --location --request GET '/api/entitlements/filters?by=supervisor&ownerId=albert.pardini' \
--header 'content-type: application/json'

POST Statistics by Entt Owner: Get entitlement statistics for entitlement owners with optional filters.

Endpoint

/api/entitlements/stats?by=entitlementOwner

Authorization

<Bearer Token JWT-value>

Params

by	     entitlementOwner

Body

{
	"ownerId": "timothy.slack",
	"isHighRiskOnly": true,
	"isMediumLowRiskOnly": false,
	"isUserEntitlementsIncluded": true,
	"filters": [{
		"type": "app_id",
		"group": "criticality",
		"value": "Essential"
	}]
}

Example Request

curl --location --request POST '/api/entitlements/stats?by=entitlementOwner' \
--header 'content-type: application/json' \
--data-raw '{
	"ownerId": "timothy.slack",
	"isHighRiskOnly": true,
	"isMediumLowRiskOnly": false,
	"isUserEntitlementsIncluded": true,
	"filters": [{
		"type": "app_id",
		"group": "criticality",
		"value": "Essential"
	}]
}'

POST Statistics by Supervisor: Get entitlement statistics for supervisors with optional filters.

Endpoint

/api/entitlements/stats?by=supervisor

Authorization

<Bearer Token JWT-value>

Params

by	     supervisor

Body

{
	"ownerId": "albert.pardini",
	"isHighRiskOnly": true,
	"isMediumLowScoreOnly": true,
	"isUserEntitlementsIncluded": true,
	"filters": [{
		"type": "app_id",
		"group": "criticality",
		"value": "Essential"
	}]
}

Example Request

curl --location --request POST '/api/entitlements/stats?by=supervisor' \
--header 'content-type: application/json' \
--data-raw '{
	"ownerId": "albert.pardini",
	"isHighRiskOnly": true,
	"isMediumLowScoreOnly": true,
	"isUserEntitlementsIncluded": true,
	"filters": [{
		"type": "app_id",
		"group": "criticality",
		"value": "Essential"
	}]
}'

GET unscoredEntitlements by Entt Owner: Get unscored entitlements for a given entitlement owner’s user ID.

Endpoint

/api/entitlements/unscored?by=enttOwner&user=userId

Authorization

<Bearer Token JWT-value>

Params

by	     supervisor or enttOwner
user     user ID

Example Request

curl --location --request GET '/api/entitlements /unscored?by=enttOwner&user=albert.pardini' \
--header 'content-type: application/json'

GET unscoredEntitlements by Supervisor: Get unscored entitlements for a given supervisor’s user ID.

Endpoint

/api/entitlements/unscored?by=supervisor&user=userId

Authorization

<Bearer Token JWT-value>

Params

by	     supervisor or enttOwner
user     user ID

Example Request

curl --location --request GET '/api/entitlements /unscored?by=supervisor&user=albert.pardini' \
--header 'content-type: application/json'

GET search: Search for entitlements by name and with applied filters

Endpoint

/api/entitlements/search?q=QueryString

Authorization

<Bearer Token JWT-value>

Params

by	     appOwner or enttOwner
user     user ID
q        Search query string (required)
appId    Application ID to use as a filter

Example Request

curl --location --request GET '/api/entitlements/search?by=enttOwner&user=john.doe&q=WEB&appId=Salesforce' \
--header 'Content-Type: application/json'

GET entitlements/{entitlementId}: Get an entitlement’s statistics and list of assigned uers. NOTE: This endpoint replaces the previous singleViewWithApp/entitlements/entitlementId endpoint.

Endpoint

/api/entitlements/{entitlement id}

Authorization

<Bearer Token JWT-value>

Example Request

curl --location --request GET '/api/entitlements/0ac4b36b-20d9-4848-a923-0084a7aa581d' \
--header 'Content-Type: application/json'

Example Response

{
  "entitlement_name": "string",
  "scores": {
    "avg": 0,
    "high": 0,
    "medium": 0,
    "low": 0
  },
  "drivingFactors": [
    {
      "attribute": {
        "id": "string",
        "title": "string",
        "value": "string"
      },
      "count": 0
    }
  ],
  "userScores": [
    {
      "score": 0,
      "count": 0
    }
  ],
  "users": [
    {
      "user": "string",
      "user_name": "string",
      "app_id": "string",
      "freq": 0,
      "frequnion": 0,
      "justification": [
        {
          "title": "string",
          "value": "string"
        }
      ],
      "rawJustification": [
        "string"
      ],
      "score": 0
    }
  ]
}