diff --git a/src/open-api/deprecated-types.ts b/src/open-api/deprecated-types.ts
index 8a175191..5be2cc07 100644
--- a/src/open-api/deprecated-types.ts
+++ b/src/open-api/deprecated-types.ts
@@ -1,5 +1,6 @@
 /* eslint-disable */
-// TODO: remove everything below (whole file) after April 2026 (backward compatibility types)
+// Legacy compatibility types: This file provides backward compatibility types.
+// These types are maintained for legacy users and will not be removed.
 // ------------------------------start------------------------------
 import type {
   HumanTaskEntry,
diff --git a/src/open-api/index.ts b/src/open-api/index.ts
index 6dff3678..f061d5c5 100644
--- a/src/open-api/index.ts
+++ b/src/open-api/index.ts
@@ -54,14 +54,14 @@ export type {
 
 export * from "./types";
 
-// todo: remove after April 2026 (backward compatibility types)
+// Legacy compatibility types: maintained for backward compatibility
 export * from "./deprecated-types";
 
 /**
  * Export types needed for client's return type in case if user is building another lib on top of sdk with declaration files
  * @deprecated
  * to import all the types below manually while using SDK since these types could change in future without backward compatibility
- * TODO: remove after April 2026
+ * Legacy compatibility: maintained for backward compatibility
  */
 export type {
   Auth,
diff --git a/src/sdk/createConductorClient/createConductorClient.ts b/src/sdk/createConductorClient/createConductorClient.ts
index 78fcec55..49c14010 100644
--- a/src/sdk/createConductorClient/createConductorClient.ts
+++ b/src/sdk/createConductorClient/createConductorClient.ts
@@ -41,6 +41,7 @@ export const createConductorClient = async (
     await handleAuth(openApiClient, keyId, keySecret, refreshTokenInterval);
   }
 
-  // DEPRECATED, should be replaced with return openApiClient after April 2026:
+  // Legacy compatibility: Adds resource-based API methods for backward compatibility.
+  // The modern API is available directly on openApiClient, but legacy methods are maintained.
   return addResourcesBackwardCompatibility(openApiClient);
 };
diff --git a/src/sdk/createConductorClient/helpers/addResourcesBackwardCompatibility.ts b/src/sdk/createConductorClient/helpers/addResourcesBackwardCompatibility.ts
index 6d22f6ed..2c491b2a 100644
--- a/src/sdk/createConductorClient/helpers/addResourcesBackwardCompatibility.ts
+++ b/src/sdk/createConductorClient/helpers/addResourcesBackwardCompatibility.ts
@@ -1,6 +1,7 @@
 /* eslint-disable */
 // disable linter since related old functionality was not properly typed
-// TODO: everything in this file is DEPRECATED and whole file should be removed after April 2026
+// Legacy compatibility layer: This file provides backward compatibility for the old resource-based API.
+// The legacy API is maintained for existing users, but new code should use the modern API methods.
 
 import type { SignalResponse } from "../../../open-api";
 import type { Client } from "../../../open-api/generated/client/types.gen";
@@ -21,7 +22,7 @@ import {
 
 const warn = () => {
   console.warn(
-    "[Conductor SDK Deprecation Warning] Accessing resources directly on the client is deprecated and will be removed after April 2026"
+    "[Conductor SDK Legacy API] You are using the legacy resource-based API. This API is maintained for backward compatibility. For new code, use higher-level clients (EventClient, TaskClient) or Resource classes directly."
   );
 };