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 service-account

Edit this page
Built with
This command is available only if you’re authenticated to an Astro Private Cloud installation.

Usage

This command has several subcommands.

astro workspace service-account create

Creates a service account for a given Workspace.

Usage

1astro workspace service-account create --workspace-id=<your-workspace> --label=<your-label>

Options

OptionDescriptionPossible Values
--workspace-id (Required)The Workspace you’re creating a service account for.Any valid Workspace ID
--label (Required)A label for the service account.Any string
--categoryThe Category for the service account. The default is Not set.Any string
roleThe User Role for the service account.Possible values are WORKSPACE_VIEWER, WORKSPACE_EDITOR, WORKSPACE_ADMIN. The default value is WORKSPACE_VIEWER.

Related documentation

  • Manage Workspaces and Deployments on Astronomer

astro workspace service-account delete

Deletes a service account for a given Workspace.

Usage

1astro workspace service-account delete <your-service-account-id>

Options

OptionDescriptionPossible Values
--workspace-idThe Workspace in which you want to delete a service account. If this flag is used instead of specifying <your-service-account-id>, you’ll be prompted to select a service account from a list of all service accounts on the Workspace.Any valid Workspace ID

Related documentation

  • Manage Workspaces and Deployments on Astronomer

astro workspace service-account get

Shows the name, ID, and API token for each service account on a given Workspace.

Usage

Run astro deployment service-account get <service-account-id> --workspace-id=<your-workspace-id> to get information on a single service account within a Workspace. To see a list of all service accounts on a Workspace, run astro deployment service-account get --workspace-id=<your-workspace-id>.

Options

OptionDescriptionPossible Values
--workspace-idThe Workspace you’re getting the service account from. Use this flag as an alternative to specifying <your-service-account-id>.Any valid Workspace ID

Related documentation

  • Manage Workspaces and Deployments on Astronomer