April 2, 2026 | Astronomer Documentation

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
  - drExternalIPs: Array of strings.
  - drOidcIssuerUrl: String, example: ‘https://westus2.oic.prod-aks.azure.com/…’.
  - effectiveDRWorkloadIdentity: String.
- 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.