Retrieve

Get

get/api/v1/iam/roles/{role_id}

Get a role by id.

Path Parameters

role_idstring

The roleId field.

Returns

roleidstringcreatedAtstringdeletedAtstringdisplayNamestringnamestringpermissionsarray of stringserviceRolesarray of stringsystemApiOnlybooleansystemBuiltinbooleanupdatedAtstringRole

optional

Role is a role that can be assigned to a user in ConductorOne.

Request example cURL

curl https://{tenantDomain}.conductor.one/api/v1/iam/roles/$ROLE_ID \
    -H "Authorization: Bearer $CONDUCTORONE_SDK_API_KEY"

200 Example

{
  "role": {
    "displayName": "displayName",
    "permissions": [
      "string"
    ],
    "serviceRoles": [
      "string"
    ]
  }
}