v50

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-0193273218.8 KB
Security

List roles

List roles. Optional: filter based on role name and principal.

get/v1/roles

Query parameters

filter.name_prefixstring

Filter results only roles named with the prefix.

filter.name_containsstring

Filter results to only roles with names which contain the string.

filter.principalstring

Return only roles assigned to this principal. The principal must contain the principal type. For example: "User:jane" is a valid principal format.

page_sizeinteger

Page size.

page_tokenstring

Value of the next_page_token field returned by the previous response. If not provided, the system assumes the first page is requested.

Response

OK

next_page_tokenstring

Token to retrieve the next page.