Changelog

April 2, 2026

Summary

  • Added new schemas for UserTeamMembership and UserTeamsPaginated to manage team memberships and pagination.
  • Enhanced Cluster schema with new properties for Disaster Recovery (DR) support, including drRegion, isDrEnabled, and others.
  • Introduced new permissions for managing environment objects and API tokens within organizations.
  • Removed astroRuntimeVersion property from deployment update requests.
  • Updated sorting options and descriptions for listing user teams within an organization.

Added

  • Schemas:

    • UserTeamMembership
      • dagRoles: Array of DAG roles.
      • deploymentRoles: Array of deployment roles.
      • description: String, example: ‘My Team description’.
      • id: String, example: ‘clma5ftgk000008mhgev00k7d’.
      • isIdpManaged: Boolean, example: False.
      • name: String, example: ‘My Team’.
      • organizationRole: Enum with values like ‘ORGANIZATION_OWNER’, ‘ORGANIZATION_MEMBER’, etc.
      • rolesCount: Integer, example: 1.
      • workspaceRoles: Array of workspace roles.
    • UserTeamsPaginated
      • limit: Integer, example: 10.
      • offset: Integer, example: 0.
      • teams: Array of UserTeamMembership.
      • totalCount: Integer, example: 100.
    • Cluster
      • drRegion: String, example: ‘us-east-1’.
      • drSecondaryVpcCidr: String.
      • drVpcSubnetRange: String.
      • enableReplicationTimeControl: Boolean.
      • failoverInProgress: Boolean.
      • isDrEnabled: Boolean.
      • isFailedOver: Boolean.
    • CreateAwsClusterRequest, CreateAzureClusterRequest, CreateGcpClusterRequest
      • drRegion: String, example: ‘us-west-2’.
      • drSecondaryVpcCidr: String, example: ‘100.64.0.0/19’.
      • drVpcSubnetRange: String, example: ‘172.20.0.0/22’.
      • enableReplicationTimeControl: Boolean.
    • CreateDedicatedDeploymentRequest, CreateHybridDeploymentRequest, CreateStandardDeploymentRequest
      • drWorkloadIdentity: String, example: ‘arn:aws:iam::123456789:role/AirflowS3Logs-clmk2qqia000008mhff3ndjr0’.
    • Deployment
    • UpdateDedicatedClusterRequest
      • enableDr: Boolean.
      • isFailedOver: Boolean.
    • UpdateDedicatedDeploymentRequest, UpdateHybridDeploymentRequest, UpdateStandardDeploymentRequest
      • drWorkloadIdentity: String.
      • environmentVariables: List of environment variables.

  • Permissions:

    • /organizations/{organizationId}/environment-objects and related endpoints: organization.envObjects.access.
    • /organizations/{organizationId}/tokens and related endpoints: organization.apiTokens.access.
    • /organizations/{organizationId}/users/{userId}/roles: organization.userRoles.access.

Changed

  • Schemas:

    • Cluster
      • secondaryVpcCidr description updated to “The secondary VPC CIDR. For AWS clusters only.”
      • Added drRegion, isDrEnabled, and name to required fields.
    • OrganizationProductPlan
      • Added ENTERPRISE_BUSINESS_CRITICAL to productPlanName enum.

  • Endpoints:

    • /organizations/{organizationId}/users/{userId}/teams
      • Response schema changed from TeamsPaginated to UserTeamsPaginated.
      • Permission action changed from organization.users.get to organization.teams.get.
      • Updated descriptions for parameters and summary.

  • Removed:

    • astroRuntimeVersion from UpdateDedicatedDeploymentRequest, UpdateHybridDeploymentRequest, and UpdateStandardDeploymentRequest.
March 16, 2026

Summary

  • Added a new endpoint to list all Teams associated with a specific user.

Added

  • Endpoints
    • GET /organizations/{organizationId}/users/{userId}/teams: List all Teams that a user belongs to within an Organization. Supports pagination with offset and limit query parameters, and sorting with the sorts query parameter.
March 10, 2026

v1 API Changelog

Summary

  • Added discriminators to CreateClusterRequest, CreateDeploymentRequest, UpdateClusterRequest, and UpdateDeploymentRequest schemas. Discriminators remove ambiguity when creating or updating resources by mapping requests to the correct cloud provider or Deployment type.
  • Updated descriptions for ApiTokenRole and API token listing parameters.

Added

  • CreateClusterRequest Schema:
    • Discriminator on cloudProvider with mappings for AWS, AZURE, and GCP.
  • CreateDeploymentRequest Schema:
    • Discriminator on type with mappings for DEDICATED, HYBRID, and STANDARD.
  • UpdateClusterRequest Schema:
    • Discriminator on clusterType with mappings for DEDICATED and HYBRID.
  • UpdateDeploymentRequest Schema:
    • Discriminator on type with mappings for DEDICATED, HYBRID, and STANDARD.

Changed

  • UpdateDedicatedDeploymentRequest, UpdateHybridDeploymentRequest, UpdateStandardDeploymentRequest Schemas:
    • Removed description for environmentVariables.
  • ApiTokenRole Schema:
    • Updated description for entityId.
  • API Token Listing Endpoint:
    • Updated description for the parameter related to DAG tags.
February 23, 2026

v1 API Changelog

Summary

  • Added new properties to the DagRole, Deployment, and Team schemas to enhance DAG access management.
  • Introduced new query parameters for pagination and sorting in the /organizations/{organizationId}/tokens and /organizations/{organizationId}/users endpoints.

Added

  • Schemas
    • DagRole
      • dagTag: DAG tag, required if DagId is not specified.
    • DeploymentEnvironmentVariable
      • updatedAt: Format set to date-time.
    • Invite
      • expiresAt: Format set to date-time.
    • Role
      • createdAt and updatedAt: Examples and format set to date-time.
    • RoleWithPermission
      • createdAt and updatedAt: Examples and format set to date-time.
    • Team
      • dagRoles: Array of DAG roles.
  • Endpoints
    • /organizations/{organizationId}/tokens
      • limit: Limit for pagination.
      • sorts: Sorting criteria.
    • /organizations/{organizationId}/users
      • limit: Limit for pagination.
      • sorts: Sorting criteria.
  • Enums
    • ApiTokenRole
      • entityType: Added DAG_TAG.