diff --git a/spec/openapi.yml b/spec/openapi.yml
index 7ccfe989d1..085296c058 100644
--- a/spec/openapi.yml
+++ b/spec/openapi.yml
@@ -697,7 +697,9 @@ components:
       schema:
         type: string
         example: dataset:food_delivery:public.delivery_7_days
-      description: The ID of the node.
+      description: The ID of the node. A node can either be a dataset node or a job node. The format of
+        nodeId for dataset is `dataset:<namespace_of_dataset>:<name_of_the_dataset>` and for job is
+        `job:<namespace_of_the_job>:<name_of_the_job>`.
       required: true
 
     depth:
@@ -1768,8 +1770,10 @@ components:
           example: food_delivery
         nodeId:
           type: string
-          description: The ID of the dataset or job node.
-          example: dataset:food_delivery:public.delivery_7_days
+          description: The ID of the node. A node can either be a dataset node or a job node. The format of
+            nodeId for dataset is `dataset:<namespace_of_dataset>:<name_of_the_dataset>` and for job is
+            `job:<namespace_of_the_job>:<name_of_the_job>`.
+          example: 'dataset:food_delivery:public.delivery_7_days'
 
     SearchResultType:
       type: enum