| Field | Type | Required | Description | Example |
|---|---|---|---|---|
roleId |
String | ✔️ | A unique identifier for the role. | |
folderId |
Optional<String> | ➖ | * In the Get role endpoint, the specified folder_id is included in the policy_statement parameter of the response. If no folder_id is specified, the policy_statement shows a placeholder for the folder_id where relevant.* In the Get a principal's roles, Get a role's principals, and Inspect endpoints, the results are filtered by the specified folder_id. Only roles or principals with policy_statement parameters associated with that folder_id are returned. |
|
assetId |
Optional<String> | ➖ | Not currently supported. | |
collectionId |
Optional<String> | ➖ | * In the Get role endpoint, the specified collection_id is included in the policy_statement parameter of the response. If no collection_id is specified, the policy_statement shows a placeholder for the collection_id where relevant.* In the Get a principal's roles and Get a role's principals endpoints, the results are filtered by the specified collection_id. Only roles or principals with policy_statement parameters associated with that collection_id are returned. |
|
paramKey |
List<String> | ➖ | The type of content instance the role applies to, either folder_id or collection_id. Use together with param_value to retrieve role assignments as they apply to a specific instance. |
[ "folder_id" ] |
paramValue |
List<String> | ➖ | The ID of the content instance (for example, a specific folder or collection). Use together with param_key to retrieve roles as they apply to a specific instance. | [ "asdfjkl12347890" ] |