From 5ded5bb33ed31eb2a1407768232d0ed43f9025b6 Mon Sep 17 00:00:00 2001
From: Ashvithaa VP <ashvithaa219@gmail.com>
Date: Mon, 1 Sep 2025 19:26:03 +0530
Subject: [PATCH] Update Budget API spec and documentation

---
 src/api-explorer/v4-0/Budget.swagger2.json   | 20 ++++++++++++++++++-
 src/api-reference/budget/v4.budget-header.md | 21 +++++++++++++++-----
 2 files changed, 35 insertions(+), 6 deletions(-)

diff --git a/src/api-explorer/v4-0/Budget.swagger2.json b/src/api-explorer/v4-0/Budget.swagger2.json
index 71fedf376a..4ba33a91c6 100644
--- a/src/api-explorer/v4-0/Budget.swagger2.json
+++ b/src/api-explorer/v4-0/Budget.swagger2.json
@@ -405,7 +405,7 @@
           "200": {
             "description": "OK",
             "schema": {
-              "$ref": "#/definitions/BudgetItemHeaderResponse"
+              "$ref": "#/definitions/BudgetItemHeaderSaveResponse"
             }
           },
           "201": {
@@ -1262,6 +1262,24 @@
       },
       "title": "BudgetItemHeaderResponse"
     },
+    "BudgetItemHeaderSaveResponse": {
+      "type": "object",
+      "properties": {
+        "success": {
+          "type": "boolean"
+        },
+        "budgetItemHeaderSyncGuid": {
+          "type": "string"
+        },
+        "budgetItemDetailSyncGuids": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "title": "BudgetItemHeaderSaveResponse"
+    },
     "BudgetPerson": {
       "type": "object",
       "required": [
diff --git a/src/api-reference/budget/v4.budget-header.md b/src/api-reference/budget/v4.budget-header.md
index 2c0d2a9c01..75b7a881ed 100644
--- a/src/api-reference/budget/v4.budget-header.md
+++ b/src/api-reference/budget/v4.budget-header.md
@@ -1016,7 +1016,7 @@ N/A
 
 #### Payload
 
-[Budget Item Response](#budgetItemResponse) or [Error Response](#errorResponse)
+[Budget Item Save Response](#budgetItemHeaderSaveResponse) or [Error Response](#errorResponse)
 
 ### Example
 
@@ -1338,10 +1338,13 @@ concur-correlationid: 809a0898-e523-4114-950d-bd22705a3b25
 ```
 
 ```json
-  {
-    "success": true,
-    "budgetItemHeaderId": "72eee673-3d81-49c2-966a-b63c7a9302e6"
-  }
+{
+  "success": true,
+  "budgetItemHeaderSyncGuid": "6f5c0189-f680-407b-b474-df917151a947",
+  "budgetItemDetailSyncGuids": [
+    "29e46a1e-ea18-43ef-80b1-4c311cdf0fe7"
+  ]
+}
 ```
 
 ##### Failure Response
@@ -1657,6 +1660,14 @@ Name|Type|Format|Description
 `success`|`boolean`|-|`True` or `False` for success or failure.
 `budgetItemHeaderId`|`guid`|-|The key of the created/updated/removed budget item header.
 
+### <a name="budgetItemHeaderSaveResponse"></a>BudgetItemHeaderSaveResponse
+
+Name|Type|Format|Description
+---|---|---|---
+`success`|`boolean`|-|`True` or `False` for success or failure.
+`budgetItemHeaderSyncGuid`|`guid`|-|The key of the created/updated budget item header.
+`budgetItemDetailSyncGuids`|`array` of `guid`|-|The keys of the created/updated budget item details.
+
 ### <a name="dateRange"></a>DateRange
 Name|Type|Format|Description
 ---|---|---|---