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 deployment airflow upgrade
          • astro deployment token create
          • astro deployment token delete
          • astro deployment token list
          • astro deployment token organization-token
          • astro deployment token rotate
          • astro deployment token update
          • astro deployment token workspace-token
        • astro deployment create
        • astro deployment delete
        • astro deployment hibernate
        • astro deployment inspect
        • astro deployment list
        • astro deployment logs
        • astro deployment runtime migrate
        • astro deployment runtime upgrade
        • astro deployment service-account
        • astro deployment team
        • astro deployment update
        • astro deployment user
        • astro deployment wake-up
      • 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

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 deploymentastro deployment token

astro deployment token update

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

Update an Astro Deployment API Token.

To use your API token in an automated process, see Authenticate an automation tool.

Usage

1astro deployment token update --deployment-id=MOCK_DEP_ID

Options

OptionDescriptionPossible Values
-d, --descriptionUpdated description of the token. If the description contains a space, specify the entire description in quotes "".String
-t,--nameThe current name of the token. If the name contains a space, specify the entire name within quotes "".String
-n, --new-nameThe token’s new name. If the new name contains a space, specify the entire name within quotes "".String
-r, --roleThe role for the token. Possible values are DEPLOYMENT_ADMIN or a custom role name.Any valid Deployment role.

Examples

$# The CLI prompts you to input a role for a token with Token ID assigned to a specific Deployment
$astro deployment token update <token-id> --deployment-id=clukapi6r000008l58530cg8i
$
$# The CLI prompts you to input a role for a token identified by its name
$astro deployment token update --deployment-id=clukapi6r000008l58530cg8i --name="Token name"
$
$# The CLI prompts you to select the token from a list and input a role
$astro deployment token update --deployment-id=clukapi6r000008l58530cg8i
$
$# This command assigns a token with the specified TOKEN_ID the role `Deployment Admin` to a Deployment with the following ID.
$astro deployment token update TOKEN_ID --deployment-id=clukapi6r000008l58530cg8i --role=DEPLOYMENT_ADMIN

Related Commands

  • astro deployment token create
  • astro deployment token list
  • astro deployment token rotate