Retrieve role

GET {{baseUrl}}/roles/:id?aid=1234

Returns detailed information about a role using its ID.

Request Params

KeyDatatypeRequiredDescription
aidnumberA unique identifier associated with your account group. You can retrieve your AccountGroupId from the /account-groups endpoint. Note that you must be assigned to the target account group. Specifying this parameter without being assigned to the target account group will result in an error response.

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{"name":"Organization Admin","roleId":"35","isBuiltin":false,"permissions":[{"label":"View reports","permissionId":"1","isManagementPermission":true,"permission":"REPORT_READ"},{"label":"View snapshots","permissionId":"51","isManagementPermission":false,"permission":"REPORT_SNAPSHOTS_READ"}],"_links":{"self":{"href":"https://api.thousandeyes.com/v7/link/to/resource/id","templated":true,"type":"ut et","deprecation":"consequat Ut dolor occaecat dolore","name":"magna ad","profile":"aute nulla sed","title":"ut dolore","hreflang":"pariatur aute incididunt"}}}