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.