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
    • Overview
        • Deployment API tokens
        • Custom Deployment roles
        • Authorize Deployments to cloud resources
        • Transfer a Deployment
      • Billing
    • Book Office Hours

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
  • Prerequisites
  • Transfer a Deployment to another Workspace
AdministrationDeployments

Transfer a Deployment to a different Workspace

Transferring a Deployment can be helpful when your team needs to change user access to a Deployment. Transferring a Deployment moves all Dags, task history, connections, and other Astro configurations to another Workspace. This process doesn’t affect your task scheduling or any currently running tasks.

Prerequisites

  • You must be a Workspace Owner or Operator in both the original Workspace and the target Workspace.
  • The Workspaces must be in the same Organization.
  • Deployments can’t be transferred to a different cluster from the one in which they were created.
  • Only the users who are members of the target Workspace can access the Deployment after it is transferred.

Transfer a Deployment to another Workspace

  1. In the Astro UI, select a Workspace, click Deployments, and then select a Deployment.

  2. Click the Options menu and select Transfer Deployment.

    Transfer Deployment in options menu

  3. Select the target Workspace where you want to transfer the Deployment.

  4. Click Transfer Deployment.

Edit this page
Built with