name and workspaceId. The server resolves infrastructure from Workspace defaults (or auto-selects when the Organization has a single non-shared cluster), infers the Deployment type from the resolved cluster, and applies defaults for runtime version, executor, scheduler size, and related fields. This reduces the create Deployment API from roughly 15 required fields down to 2.defaultClusterId, defaultCloudProvider, and defaultRegion on Workspace so Workspace admins can pre-configure target infrastructure for new Deployments. defaultClusterId is mutually exclusive with defaultCloudProvider and defaultRegion.GET /organizations/{organizationId}/deployments/{deploymentId}/logs and GET /users/self endpoints.hasAllowedIpAddressRanges and shouldEnforceDedicatedClusters as required properties on the Organization schema.workspaceId and deploymentId filters to GET /organizations/{organizationId}/teams.Endpoints
GET /organizations/{organizationId}/deployments/{deploymentId}/logs: Get logs for an Astro Deployment. Supports filtering by log source (scheduler, triggerer, worker, webserver, dag-processor, apiserver), time range, text search, and pagination.GET /users/self: Get the authenticated user’s profile, roles, invites, and feature flags. Supports an optional createIfNotExist query parameter.Schemas
CreateDeploymentInstanceSpecRequest
au: Integer. Astro unit allocation for the Deployment pod. Minimum 5, maximum 24. Optional.replicas: Integer. Number of pod replicas. Minimum 1, maximum 4. Optional.UpdateDeploymentInstanceSpecRequest
au: Integer. Astro unit allocation for the Deployment pod. Minimum 5, maximum 24. Required.replicas: Integer. Number of pod replicas. Minimum 1, maximum 4. Required.DeploymentLog
limit, maxNumResults, offset, resultCount, results, searchId.results: Array of DeploymentLogEntry.DeploymentLogEntry
raw (string), source (enum: scheduler, webserver, triggerer, worker, dag-processor, apiserver), timestamp (number).SelfUser
avatarUrl, createdAt, fullName, id, status, updatedAt, username.featureFlags, invites, isIdpManaged, organizationId, and roles.SelfUserFeatureFlag, SelfUserInvite, SelfUserRole, SelfUserRoleScope: Supporting schemas for SelfUser.UpdateWorkerQueueRequest: Used by the workerQueues array on UpdateDedicatedDeploymentRequest, UpdateHybridDeploymentRequest, and UpdateStandardDeploymentRequest. Required fields: isDefault, maxWorkerCount, minWorkerCount, name, workerConcurrency.Properties
CreateWorkspaceRequest and UpdateWorkspaceRequest: defaultCloudProvider (enum: AWS, AZURE, GCP), defaultClusterId, and defaultRegion. Workspace admins use these fields to pre-configure target infrastructure for new Deployments. When a create Deployment request omits clusterId, cloudProvider, and region, the server uses these Workspace defaults. defaultClusterId is mutually exclusive with defaultCloudProvider and defaultRegion.Organization: hasAllowedIpAddressRanges (boolean, required) indicating whether the Organization has at least one allowed IP address range configured, and shouldEnforceDedicatedClusters (boolean, required).UpdateOrganizationRequest: shouldEnforceDedicatedClusters (boolean).Workspace: defaultCloudProvider, defaultClusterId, and defaultRegion (strings) reflecting the configured defaults.Query parameters
GET /organizations/{organizationId}/teams: workspaceId and deploymentId filter the response to Teams with a role in the specified Workspace or Deployment.name and workspaceId.