From 8bd4b6d6203a74cea1fbb36bb699a90f86d3a7ea Mon Sep 17 00:00:00 2001
From: Sebastiano Marchesini
 <136741001+smarchesini-avvale@users.noreply.github.com>
Date: Wed, 4 Mar 2026 15:52:58 -0500
Subject: [PATCH] Enhance documentation for task chains in REST APIs

Added prerequisites and request body details for running task chains using REST APIs.

TO VERIFY if the input parameters json is correct.
I took it from here:
https://api.sap.com/api/DatasphereTasks/path/post_api_v1_datasphere_tasks_chains__spaceid__run__objectid_
and we don't have a chain with the parameters right now
---
 .../manage-tasks-using-rest-apis-274f273.md   | 20 ++++++++++++++++++-
 1 file changed, 19 insertions(+), 1 deletion(-)

diff --git a/docs/Acquiring-Preparing-Modeling-Data/Acquiring-and-Preparing-Data-in-the-Data-Builder/manage-tasks-using-rest-apis-274f273.md b/docs/Acquiring-Preparing-Modeling-Data/Acquiring-and-Preparing-Data-in-the-Data-Builder/manage-tasks-using-rest-apis-274f273.md
index c74a159..c2344aa 100644
--- a/docs/Acquiring-Preparing-Modeling-Data/Acquiring-and-Preparing-Data-in-the-Data-Builder/manage-tasks-using-rest-apis-274f273.md
+++ b/docs/Acquiring-Preparing-Modeling-Data/Acquiring-and-Preparing-Data-in-the-Data-Builder/manage-tasks-using-rest-apis-274f273.md
@@ -60,6 +60,7 @@ The detailed documentation of the Data Sharing Cockpit REST APIs is available on
 
 
 
+
 ## Task Chains
 
 Run task chains.
@@ -70,9 +71,25 @@ To run a task chain, use the POST request with the API <code>api/v1/datasphere/t
 https://<tenant_url>/api/v1/datasphere/tasks/chains/<space_id>/run/<objectid>
 ```
 
+**Prerequisite:** The task chain must be active and deployed before it can be run.
+
+**Header:** Set `Content-Type: application/json` in the request header.
+
+**Request Body:** You can optionally pass input parameters for the task chain. This works only if the task chain is defined with input parameters. If no input parameters are needed, you can send an empty JSON object `{}`.
+
 Example:
 
-> ### Sample Code:  
+> ### Sample Request:
+> ```
+> {
+>   "inputParameters": {
+>     "param1": "value1",
+>     "param2": "value2"
+>   }
+> }
+> ```
+
+> ### Sample Response:
 > ```
 > {
 >   "logId": 9999999
@@ -81,6 +98,7 @@ Example:
 
 
 
+
 ## Logs
 
 Get task log details and existing task log history of objects.