v0.105.0

New Features and Improvements

• Added automatic detection of AI coding agents (Amp, Antigravity, Augment, Claude Code, Cline, Codex, Copilot CLI, Copilot VS Code, Cursor, Gemini CLI, Goose, Kiro, OpenClaw, OpenCode, Windsurf) in the user-agent string. The SDK now appends agent/<name> to HTTP request headers when running inside a known AI agent environment. Also honors the AGENT=<name> standard: when AGENT is set to a known product name the SDK reports that product, and when set to an unrecognized non-empty value the SDK reports agent/unknown. Environment variables set to the empty string (e.g. CLAUDECODE="") now count as "set" for presence-only matchers, matching databricks-sdk-go semantics; previously they were treated as unset. Explicit agent env vars (e.g. CLAUDECODE, GOOSE_TERMINAL) always take precedence over the generic AGENT=<name> signal. When multiple agent env vars are present (e.g. a Cursor CLI subagent invoked from Claude Code), the user-agent reports agent/multiple.

Breaking Changes

• Remove the experimentalIsUnifiedHost field (and the DATABRICKS_EXPERIMENTAL_IS_UNIFIED_HOST environment variable) from DatabricksConfig. The flag was unused — getHostType() never read it — so unified host detection is now determined purely by URL pattern and the automatic /.well-known/databricks-config metadata resolution. Callers that set the flag should remove those calls. Mirrors databricks/databricks-sdk-go#1641 and databricks/databricks-sdk-py#1358.

Bug Fixes

• Add X-Databricks-Org-Id header to SharesExtImpl.list() for SPOG host compatibility. Without this header, calls to the hand-written extension were rejected by the SPOG proxy with Unable to load OAuth Config (400 UNKNOWN). Mirrors databricks/databricks-sdk-go#1635.

Internal Changes

• Added parametrized unit tests covering PAT, Basic, OAuth M2M, GitHub OIDC, Env OIDC, File OIDC, Azure Client Secret, and Azure GitHub OIDC against six host profiles (LW, NW, LA, NA, SPOGW, SPOGA) across AWS, Azure, and GCP (138 subtests total). Mirrors databricks-sdk-go PR #1627 and databricks-sdk-py PR #1357.
• Migrated internal SDK classes to the logging abstraction. The SDK now supports SLF4J, java.util.logging, or a custom backend via LoggerFactory.setDefault().

API Changes

• Add com.databricks.sdk.service.supervisoragents package.
• Add workspaceClient.secretsUc() service.
• Add workspaceClient.supervisorAgents() service.
• Add update() method for workspaceClient.tokens() service.
• Add etag field for com.databricks.sdk.service.dashboards.GenieSpace.
• Add etag field for com.databricks.sdk.service.dashboards.GenieUpdateSpaceRequest.
• Add branchId field for com.databricks.sdk.service.postgres.BranchStatus.
• Add catalogId field for com.databricks.sdk.service.postgres.CatalogCatalogStatus.
• Add databaseId field for com.databricks.sdk.service.postgres.DatabaseDatabaseStatus.
• Add endpointId field for com.databricks.sdk.service.postgres.EndpointStatus.
• Add projectId field for com.databricks.sdk.service.postgres.ProjectStatus.
• Add roleId field for com.databricks.sdk.service.postgres.RoleRoleStatus.
• Add project field for com.databricks.sdk.service.postgres.SyncedTableSyncedTableStatus.
• Add manual field for com.databricks.sdk.service.provisioning.CreateGcpKeyInfo.
• Add manual field for com.databricks.sdk.service.provisioning.GcpKeyInfo.
• Add appsRuntime and lakebaseRuntime fields for com.databricks.sdk.service.settings.CustomerFacingIngressNetworkPolicyRequestDestination.
• Add blockedInternetDestinations field for com.databricks.sdk.service.settings.EgressNetworkPolicyNetworkAccessPolicy.
• Add columnsToSync field for com.databricks.sdk.service.vectorsearch.DeltaSyncVectorIndexSpecResponse.
• Add BREAKING_CHANGE enum value for com.databricks.sdk.service.jobs.TerminationCodeCode.
• [Breaking] Change updateCatalogConfig() method for workspaceClient.dataClassification() service. Method path has changed.
• [Breaking] Change updateDefaultWorkspaceBaseEnvironment() method for workspaceClient.environments() service. Method path has changed.
• [Breaking] Change updateKnowledgeAssistant() method for workspaceClient.knowledgeAssistants() service. Method path has changed.
• [Breaking] Change updateBranch(), updateDatabase(), updateEndpoint(), updateProject() and updateRole() methods for workspaceClient.postgres() service. Method path has changed.
• [Breaking] Change updateDefaultWarehouseOverride() method for workspaceClient.warehouses() service. Method path has changed.

v0.104.0

New Features and Improvements

• Add support for authentication through Azure Managed Service Identity (MSI) via the new azure-msi credential provider.
• Support default_profile in [__settings__] section of .databrickscfg for consistent default profile resolution across CLI and SDKs.
• Added automatic detection of AI coding agents (Antigravity, Claude Code, Cline, Codex, Copilot CLI, Cursor, Gemini CLI, OpenCode) in the user-agent string. The SDK now appends agent/<name> to HTTP request headers when running inside a known AI agent environment.

Bug Fixes

• Fixed non-JSON error responses (e.g. plain-text "Invalid Token" with HTTP 403) producing Unknown instead of the correct typed exception (PermissionDenied, Unauthenticated, etc.). The error message no longer contains Jackson deserialization internals.
• Added X-Databricks-Org-Id header to deprecated workspace SCIM APIs (Groups, ServicePrincipals, Users) for SPOG host compatibility.
• Fixed Databricks CLI authentication to detect when the cached token's scopes don't match the SDK's configured scopes. Previously, a scope mismatch was silently ignored, causing requests to use wrong permissions. The SDK now raises an error with instructions to re-authenticate.

Internal Changes

• Introduced a logging abstraction (com.databricks.sdk.core.logging) to decouple the SDK from a specific logging backend.
• Added token_federation_default_oidc_audiences resolution from host metadata. The SDK now sets tokenAudience from the first element of this field during config initialization, with fallback to accountId for account hosts.

API Changes

• Add createCatalog(), createSyncedTable(), deleteCatalog(), deleteSyncedTable(), getCatalog() and getSyncedTable() methods for workspaceClient.postgres() service.
• Add effectiveFileEventQueue field for com.databricks.sdk.service.catalog.CreateExternalLocation.
• Add effectiveFileEventQueue field for com.databricks.sdk.service.catalog.ExternalLocationInfo.
• Add effectiveFileEventQueue field for com.databricks.sdk.service.catalog.UpdateExternalLocation.
• Add columnSelection field for com.databricks.sdk.service.ml.Function.
• Add cascade field for com.databricks.sdk.service.pipelines.DeletePipelineRequest.
• Add defaultBranch field for com.databricks.sdk.service.postgres.ProjectSpec.
• Add defaultBranch field for com.databricks.sdk.service.postgres.ProjectStatus.
• Add ingress and ingressDryRun fields for com.databricks.sdk.service.settings.AccountNetworkPolicy.
• Add deleteAppThumbnail() and updateAppThumbnail() methods for workspaceClient.apps() service.
• Add createMessageComment(), listConversationComments() and listMessageComments() methods for workspaceClient.genie() service.
• Add applyEnvironment() method for workspaceClient.pipelines() service.
• Add name and permission fields for com.databricks.sdk.service.apps.AppResourceApp.
• Add managedEncryptionSettings field for com.databricks.sdk.service.catalog.CatalogInfo.
• Add managedEncryptionSettings field for com.databricks.sdk.service.catalog.CreateCatalog.
• Add managedEncryptionSettings field for com.databricks.sdk.service.catalog.UpdateCatalog.
• Add comment field for com.databricks.sdk.service.dashboards.GenieFeedback.
• Add thoughts field for com.databricks.sdk.service.dashboards.GenieQueryAttachment.
• Add comment field for com.databricks.sdk.service.dashboards.GenieSendMessageFeedbackRequest.
• Add requestSource field for com.databricks.sdk.service.ml.DataSource.
• Add isOnline field for com.databricks.sdk.service.ml.MaterializedFeature.
• Add connectorOptions field for com.databricks.sdk.service.pipelines.SchemaSpec.
• Add connectorOptions field for com.databricks.sdk.service.pipelines.TableSpec.
• Add scopes field for com.databricks.sdk.service.settings.CreateOboTokenRequest.
• Add gcpEndpoint field for com.databricks.sdk.service.settings.CreatePrivateEndpointRule.
• Add scopes field for com.databricks.sdk.service.settings.CreateTokenRequest.
• Add gcpEndpoint field for com.databricks.sdk.service.settings.NccPrivateEndpointRule.
• Add gcpEndpoint field for com.databricks.sdk.service.settings.UpdatePrivateEndpointRule.
• Add sqlState field for com.databricks.sdk.service.sql.StatementStatus.
• Add usagePolicyId field for com.databricks.sdk.service.vectorsearch.CreateEndpoint.
• Add indexSubtype field for com.databricks.sdk.service.vectorsearch.CreateVectorIndexRequest.
• Add budgetPolicyId field for com.databricks.sdk.service.vectorsearch.EndpointInfo.
• Add indexSubtype field for com.databricks.sdk.service.vectorsearch.MiniVectorIndex.
• Add budgetPolicyId field for com.databricks.sdk.service.vectorsearch.PatchEndpointBudgetPolicyResponse.
• Add indexSubtype field for com.databricks.sdk.service.vectorsearch.VectorIndex.
• Add TABLE_DELTA_UNIFORM_ICEBERG_EXTERNAL_DELTASHARING enum value for com.databricks.sdk.service.catalog.SecurableKind.
• Add GOOGLE_DRIVE enum value for com.databricks.sdk.service.pipelines.IngestionSourceType.
• Add STORAGE_OPTIMIZED enum value for com.databricks.sdk.service.vectorsearch.EndpointType.
• [Breaking] Remove project field for com.databricks.sdk.service.postgres.SyncedTableSyncedTableSpec.
• [Breaking] Remove apps and lakebase fields for com.databricks.sdk.service.settings.CustomerFacingIngressNetworkPolicyRequestDestination.

v0.103.0

Release v0.103.0

API Changes

• Add disableGovTagCreation field for com.databricks.sdk.service.settings.RestrictWorkspaceAdminsMessage.
• Add disableGovTagCreation field for com.databricks.sdk.service.settingsv2.RestrictWorkspaceAdminsMessage.

v0.102.0

Release v0.102.0

API Changes

• Add parentPath field for com.databricks.sdk.service.dashboards.GenieSpace.

v0.101.0

Release v0.101.0

API Changes

• Add alertOutput field for com.databricks.sdk.service.jobs.RunOutput.
• Add alertTask field for com.databricks.sdk.service.jobs.RunTask.
• Add alertTask field for com.databricks.sdk.service.jobs.SubmitTask.
• Add alertTask field for com.databricks.sdk.service.jobs.Task.
• Add com.databricks.sdk.service.environments package.
• Add workspaceClient.environments() service.
• Add CAN_CREATE_APP enum value for com.databricks.sdk.service.iam.PermissionLevel.

v0.100.0

Release v0.100.0

Internal Changes

• Add retry with backoff to CachedTokenSource async refresh so that a failed background refresh no longer disables async until a blocking call succeeds.

API Changes

• Add connectorType and dataStagingOptions fields for com.databricks.sdk.service.pipelines.IngestionPipelineDefinition.
• Add ingestionSourceCatalogName, ingestionSourceConnectionName, ingestionSourceSchemaName, ingestionSourceTableName and ingestionSourceTableVersion fields for com.databricks.sdk.service.pipelines.Origin.
• Add subDomain field for com.databricks.sdk.service.serving.ExternalFunctionRequest.

v0.99.0

Release v0.99.0

API Changes

• Add updateRole() method for workspaceClient.postgres() service.
• Add entities and timeseriesColumn fields for com.databricks.sdk.service.ml.Feature.
• Add aggregationFunction field for com.databricks.sdk.service.ml.Function.
• Add filterCondition field for com.databricks.sdk.service.ml.KafkaSource.
• Add attributes field for com.databricks.sdk.service.postgres.RoleRoleStatus.
• Change entityColumns and timeseriesColumn fields for com.databricks.sdk.service.ml.DeltaTableSource to no longer be required.
• [Breaking] Change entityColumns and timeseriesColumn fields for com.databricks.sdk.service.ml.DeltaTableSource to no longer be required.
• Change inputs field for com.databricks.sdk.service.ml.Feature to no longer be required.
• [Breaking] Change inputs field for com.databricks.sdk.service.ml.Feature to no longer be required.
• [Breaking] Change functionType field for com.databricks.sdk.service.ml.Function to no longer be required.
• Change functionType field for com.databricks.sdk.service.ml.Function to no longer be required.
• Change entityColumnIdentifiers and timeseriesColumnIdentifier fields for com.databricks.sdk.service.ml.KafkaSource to no longer be required.
• [Breaking] Change entityColumnIdentifiers and timeseriesColumnIdentifier fields for com.databricks.sdk.service.ml.KafkaSource to no longer be required.

v0.98.0

Release v0.98.0

API Changes

• Add com.databricks.sdk.service.dataclassification and com.databricks.sdk.service.knowledgeassistants packages.
• Add workspaceClient.dataClassification() service.
• Add workspaceClient.knowledgeAssistants() service.
• Add genieCreateEvalRun(), genieGetEvalResultDetails(), genieGetEvalRun(), genieListEvalResults() and genieListEvalRuns() methods for workspaceClient.genie() service.
• Add telemetryExportDestinations field for com.databricks.sdk.service.apps.App.

v0.97.0

Release v0.97.0

New Features and Improvements

• Add withRequestConfig(RequestConfig) to CommonsHttpClient.Builder for fine-grained timeout control (#691).

v0.96.0

Release v0.96.0

Internal Changes

• Implement dynamic auth token stale period based on initial token lifetime. Increased up to 20 mins for standard OAuth with proportionally shorter periods for short-lived tokens. Manually setting the stale period using the CachedTokeSource builder reverts the behaviour to the legacy fixed stale duration.