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
On this page
  • astro workspace organization-token add
  • Usage
  • Options
  • Example
  • astro workspace organization-token list
  • Usage
  • Options
  • Output
  • astro workspace organization-token remove
  • Usage
  • Options
  • Example
  • astro workspace organization-token update
  • Usage
  • Options
  • Example
CLI referenceastro workspace

astro workspace token organization-token

Edit this page
Built with
This command is only available on Astro.

Manage Organization-level API tokens within a specific Workspace. See Assign an Organization API token to a Workspace.

There are four sub-commands for managing a Workspace-scoped Organization token.

astro workspace organization-token add

Add an Organization API token to a Workspace and grant it Workspace-specific permissions.

Usage

1astro workspace organization-token add --org-token-name=<organization-token-name> --role=<workspace-role>

Options

OptionDescriptionValid Values
-n, --org-token-nameThe name of the Organization API token.Any string. If the name contains a space, specify the entire name within quotes "".
-r, --roleThe role the API token has in the Workspace.One of WORKSPACE_MEMBER, WORKSPACE_AUTHOR, WORKSPACE_OPERATOR or WORKSPACE_OWNER.
--workspace-idThe Workspace to add the token to.Any Workspace ID.

Example

1astro workspace organization-token add --org-token-name="My Organization" --role=WORKSPACE_OWNER

astro workspace organization-token list

List all Organization API tokens that are assigned to a specific Workspace.

Usage

1astro workspace organization-token list

Options

OptionDescriptionValid Values
--workspace-idThe Workspace to which the API tokens belong.Any Workspace ID.

Output

OutputDescriptionData Type
IDThe API token ID.String
NAMEThe name of the API token.String
DESCRIPTIONThe API token description.String
SCOPEThe original scope of the API token.String
WORKSPACE_ROLEThe API token’s role in the Workspace.String
CREATEDHow long ago the API token was created, in days.String
CREATED BYThe name of the user who created the API token.String

astro workspace organization-token remove

Remove an Organization API token from a Workspace.

Usage

1astro workspace organization-token remove

Options

OptionDescriptionValid Values
-n,--org-token-nameThe name of the Organization API token you want to remove from the Workspace.Any string.
--workspace-idWorkspace where you want to remove an API token.Any Workspace ID.

Example

1astro workspace organization-token remove

astro workspace organization-token update

Update the role an Organization API token has within a Workspace.

Usage

1astro workspace organization-token update --workspace-id=<workspace-id> --role=<workspace-role>

Options

OptionDescriptionValid Values
-n, --org-token-nameThe name of the Organization API token you want to update.Any string.
-r, --roleThe Workspace role that you want to assign to the token.One of WORKSPACE_MEMBER, WORKSPACE_AUTHOR, WORKSPACE_OPERATOR or WORKSPACE_OWNER.
--workspace-idThe Workspace where you want to update the token.Any Workspace ID.

Example

1astro workspace organization-token add --workspace-id=clvdx7z3c000008kv5tdw5tc5 --org-token-name="My organization token" --role=WORKSPACE_AUTHOR