diff --git a/api/core/workflow/README.md b/api/core/workflow/README.md
index bef19ba90b..72f5dbe1e2 100644
--- a/api/core/workflow/README.md
+++ b/api/core/workflow/README.md
@@ -60,8 +60,8 @@ Extensible middleware for cross-cutting concerns:
 
 ```python
 engine = GraphEngine(graph)
-engine.add_layer(DebugLoggingLayer(level="INFO"))
-engine.add_layer(ExecutionLimitsLayer(max_nodes=100))
+engine.layer(DebugLoggingLayer(level="INFO"))
+engine.layer(ExecutionLimitsLayer(max_nodes=100))
 ```
 
 ### Event-Driven Architecture
@@ -117,7 +117,7 @@ The codebase enforces strict layering via import-linter:
 
 1. Create class inheriting from `Layer` base
 1. Override lifecycle methods: `on_graph_start()`, `on_event()`, `on_graph_end()`
-1. Add to engine via `engine.add_layer()`
+1. Add to engine via `engine.layer()`
 
 ### Debugging Workflow Execution
 
diff --git a/api/core/workflow/graph_engine/layers/README.md b/api/core/workflow/graph_engine/layers/README.md
index 8ee35baec0..17845ee1f0 100644
--- a/api/core/workflow/graph_engine/layers/README.md
+++ b/api/core/workflow/graph_engine/layers/README.md
@@ -30,7 +30,7 @@ debug_layer = DebugLoggingLayer(
 )
 
 engine = GraphEngine(graph)
-engine.add_layer(debug_layer)
+engine.layer(debug_layer)
 engine.run()
 ```