Returns a Role resource based on ID or name.

GET {{baseUrl}}/Roles/:roleId?lookupByName=<boolean>&attributes=<string>&excludedAttributes=<string>

The Role resource with matching ID or name is returned. Attributes to include in the response can be specified with the 'attributes' query parameter. Attributes to exclude from the response can be specified with the 'excludedAttributes' query parameter. The core schema is urn:ietf:params:scim:schemas:sailpoint:1.0:Role.

Request Params

KeyDatatypeRequiredDescription
lookupByNamestringA boolean value that determines if the Role resource will be looked up by name instead of Id (value in path parameter 'roleId'). Setting this query parameter to true will cause the value pulled from the 'roleId' path parameter to be treated as a name when searching for the resource.<br/><br/>Example: scim/v2/Roles/Data Analyst?lookupByName=true
attributesstringThe Role attributes to include in the response. The query parameter value is a comma-separated list of fields to be returned in the response for each Role.<br/><br/>Example: attributes=name,type<br/><br/> The attributes listed will be the only ones returned in the response, with the exception of id, schemas, and meta, which are always returned for a Role.
excludedAttributesstringThe Role attributes to exclude frome the response. The query parameter value is a comma-separated list of fields to be excluded from the response for each Role.<br/><br/>Example: excludedAttributes=permits,requirements<br/><br/> The attributes listed will be the only ones excluded frome the response, with the exception of id, schemas, and meta, which are always returned for a Role.

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{&quot;id&quot;:&quot;c0b4568a4fe7458c434ee77d1fbt156b&quot;,&quot;name&quot;:&quot;ADDirect-Production Manager&quot;,&quot;descriptions&quot;:[{&quot;locale&quot;:&quot;en_US&quot;,&quot;value&quot;:&quot;Directs production operations and processes for a plant, division, or company. Plans and maintains production schedules. Manages facilities and equipment maintenance.&quot;}],&quot;type&quot;:{&quot;iiq&quot;:false,&quot;requirements&quot;:false,&quot;permits&quot;:false,&quot;displayName&quot;:&quot;IT&quot;,&quot;manualAssignment&quot;:false,&quot;name&quot;:&quot;it&quot;,&quot;autoAssignment&quot;:false,&quot;assignmentSelector&quot;:false},&quot;displayableName&quot;:&quot;Staging Test Engineer - IT&quot;,&quot;active&quot;:true,&quot;activationDate&quot;:&quot;2022-02-11T01:08:45.866-05:00&quot;,&quot;deactivationDate&quot;:&quot;2022-02-11T01:08:45.866-05:00&quot;,&quot;owner&quot;:{&quot;displayName&quot;:&quot;id&quot;,&quot;value&quot;:&quot;ut ipsum irure est&quot;,&quot;$ref&quot;:&quot;ipsum Duis esse&quot;},&quot;inheritance&quot;:{&quot;displayName&quot;:&quot;et consectetur&quot;,&quot;value&quot;:&quot;laborum Lorem culpa in&quot;,&quot;$ref&quot;:&quot;fugiat&quot;},&quot;requirements&quot;:{&quot;displayName&quot;:&quot;tempor magna officia&quot;,&quot;value&quot;:&quot;magna sunt&quot;,&quot;$ref&quot;:&quot;ipsum in velit&quot;},&quot;permits&quot;:{&quot;displayName&quot;:&quot;sed nisi ut Excepteur commodo&quot;,&quot;value&quot;:&quot;est ut&quot;,&quot;$ref&quot;:&quot;ullamco et&quot;},&quot;classifications&quot;:{&quot;source&quot;:&quot;elit irure&quot;,&quot;effective&quot;:false,&quot;classification&quot;:{&quot;name&quot;:&quot;reprehe&quot;,&quot;displayName&quot;:&quot;ullam&quot;,&quot;origin&quot;:&quot;in eiusmod nulla ea&quot;,&quot;type&quot;:&quot;proident&quot;}},&quot;meta&quot;:{&quot;created&quot;:&quot;2022-02-11T01:34:04.074-05:00&quot;,&quot;location&quot;:&quot;http://localhost:8080/iiq/scim/v2/Roles/c0b4568a4fe7458c434ee77d1fbt156b&quot;,&quot;lastModified&quot;:&quot;2022-02-11T01:08:45.866-05:00&quot;,&quot;version&quot;:&quot;W/\\\&quot;1644561244074\\\&quot;&quot;,&quot;resourceType&quot;:&quot;Role&quot;},&quot;schemas&quot;:[&quot;urn:ietf:params:scim:schemas:sailpoint:1.0:Role&quot;]}