For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
      • AstroFully-managed data operations, powered by Apache Airflow.
      • Astro Private CloudRun Airflow-as-a-service in your environment.
      • Professional ServicesExpert Airflow services for your enterprise's success.
    • Tools
      • Cosmos
      • Orbiter
      • CLI
      • AI SDK
      • Agents
      • Blueprint
      • UpdatesThe State of Airflow 2026See the insights from over 5,800 data practitioners in the full report. Download Now ➔
  • Customers
  • Docs
    • Insights
      • Blog
      • Webinars
      • Resource Library
      • Events
    • Education
      • Academy
      • What is Airflow?
  • Pricing
Get Started Free
    • Astro CLI
    • Quickstart
    • CLI reference
      • astro completion
      • astro api
      • astro auth
      • astro config
      • astro context
      • astro dbt
      • astro deploy
      • astro deployment
      • astro dev
      • astro ide
      • astro login
      • astro logout
      • astro organization
        • astro organization audit-logs
        • astro organization list
        • astro organization switch
        • astro organization role list
        • astro organization team create
        • astro organization team delete
        • astro organization team list
        • astro organization team update
        • astro organization team user
        • astro organization token create
        • astro organization token delete
        • astro organization token list
        • astro organization token roles
        • astro organization token rotate
        • astro organization token update
        • astro organization user invite
        • astro organization user list
        • astro organization user update
      • astro otto
      • astro remote
      • astro run
      • astro team
      • astro telemetry
      • astro user create
      • astro version
      • astro workspace

Product

  • Platform Overview
  • Astro
  • Astro Observe
  • Astro Private Cloud
  • Security & Trust
  • Pricing

Tools & Services

  • Cosmos
  • Docs
  • Professional Services
  • Product Updates

Use Cases

  • AI Ops
  • Data Observability
  • ETL/ELT
  • ML Ops
  • Operational Analytics
  • All Use Cases

Industries

  • Financial Services
  • Gaming
  • Retail
  • Manufacturing
  • Healthcare
  • All Industries

Resources

  • Academy
  • eBooks & Guides
  • Blog
  • Webinars
  • Events
  • The Data Flowcast Podcast
  • All Resources

Airflow

  • What is Airflow
  • Airflow on Astro
  • Airflow 3.0
  • Airflow Upgrades
  • Airflow Use Cases
  • Airflow 2.x End of Life

Company

  • Our Story
  • Customers
  • Newsroom
  • Careers
  • Contact

Support

  • Knowledge Base
  • Status
  • Contact Support
GitHubYouTubeLinkedInx
  • Legal
  • Privacy
  • Terms of Service
  • Consent Preferences

  • Do Not Sell or Share My Personal information
  • Limit the Use Of My Sensitive Personal Information

Apache Airflow®, Airflow, and the Airflow logo are trademarks of the Apache Software Foundation. Copyright © Astronomer 2026. All rights reserved.

LogoLogo
CLI referenceastro organization

astro organization role list

This command is only available on Astro.

View a list of all roles in an Organization.

Usage

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,

1astro organization role list --include-default-roles

Options

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

Output

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