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 otto
      • astro remote
      • astro run
      • astro team
      • astro telemetry
      • astro user create
      • astro version
      • astro workspace
        • astro workspace create
        • astro workspace delete
        • astro workspace list
        • astro workspace service account
        • astro workspace switch
        • astro workspace team add
        • astro workspace team list
        • astro workspace team remove
        • astro workspace team update
        • astro workspace token add
        • astro workspace token create
        • astro workspace token delete
        • astro workspace token list
        • astro workspace token organization-token
        • astro workspace token rotate
        • astro workspace token update
        • astro workspace update
        • astro workspace user add
        • astro workspace user list
        • astro workspace user remove
        • astro workspace user update

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 workspace

astro workspace team add

Edit this page
Built with
The behavior and format of this command differs depending on what Astronomer product you’re using. Use the following tabs to change between product contexts.

Add a Team to your current Workspace and grant it a Workspace role.

Astro
APC

Usage

1astro workspace team add <options>

If you run the command with no options specified, the CLI lists Teams in your Organization and prompts you to select one. It then adds the Team to your current Workspace with the Workspace Member role.

To add a Team to a specific Workspace, specify the Workspace using the --workspace-id flag. To find a Workspace ID, run astro workspace list.

Options

OptionDescriptionValid Values
--team-idThe ID for the Team to add to a Workspace. Bypasses the selection prompt.Any valid Team ID. You can find available Team ID’s by running astro organization team list.
-r, --roleThe Team’s role in the Workspace.Possible values are WORKSPACE_ACCESSOR, WORKSPACE_MEMBER, WORKSPACE_AUTHOR, WORKSPACE_OPERATOR, or WORKSPACE_OWNER. Default is WORKSPACE_MEMBER.
--workspace-idThe ID for the Workspace where you want to add the Team.Any valid Workspace ID. Default is the current Workspace context you are working in.

Related commands

  • astro workspace team remove
  • astro organization team create
  • astro workspace switch