# Get roles

This endpoint retrieves a list of roles for the account of the requesting user with the "name", "created_ts", and "updated_ts" attributes.

Method Path Operation*
GET /roles/ get_user_roles

*

In order for a user to perform the "get_user_roles" operation, the "get_user_roles" permission must be included in the list of allowed actions in the statement of the user's role.

# Request

No parameters.

# Response

Attribute Type Description
uuid string Role UUID.
name string Name of the role. It must match the regular expression (opens new window) [0-9A-Za-z][0-9A-Za-z_ \-]{0,30}[0-9A-Za-z]. It does not need to be unique in the context of the account.
created_ts timestamp Time at which the role was created. Measured in seconds (to three decimal places) that have elapsed since the Unix epoch (opens new window).
updated_ts timestamp Time at which the role was last updated. Measured in seconds (to three decimal places) that have elapsed since the Unix epoch (opens new window).

# Status codes

Requests to this endpoint result in generic status codes. For a comprehensive list of status codes, please consult the Status Codes section.