For AI agents: a documentation index is available at the root level at /llms.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
  • v1beta1 deprecation notice
  • Migrate to v1
  • List Organizations
  • Get an Organization
  • Update an Organization
  • Get Organization audit logs
  • List alerts
  • Create an alert
  • Get an alert
  • Update an alert
  • Delete an alert
  • Get cluster options
  • Get Deployment options
  • List clusters
  • Create a cluster
  • Get a cluster
  • Update a cluster
  • Delete a cluster
  • List Deployments
  • Create a Deployment
  • Get a Deployment
  • Update a Deployment
  • Delete a Deployment
  • Configure a hibernation override for a deployment
  • Delete a hibernation override for a deployment
  • List deploys for a deployment
  • Create a Deploy
  • Get a deploy for a deployment
  • Update a Deploy
  • Finalize a deploy
  • Deploy rollback of a deployment
  • List environment objects
  • Create a new environment object
  • Get environment object
  • Update an environment object
  • Delete an environment object
  • Exclude linking an environment object
  • List Alert Notification Channels
  • Create an Alert Notification Channel
  • Get an Alert Notification Channel
  • Update an Alert Notification Channel
  • Delete an Alert Notification Channel
  • List Workspaces
  • Create Workspace
  • Get Workspace
  • Update Workspace
  • Delete Workspace
  • Changelog
  • April 2, 2026
  • September 17, 2025
  • July 30, 2025
  • July 14, 2025
  • June 30, 2025
  • May 14, 2025
  • May 12, 2025
  • April 23, 2025
  • February 26, 2025
  • December 10, 2024
  • November 19, 2024
  • November 13, 2024
  • September 9, 2024
  • July 31, 2024
  • July 10, 2024
  • June 18, 2024
  • June 11, 2024
  • May 15, 2024
  • April 23, 2024
  • April 12, 2024
  • List authorization permission groups
  • List allowed IP address ranges
  • Create an allowed IP address range
  • Delete an allowed IP address range
  • List Agent API Tokens
  • Create an Agent API token
  • Get an Agent API Token
  • Delete an Agent API Token
  • Create a user invitation
  • Delete a user invite
  • Get role templates
  • List roles
  • Create a custom role
  • Update custom role
  • Delete a custom role
  • Get a custom role
  • List Teams
  • Create a Team
  • Get a Team
  • Update a Team
  • Delete a Team
  • List Team members
  • Add members to a team
  • Remove Team member
  • Update Team roles
  • List API tokens
  • Create an API token
  • Get an API token
  • Update an API token
  • Delete an API token
  • Update API token roles
  • Rotate API token
  • List users in an Organization
  • Get user information
  • Update a user's roles
  • Changelog
  • April 2, 2026
  • September 17, 2025
  • December 10, 2024
  • July 31, 2024
  • April 12, 2024

Changelog

Apr 2, 2026

Summary

Added Disaster Recovery (DR) support to various cluster and deployment schemas, including new properties for DR configuration. Introduced new permissions for alert, environment object, and…

Added

Schemas and Properties: Cluster: drRegion: Secondary region for DR. drSecondaryVpcCidr: Secondary CIDR for DR region (AWS only). drVpcSubnetRange: VPC subnet range for DR region (AWS only).…

Changed

Schemas: Cluster: Removed description from vpcSubnetRange. Added drRegion and isDrEnabled to required properties. OrganizationProductPlan: Changed astronomerProduct enum value from "ASTRO OBSERVE" to…

Sep 17, 2025

Summary

Added a new pattern property to the ConnectionAuthTypeParameter schema, which specifies a regex pattern for the parameter. Introduced a new enum value SNOWFLAKE_MARKETPLACE to the paymentMethod…

Added

ConnectionAuthTypeParameter Schema pattern: A new property with a description "A regex pattern for the parameter" and type string. Organization Schema paymentMethod Enum SNOWFLAKE_MARKETPLACE: Added…

Changed

No changes were made to existing objects, schemas, fields, endpoints, or enum values.

Jul 30, 2025

Summary

Added new properties apiUrl and uiUrl to the Deployment schema, providing URLs for accessing the Airflow API and UI respectively. For Airflow 2, the apiUrl and uiUrl point to the webserver. For…

Added

New properties in the Deployment schema: apiUrl: Description: The base URL to directly access the Airflow API. uiUrl: Description: The URL to access the Airflow UI.

Jul 14, 2025

Summary

Added support for specifying authentication type when configuring metrics export settings for environments and environment objects.

Added

New authType property added to the following schema objects to define the type of authentication used when connecting to a remote endpoint for metrics export from Astro:…

Jun 30, 2025

Summary

You can now create and update Airflow 3 Hosted Execution Deployments with the AstroExecutor via the Platform API. You can now create and update Airflow 3 Remote Execution Deployments with the…

Added

New properties to support creating and updating Remote Execution Deployments on Astro: DeploymentRemoteExecution DeploymentRemoteExecutionRequest New ENUMs for executor types were added to the…

Changed

In /organizations/{organizationId}/alerts, removed the ORGANIZATION and WORKSPACE ENUMs that you can use to search within the entityType for the PatternMatchRequest object.

May 14, 2025

Summary

Added the new productPlans property and OrganizationProductPlan schema to the Organization object.

May 12, 2025

Summary

Added new enums for the supportPlan property. To learn more about the different support plans available for Astro, see Pricing.

Added

The new enums include the following: INACTIVE INTERNAL POV BASIC_PAYGO TEAM_PAYGO BUSINESS TEAM ENTERPRISE DEVELOPER DEVELOPER_PAYGO TEAM_V2 BUSINESS_V2 ENTERPRISE_V2 TRIAL_V2

Apr 23, 2025

Summary

Added the PatternMatchRequest object, and changed the schema name of PatternMatch to PatternMatchRequest for alerts object properties when working with alerts rules.

Added

Added the PatternMatchRequest object, which includes the following properties: entityType operatorType values Changed the schema name of PatternMatch to PatternMatchRequest for the following alerts…

Feb 26, 2025

Summary

Added the ability to work with Astro Alerts and their Notification Channels through the Astro API, with the new alerts and notification-channels endpoints.

Dec 10, 2024

Summary

Added the new schmea, bundle, as a deploy type for the Deploy endpoint, allowing you to use dbt deploys via the Astro API.

Older posts

Next
Built with

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