Use X-Databricks-Workspace-Id for workspace routing

NEXT_CHANGELOG.md

@@ -13,6 +13,7 @@
 ### Documentation
 
 ### Internal Changes
+* Switch workspace addressing header on workspace-scoped API calls from `X-Databricks-Org-Id` to `X-Databricks-Workspace-Id`. The value continues to come from the `DATABRICKS_WORKSPACE_ID` environment variable / `DatabricksConfig.setWorkspaceId()` setter, and now accepts either a classic numeric workspace ID or another workspace identifier format (server disambiguates). Mirrors [databricks/databricks-sdk-go#1688](https://github.com/databricks/databricks-sdk-go/pull/1688).
 
 ### API Changes
 * Add `revert()` method for `workspaceClient.lakeview()` service.
@@ -29,4 +30,4 @@
 * Change `cliVersion` field for `com.databricks.sdk.service.bundle.Version` to be required.
 * [Breaking] Change `cliVersion` field for `com.databricks.sdk.service.bundle.Version` to be required.
 * [Breaking] Change `tags` field for `com.databricks.sdk.service.marketplace.ListListingsRequest` to type `com.databricks.sdk.service.marketplace.ListingTag` class.
-* [Breaking] Change pagination for `workspaceClient.clusters().events()` method.
+* [Breaking] Change pagination for `workspaceClient.clusters().events()` method.

databricks-sdk-java/src/main/java/com/databricks/sdk/core/DatabricksConfig.java

@@ -33,7 +33,11 @@ public class DatabricksConfig {
   @ConfigAttribute(env = "DATABRICKS_ACCOUNT_ID")
   private String accountId;
 
-  /** Workspace ID for unified host operations. */
+  /**
+   * Workspace identifier sent on workspace-scoped API calls to unified hosts. Accepts either a
+   * classic numeric workspace ID or another workspace identifier format that the server understands
+   * (server disambiguates).
+   */
   @ConfigAttribute(env = "DATABRICKS_WORKSPACE_ID")
   private String workspaceId;