diff --git a/src/main/java/it/cnr/isti/workflow/manager/controllers/BlocksController.java b/src/main/java/it/cnr/isti/workflow/manager/controllers/BlocksController.java
index d52a9f6..d684950 100644
--- a/src/main/java/it/cnr/isti/workflow/manager/controllers/BlocksController.java
+++ b/src/main/java/it/cnr/isti/workflow/manager/controllers/BlocksController.java
@@ -83,9 +83,25 @@ public class BlocksController {
         return blockTypes.values().stream().map(this::toDescriptor).toList();
     }
 
+    /**
+     * @deprecated use {@link #getConfigurationCatalog()} ({@code /blocks/types/configurations/catalog}) instead.
+     */
+    @Deprecated(forRemoval = true, since = "2026-09")
     @GetMapping("/types/catalog")
-    @Operation(summary = "Get compact block type catalog", description = "Returns all block types with JSON schemas compacted through shared schema definitions.")
+    @Operation(summary = "Get compact block type catalog", description = "Deprecated: use /blocks/types/configurations/catalog instead. Returns all block types with JSON schemas compacted through shared schema definitions.", deprecated = true)
     public BlockConfigurationCatalog getTypeCatalog() {
+        return getConfigurationCatalog();
+    }
+
+    @GetMapping("/types/configurations/descriptors")
+    @Operation(summary = "Get block configuration descriptors", description = "Returns one descriptor for each block type, including JSON schema.")
+    public List<BlockConfigurationDescriptor> getConfigurationDescriptors() {
+        return getTypes();
+    }
+
+    @GetMapping("/types/configurations/catalog")
+    @Operation(summary = "Get compact block configuration descriptors", description = "Returns one compact descriptor for each block type, with shared schema definitions lifted to the response root.")
+    public BlockConfigurationCatalog getConfigurationCatalog() {
         List<BlockConfigurationDescriptor> descriptors = getTypes();
         JsonSchemaCatalogBundler.SchemaBundle bundle = schemaCatalogBundler.bundle(descriptors.stream()
                 .map(BlockConfigurationDescriptor::schema)
@@ -99,18 +115,6 @@ public class BlocksController {
         return new BlockConfigurationCatalog(bundle.sharedDefinitions(), compactDescriptors);
     }
 
-    @GetMapping("/types/configurations/descriptors")
-    @Operation(summary = "Get block configuration descriptors", description = "Returns one descriptor for each block type, including JSON schema.")
-    public List<BlockConfigurationDescriptor> getConfigurationDescriptors() {
-        return getTypes();
-    }
-
-    @GetMapping("/types/configurations/catalog")
-    @Operation(summary = "Get compact block configuration descriptors", description = "Alias of /blocks/types/catalog. Returns one compact descriptor for each block type, with shared schema definitions lifted to the response root.")
-    public BlockConfigurationCatalog getConfigurationCatalog() {
-        return getTypeCatalog();
-    }
-
     @GetMapping("/types/{type}/configuration/descriptor")
     @Operation(summary = "Get block configuration descriptor by type", description = "Returns the descriptor and JSON schema for the requested block type.")
     public BlockConfigurationDescriptor getConfigurationDescriptorForType(@PathVariable String type) {