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 API v1beta1
    • v1beta1 deprecation notice
    • Migrate to v1
  • Platform API Reference
    • Changelog
  • IAM API Reference
    • Changelog
    • 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
  • Key changes
  • Important dates
Astro API v1beta1

Astro API v1beta1 deprecation notice

Astronomer is transitioning the Astro API from the Beta version (v1beta1) to the stable v1 API. This document describes the key differences between v1beta1 and v1, and outlines the deprecation timeline for v1beta1 endpoints.

Key changes

  1. API Consolidation:

    • The IAM and Platform APIs have been consolidated into a single v1 API. Previously, you had to work with two separate APIs:

      • https://api.astronomer.io/iam/v1beta1/
      • https://api.astronomer.io/platform/v1beta1/

      These are now unified under:

      • https://api.astronomer.io/v1/

    • See the v1 migration guide for more on migrating to the consolidated v1 API

  2. Unsupported Endpoints:

    • Alert and Notification Channel APIs currently are not supported in v1. If your integrations rely on programmatic alert or notification channel management, you will need to update your workflows.

  3. Enhanced Stability:

    • Astro API v1 is designed for production use with a stable contract. The v1 API provides clearer versioning expectations, improved consistency, and stronger support commitments for long-term integrations.

Important dates

  • January 28, 2026: General Availability of Astro API v1. The v1 API becomes available with full production support.
  • January, 2027: End of support for v1beta1 API. The v1beta1 API will no longer receive maintenance, updates, or support after this date. You have a 12-month migration window to transition to v1.

Until end of support in January 2027, the v1beta1 API remains fully supported.

Edit this page
Built with