REST APIs for Oracle Identity Role Intelligence

List misaligned users in a candidate role

get

/oiri/api/v1/tasks/{taskId}/candidate-roles/{candidateRoleId}/misaligned-users

Request

Path Parameters

candidateRoleId: string
taskId: string

Supported Media Types

application/json

Root Schema : schema

Type: object

Show Source

page(optional): object page
recordCount(optional): integer
searchFilters(optional): string
sort(optional): object sort

{
    "properties":{
        "page":{
            "required":[
                "offset",
                "limit"
            ],
            "properties":{
                "offset":{
                    "type":"number"
                },
                "limit":{
                    "type":"number"
                }
            },
            "type":"object"
        },
        "sort":{
            "required":[
                "sortBy",
                "sortOrder"
            ],
            "properties":{
                "sortBy":{
                    "type":"string"
                },
                "sortOrder":{
                    "type":"string"
                }
            },
            "type":"object"
        },
        "searchFilters":{
            "type":"string"
        },
        "recordCount":{
            "type":"integer"
        }
    }
}

Nested Schema : page

Type: object

Show Source

limit: number
offset: number

{
    "required":[
        "offset",
        "limit"
    ],
    "properties":{
        "offset":{
            "type":"number"
        },
        "limit":{
            "type":"number"
        }
    },
    "type":"object"
}

Nested Schema : sort

Type: object

Show Source

sortBy: string
sortOrder: string

{
    "required":[
        "sortBy",
        "sortOrder"
    ],
    "properties":{
        "sortBy":{
            "type":"string"
        },
        "sortOrder":{
            "type":"string"
        }
    },
    "type":"object"
}

Response

Supported Media Types

application/json

200 Response

Root Schema : CandidateRoleUserResponse

Type: object

Show Source

data(optional): array data
recordCount(optional): integer

{
    "properties":{
        "recordCount":{
            "type":"integer"
        },
        "data":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/UserDTO"
            }
        }
    }
}

Nested Schema : data

Type: array

Show Source

Array of: object UserDTO

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/UserDTO"
    }
}

Nested Schema : UserDTO

Type: object

Show Source

customAttributes(optional): object customAttributes
departmentNumber(optional): string
employeeNumber(optional): string
employeeType(optional): string
jobCode(optional): string
managerDisplayName(optional): string
managerName(optional): string
misalignedCount(optional): integer
organizationName(optional): string
usage(optional): number
userDisplayName(optional): string
userKey(optional): string
userName(optional): string

{
    "properties":{
        "userKey":{
            "type":"string"
        },
        "userName":{
            "type":"string"
        },
        "employeeType":{
            "type":"string"
        },
        "jobCode":{
            "type":"string"
        },
        "managerName":{
            "type":"string"
        },
        "organizationName":{
            "type":"string"
        },
        "usage":{
            "type":"number"
        },
        "userDisplayName":{
            "type":"string"
        },
        "managerDisplayName":{
            "type":"string"
        },
        "employeeNumber":{
            "type":"string"
        },
        "departmentNumber":{
            "type":"string"
        },
        "misalignedCount":{
            "type":"integer"
        },
        "customAttributes":{
            "properties":{
                "map":{
                    "type":"object",
                    "properties":{
                        "value":{
                            "type":"string"
                        }
                    }
                }
            }
        }
    }
}

Nested Schema : customAttributes

Type: object

Show Source

map(optional): object map

{
    "properties":{
        "map":{
            "type":"object",
            "properties":{
                "value":{
                    "type":"string"
                }
            }
        }
    }
}

Nested Schema : map

Type: object

Show Source

value(optional): string

{
    "type":"object",
    "properties":{
        "value":{
            "type":"string"
        }
    }
}

Examples

The following example shows how to list misaligned users in a candidate role.

curl -X GET\
-H "Accept: application/json"\
-H "Content-Type: application/json"\
-H "Authorization: Bearer $token"\
"http://localhost:port/oiri/api/v1/tasks/70561adbfdd7474290b77d5903210c6b/candidate-roles/97d40d053dd74a45a6e944f45cbfae6a/misaligned-users"

Example of the Response Body

The following is an example of the response body in JSON format.

{
"limit": 5,
"offset": 0,
"recordCount": 5,
"count": 5,
"hasMore": false,
"items": [
{
"userKey": "G3004",
"userName": "AMODI",
"employeeType": "Consultant",
"jobCode": "M10002",
"managerName": "XELSYSADM",
"organizationName": "Xellerate Users",
"usage": null,
"userDisplayName": "Amit Modi",
"managerDisplayName": "System Administrator",
"employeeNumber": "100041",
"departmentNumber": "Sales",
"misalignedCount": 1,
"extUserId": "3004",
"customAttributes": null
},
{
"userKey": "G3007",
"userName": "KBUIZON",
"employeeType": "Full-Time",
"jobCode": "IC10003",
"managerName": "XELSYSADM",
"organizationName": "Xellerate Users",
"usage": null,
"userDisplayName": "Kevin Buizon",
"managerDisplayName": "System Administrator",
"employeeNumber": "100038",
"departmentNumber": "Development",
"misalignedCount": 1,
"extUserId": "3007",
"customAttributes": null
},
{
"userKey": "G3006",
"userName": "KDADAY",
"employeeType": "Consultant",
"jobCode": "IC10003",
"managerName": "XELSYSADM",
"organizationName": "test1",
"usage": null,
"userDisplayName": "Karl Daday",
"managerDisplayName": "System Administrator",
"employeeNumber": "100039",
"departmentNumber": "Development",
"misalignedCount": 1,
"extUserId": "3006",
"customAttributes": null
},
{
"userKey": "G3009",
"userName": "KDIAS",
"employeeType": "Full-Time",
"jobCode": "IC10004",
"managerName": "XELSYSADM",
"organizationName": "Xellerate Users",
"usage": null,
"userDisplayName": "Karl Dias",
"managerDisplayName": "System Administrator",
"employeeNumber": "100036",
"departmentNumber": "Doc",
"misalignedCount": 1,
"extUserId": "3009",
"customAttributes": null
},
{
"userKey": "G3001",
"userName": "KRUCKER",
"employeeType": "Consultant",
"jobCode": "M10004",
"managerName": "XELSYSADM",
"organizationName": "Xellerate Users",
"usage": null,
"userDisplayName": "Kal Rucker",
"managerDisplayName": "System Administrator",
"employeeNumber": "100044",
"departmentNumber": "PM",
"misalignedCount": 2,
"extUserId": "3001",
"customAttributes": null
}
]
}