Changelog

September 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 property of the Organization schema.

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 as a new payment method option.

Changed

  • No changes were made to existing objects, schemas, fields, endpoints, or enum values.
July 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 Airflow 3 Deployments, these point to the API server.
  • Updated the Deployment schema to require the apiUrl and uiUrl properties.

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.
July 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:
    • EnvironmentObjectMetricsExport
    • EnvironmentObjectMetricsExportOverrides
    • CreateEnvironmentObjectMetricsExportRequest
    • UpdateEnvironmentObjectMetricsExportRequest
    • UpdateEnvironmentObjectMetricsExportOverridesRequest

Property Details

  • authType: Defines the type of authentication to use when connecting to the remote endpoint.
    • Supported values:
      • BASIC
      • AUTH_TOKEN
June 30, 2025

Summary

Added

  • New properties to support creating and updating Remote Execution Deployments on Astro:
    • DeploymentRemoteExecution
    • DeploymentRemoteExecutionRequest
  • New ENUMs for executor types were added to the executor property to support creating Hosted execution Deployments:
    • Astro
  • Date-time and format examples for the following properties:
    • createdAt
    • updatedAt

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
April 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 objects:

  • CreateDagDurationAlertRules
  • CreateDagFailureAlertRules
  • CreateDagSuccessAlertRules
  • CreateDagTimelinessAlertRules
  • CreateTaskDurationAlertRules
  • CreateTaskFailureAlertRules
  • UpdateDagDurationAlertRules
  • UpdateDagFailureAlertRules
  • UpdateDagSuccessAlertRules
  • UpdateDagTimelinessAlertRules
  • UpdateTaskDurationAlertRules
  • UpdateTaskFailureAlertRules
February 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.

Added

New endpoints:

  • GET /organizations/{organizationId}/alerts to list Alerts in a Workspace or Deployment.
  • POST /organizations/{organizationId}/alerts to create an Alert for a Deployment or Workspace.
  • GET /organizations/{organizationId}/alerts/{alertId} to retrieve details about a specific Alert.
  • POST /organizations/{organizationId}/alerts/{alertId} to update an existing Alert.
  • DEL /organizations/{organizationId}/alerts/{alertId} to delete an Alert.
  • GET /organizations/{organizationId}/notification-channels to list Alert Notification Channels.
  • POST /organizations/{organizationId}/notification-channels to create an Alert Notification Channel.
  • GET /organizations/{organizationId}/alerts/{notificationChannelId} to retrieve details about a specific Alert Notification Channel.
  • POST /organizations/{organizationId}/alerts/{notificationChannelId} to update an existing Alert Notification Channel.
  • DEL /organizations/{organizationId}/alerts/{notificationChannelId} to delete an Alert Notification Channel.
December 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.

Added

New object schema for the Deploy object at /organizations/{organizationId}/deployments/{deploymentId}/deploys:

  • Bundle

Which includes the following new properties:

  • bundleType
  • currentVersion
  • deployId
  • desiredVersion
  • mountPath

New properties are also added to the following endpoints:

  • POST organizations/{organizationId}/deployments/{deploymentId}/deploys

    • bundleMountPath
    • bundleType

  • GET organizations/{organizationId}/deployments/{deploymentId}/deploys/{deployId}

    • bundleMountPath
    • bundleUploadUrl
    • bundles

  • POST organizations/{organizationId}/deployments/{deploymentId}/deploys/{deployId}/finalize:

    • bundleTarballVersion
November 19, 2024

Summary

Added the ability to retrieve audit logs using the Astro API call, GET /organizations/{organizationId}/audit-logs. You can also use the parameters startDate and endDate to limit the number of logs you retrieve to a particular timescale.

See Audit logs reference for more information.

Added

  • GET /organizations/{organizationId}/audit-logs - to retrieve audit logs via the API. Note that this API call has a non-configurable rate limit of 2 per minute.