List Roles

Required scope: role:read

Use stable role IDs returned here for invitations and member role replacement. pageSize defaults to 100 and is capped at 100. Discovery does not authorize delegation. See Manage Roles for administrative grants, replacement semantics, and the distinction from effective Customer View access.

Generated Reference

POST /public-api/publicapi.v1.Role/ListRoles

Lists at most page_size roles in the authenticated workspace. page_size defaults to 100.

Request ListRolesRequest

Response ListRolesResponse

ListRolesRequest

Field	Type
page_size	int32

ListRolesResponse

Field	Type
roles	repeated Role

Related Types

Role

Field	Type
id	string
name	string
description	string
is_default	bool
is_system	bool
requires_2fa	bool
is_owner	bool
created_at	int64
updated_at	int64

Request

{
  "pageSize": 100
}