# Get user roles

This endpoint retrieves a list of roles for the account of the calling user.

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.

Was this article helpful?