Skip to main content

astro organization role list

astro only
This command is only available on Astro.

View a list of all roles in an Organization.


Run astro organization role list to view a list of the custom and default user roles in your Organization and their IDs. By default, only custom roles are displayed. To create a custom role, see Create and assign custom Deployment roles

If you want to view the Astro-defined user roles and their IDs, you need to add the --include-default-roles flag. For example,

astro organization role list --include-default-roles


OptionDescriptionPossible Values
--include-default-rolesDisplay the Astro-defined user roles in the organization.Any of the available user roles.


OutputDescriptionData Type
NAMEThe name of the role.String
IDThe custom role ID.String
DESCRIPTIONA description of the user role.String

Was this page helpful?

Sign up for Developer Updates

Get a summary of new Astro features once a month.

You can unsubscribe at any time.
By proceeding you agree to our Privacy Policy, our Website Terms and to receive emails from Astronomer.