v0.103.0

New Features and Improvements

• Add support for unified hosts. A single configuration profile can now be used for both account-level and workspace-level operations when the host supports it and both account_id and workspace_id are available. The experimental_is_unified_host flag has been removed; unified host detection is now automatic.
• Accept DATABRICKS_OIDC_TOKEN_FILEPATH environment variable for consistency with other Databricks SDKs (Go, CLI, Terraform). The previous DATABRICKS_OIDC_TOKEN_FILE is still supported as an alias.

Breaking Changes

• Drop support for Python 3.8 and 3.9. The minimum supported Python version is now 3.10, in line with the oldest supported Databricks Runtime LTS (DBR 13.3).

Internal Changes

• Replace the async-disabling mechanism on token refresh failure with a 1-minute retry backoff. Previously, a single failed async refresh would disable proactive token renewal until the token expired. Now, the SDK waits a short cooldown period and retries, improving resilience to transient errors.
• Extract _resolve_profile to simplify config file loading and improve __settings__ error messages.
• Resolve token_audience from the token_federation_default_oidc_audiences field in the host metadata discovery endpoint, removing the need for explicit audience configuration.

API Changes

• Add create_catalog(), create_synced_table(), delete_catalog(), delete_synced_table(), get_catalog() and get_synced_table() methods for w.postgres workspace-level service.
• Add effective_file_event_queue field for databricks.sdk.service.catalog.CreateExternalLocation.
• Add effective_file_event_queue field for databricks.sdk.service.catalog.ExternalLocationInfo.
• Add effective_file_event_queue field for databricks.sdk.service.catalog.UpdateExternalLocation.
• Add column_selection field for databricks.sdk.service.ml.Function.
• Add cascade field for databricks.sdk.service.pipelines.DeletePipelineRequest.
• Add default_branch field for databricks.sdk.service.postgres.ProjectSpec.
• Add default_branch field for databricks.sdk.service.postgres.ProjectStatus.
• Add ingress and ingress_dry_run fields for databricks.sdk.service.settings.AccountNetworkPolicy.
• Add delete_app_thumbnail() and update_app_thumbnail() methods for w.apps workspace-level service.
• Add create_message_comment(), list_conversation_comments() and list_message_comments() methods for w.genie workspace-level service.
• Add apply_environment() method for w.pipelines workspace-level service.
• Add name and permission fields for databricks.sdk.service.apps.AppResourceApp.
• Add managed_encryption_settings field for databricks.sdk.service.catalog.CatalogInfo.
• Add managed_encryption_settings field for databricks.sdk.service.catalog.CreateCatalog.
• Add managed_encryption_settings field for databricks.sdk.service.catalog.UpdateCatalog.
• Add comment field for databricks.sdk.service.dashboards.GenieFeedback.
• Add thoughts field for databricks.sdk.service.dashboards.GenieQueryAttachment.
• Add comment field for databricks.sdk.service.dashboards.GenieSendMessageFeedbackRequest.
• Add request_source field for databricks.sdk.service.ml.DataSource.
• Add is_online field for databricks.sdk.service.ml.MaterializedFeature.
• Add connector_options field for databricks.sdk.service.pipelines.SchemaSpec.
• Add connector_options field for databricks.sdk.service.pipelines.TableSpec.
• Add scopes field for databricks.sdk.service.settings.CreateOboTokenRequest.
• Add gcp_endpoint field for databricks.sdk.service.settings.CreatePrivateEndpointRule.
• Add scopes field for databricks.sdk.service.settings.CreateTokenRequest.
• Add gcp_endpoint field for databricks.sdk.service.settings.NccPrivateEndpointRule.
• Add gcp_endpoint field for databricks.sdk.service.settings.UpdatePrivateEndpointRule.
• Add sql_state field for databricks.sdk.service.sql.StatementStatus.
• Add usage_policy_id field for databricks.sdk.service.vectorsearch.CreateEndpoint.
• Add index_subtype field for databricks.sdk.service.vectorsearch.CreateVectorIndexRequest.
• Add budget_policy_id field for databricks.sdk.service.vectorsearch.EndpointInfo.
• Add index_subtype field for databricks.sdk.service.vectorsearch.MiniVectorIndex.
• Add budget_policy_id field for databricks.sdk.service.vectorsearch.PatchEndpointBudgetPolicyResponse.
• Add index_subtype field for databricks.sdk.service.vectorsearch.VectorIndex.
• Add table_delta_uniform_iceberg_external_deltasharing enum value for databricks.sdk.service.catalog.SecurableKind.
• Add google_drive enum value for databricks.sdk.service.pipelines.IngestionSourceType.
• Add storage_optimized enum value for databricks.sdk.service.vectorsearch.EndpointType.
• [Breaking] Remove project field for databricks.sdk.service.postgres.SyncedTableSyncedTableSpec.
• [Breaking] Remove apps and lakebase fields for databricks.sdk.service.settings.CustomerFacingIngressNetworkPolicyRequestDestination.

v0.102.0

Release v0.102.0

New Features and Improvements

• 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.

API Changes

• Add disable_gov_tag_creation field for databricks.sdk.service.settings.RestrictWorkspaceAdminsMessage.
• Add disable_gov_tag_creation field for databricks.sdk.service.settingsv2.RestrictWorkspaceAdminsMessage.

v0.101.0

Release v0.101.0

API Changes

• Add databricks.sdk.service.environments package.
• Add w.environments workspace-level service.
• Add parent_path field for databricks.sdk.service.dashboards.GenieSpace.
• Add can_create_app enum value for databricks.sdk.service.iam.PermissionLevel.

v0.100.0

Release v0.100.0

New Features and Improvements

• Support default_profile in [__settings__] section of .databrickscfg for consistent default profile resolution across CLI and SDKs.

API Changes

• Add alert_output field for databricks.sdk.service.jobs.RunOutput.
• Add alert_task field for databricks.sdk.service.jobs.RunTask.
• Add alert_task field for databricks.sdk.service.jobs.SubmitTask.
• Add alert_task field for databricks.sdk.service.jobs.Task.

v0.99.0

Release v0.99.0

API Changes

• Add connector_type and data_staging_options fields for databricks.sdk.service.pipelines.IngestionPipelineDefinition.
• Add ingestion_source_catalog_name, ingestion_source_connection_name, ingestion_source_schema_name, ingestion_source_table_name and ingestion_source_table_version fields for databricks.sdk.service.pipelines.Origin.
• Add sub_domain field for databricks.sdk.service.serving.ExternalFunctionRequest.

v0.98.0

Release v0.98.0

API Changes

• Add genie_create_eval_run(), genie_get_eval_result_details(), genie_get_eval_run(), genie_list_eval_results() and genie_list_eval_runs() methods for w.genie workspace-level service.
• Add update_role() method for w.postgres workspace-level service.
• Add telemetry_export_destinations field for databricks.sdk.service.apps.App.
• Add entities and timeseries_column fields for databricks.sdk.service.ml.Feature.
• Add aggregation_function field for databricks.sdk.service.ml.Function.
• Add filter_condition field for databricks.sdk.service.ml.KafkaSource.
• Add attributes field for databricks.sdk.service.postgres.RoleRoleStatus.
• [Breaking] Change entity_columns and timeseries_column fields for databricks.sdk.service.ml.DeltaTableSource to no longer be required.
• Change entity_columns and timeseries_column fields for databricks.sdk.service.ml.DeltaTableSource to no longer be required.
• Change inputs field for databricks.sdk.service.ml.Feature to no longer be required.
• [Breaking] Change inputs field for databricks.sdk.service.ml.Feature to no longer be required.
• [Breaking] Change function_type field for databricks.sdk.service.ml.Function to no longer be required.
• Change function_type field for databricks.sdk.service.ml.Function to no longer be required.
• Change entity_column_identifiers and timeseries_column_identifier fields for databricks.sdk.service.ml.KafkaSource to no longer be required.
• [Breaking] Change entity_column_identifiers and timeseries_column_identifier fields for databricks.sdk.service.ml.KafkaSource to no longer be required.

v0.97.0

Release v0.97.0

Bug Fixes

• 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.

API Changes

• Add databricks.sdk.service.dataclassification and databricks.sdk.service.knowledgeassistants packages.
• Add w.data_classification workspace-level service.
• Add w.knowledge_assistants workspace-level service.

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. Providing a stale_duration in the constructor of the Refreshable class will use that fixed value instead. To match the previous default, pass stale_duration=timedelta(minutes=5).

v0.95.0

Release v0.95.0

New Features and Improvements

• Added Config.discovery_url config field (DATABRICKS_DISCOVERY_URL env var). When set, OIDC endpoints are fetched directly from this URL instead of the default host-type-based logic. Mirrors discoveryUrl in the Java SDK.
• The OAuth token cache filename now includes the config profile name (if set) and uses a serialized map to prevent hash collisions. All users will need to reauthenticate once after upgrading.

API Changes

• Add dataframe_schema, filter_condition and transformation_sql fields for databricks.sdk.service.ml.DeltaTableSource.
• Add environment_version field for databricks.sdk.service.pipelines.PipelinesEnvironment.
• Add reset_checkpoint_selection field for databricks.sdk.service.pipelines.StartUpdate.
• [Breaking] Remove oauth2_app_client_id and oauth2_app_integration_id fields for databricks.sdk.service.apps.Space.
• Add create_database(), delete_database(), get_database(), list_databases() and update_database() methods for w.postgres workspace-level service.
• Add postgres field for databricks.sdk.service.apps.AppResource.
• Add enable_pg_native_login field for databricks.sdk.service.postgres.ProjectSpec.
• Add enable_pg_native_login field for databricks.sdk.service.postgres.ProjectStatus.
• [Breaking] Remove node_type_flexibility field for databricks.sdk.service.compute.EditInstancePool.

v0.94.0

Release v0.94.0

New Features and Improvements

• Added Config.discovery_url config field (DATABRICKS_DISCOVERY_URL env var). When set, OIDC endpoints are fetched directly from this URL instead of the default host-type-based logic. Mirrors discoveryUrl in the Java SDK.

Bug Fixes

• Pass --profile to CLI token source when profile is set, and add read-fallback to migrate legacy host-keyed tokens to profile keys.

API Changes

• Add effective_publishing_mode field for databricks.sdk.service.pipelines.GetPipelineResponse.
• Add dbr_autoscale enum value for databricks.sdk.service.compute.EventDetailsCause.
• Change output_catalog field for databricks.sdk.service.cleanrooms.CreateCleanRoomOutputCatalogResponse to be required.
• [Breaking] Remove internal_attributes field for databricks.sdk.service.sharing.Table.
• [Breaking] Remove internal_attributes field for databricks.sdk.service.sharing.Volume.