Merge pull request #136 from contentstack/enhc/DX-3233

OMpawar-21 · web-flow · commit 08e18f0be19d · 2026-03-10T15:05:47.000+05:30
feat(DX-3233): Bulk publish/unpublish query params, api_version tests, and robust error handling
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,12 @@
 # Changelog
 
+## [v0.7.0](https://github.com/contentstack/contentstack-management-dotnet/tree/v0.7.0)
+ - Feat
+   - **Bulk publish/unpublish: query parameters (DX-3233)**
+     - `skip_workflow_stage_check` and `approvals` are now sent as query parameters instead of headers for bulk publish and bulk unpublish
+     - Unit tests updated to assert on `QueryResources` for these flags (BulkPublishServiceTest, BulkUnpublishServiceTest, BulkOperationServicesTest)
+     - Integration tests: bulk publish with skipWorkflowStage and approvals (Test003a), bulk unpublish with skipWorkflowStage and approvals (Test004a), and helper `EnsureBulkTestContentTypeAndEntriesAsync()` so bulk tests can run in any order
+
 ## [v0.6.1](https://github.com/contentstack/contentstack-management-dotnet/tree/v0.6.1) (2026-02-02)
  - Fix
    - Release DELETE request no longer includes Content-Type header to comply with API requirements
diff --git a/Contentstack.Management.Core.Tests/Contentstack.Management.Core.Tests.csproj b/Contentstack.Management.Core.Tests/Contentstack.Management.Core.Tests.csproj
@@ -24,6 +24,7 @@
     <PackageReference Include="AutoFixture.AutoMoq" Version="4.18.1" />
     <PackageReference Include="Moq" Version="4.20.72" />
     <PackageReference Include="Microsoft.AspNetCore.Http" Version="2.3.0" />
+    <PackageReference Include="Newtonsoft.Json" Version="13.0.4" />
   </ItemGroup>
 
   <ItemGroup>
@@ -35,14 +36,17 @@
   <ItemGroup>
     <EmbeddedResource Include="Mock\*.json" />
   </ItemGroup>
+
   <ItemGroup>
-    <Content Include="appsettings.json">
+       <Content Include="appSettings.json">
       <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
     </Content>
   </ItemGroup>
+
   <ItemGroup>
     <None Remove="Microsoft.AspNetCore.Http" />
   </ItemGroup>
+
   <ItemGroup>
     <ProjectReference Include="..\Contentstack.Management.Core\contentstack.management.core.csproj" />
   </ItemGroup>
diff --git a/Contentstack.Management.Core.Tests/IntegrationTest/Contentstack015_BulkOperationTest.cs b/Contentstack.Management.Core.Tests/IntegrationTest/Contentstack015_BulkOperationTest.cs
diff --git a/Contentstack.Management.Core.Unit.Tests/Core/Services/Stack/BulkPublishServiceTest.cs b/Contentstack.Management.Core.Unit.Tests/Core/Services/Stack/BulkPublishServiceTest.cs
@@ -48,25 +48,25 @@ public void Should_Create_Service_With_Valid_Parameters()
         }
 
         [TestMethod]
-        public void Should_Set_Skip_Workflow_Stage_Header_When_True()
+        public void Should_Set_Skip_Workflow_Stage_Query_Parameter_When_True()
         {
             var details = new BulkPublishDetails();
             var service = new BulkPublishService(serializer, new Management.Core.Models.Stack(null), details, skipWorkflowStage: true);
 
             Assert.IsNotNull(service);
-            Assert.IsTrue(service.Headers.ContainsKey("skip_workflow_stage_check"));
-            Assert.AreEqual("true", service.Headers["skip_workflow_stage_check"]);
+            Assert.IsTrue(service.QueryResources.ContainsKey("skip_workflow_stage_check"));
+            Assert.AreEqual("true", service.QueryResources["skip_workflow_stage_check"]);
         }
 
         [TestMethod]
-        public void Should_Set_Approvals_Header_When_True()
+        public void Should_Set_Approvals_Query_Parameter_When_True()
         {
             var details = new BulkPublishDetails();
             var service = new BulkPublishService(serializer, new Management.Core.Models.Stack(null), details, approvals: true);
 
             Assert.IsNotNull(service);
-            Assert.IsTrue(service.Headers.ContainsKey("approvals"));
-            Assert.AreEqual("true", service.Headers["approvals"]);
+            Assert.IsTrue(service.QueryResources.ContainsKey("approvals"));
+            Assert.AreEqual("true", service.QueryResources["approvals"]);
         }
 
         [TestMethod]
diff --git a/Contentstack.Management.Core.Unit.Tests/Core/Services/Stack/BulkUnpublishServiceTest.cs b/Contentstack.Management.Core.Unit.Tests/Core/Services/Stack/BulkUnpublishServiceTest.cs
@@ -48,25 +48,25 @@ public void Should_Create_Service_With_Valid_Parameters()
         }
 
         [TestMethod]
-        public void Should_Set_Skip_Workflow_Stage_Header_When_True()
+        public void Should_Set_Skip_Workflow_Stage_Query_Parameter_When_True()
         {
             var details = new BulkPublishDetails();
             var service = new BulkUnpublishService(serializer, new Management.Core.Models.Stack(null), details, skipWorkflowStage: true);
 
             Assert.IsNotNull(service);
-            Assert.IsTrue(service.Headers.ContainsKey("skip_workflow_stage_check"));
-            Assert.AreEqual("true", service.Headers["skip_workflow_stage_check"]);
+            Assert.IsTrue(service.QueryResources.ContainsKey("skip_workflow_stage_check"));
+            Assert.AreEqual("true", service.QueryResources["skip_workflow_stage_check"]);
         }
 
         [TestMethod]
-        public void Should_Set_Approvals_Header_When_True()
+        public void Should_Set_Approvals_Query_Parameter_When_True()
         {
             var details = new BulkPublishDetails();
             var service = new BulkUnpublishService(serializer, new Management.Core.Models.Stack(null), details, approvals: true);
 
             Assert.IsNotNull(service);
-            Assert.IsTrue(service.Headers.ContainsKey("approvals"));
-            Assert.AreEqual("true", service.Headers["approvals"]);
+            Assert.IsTrue(service.QueryResources.ContainsKey("approvals"));
+            Assert.AreEqual("true", service.QueryResources["approvals"]);
         }
 
         [TestMethod]
diff --git a/Contentstack.Management.Core.Unit.Tests/Services/BulkOperationServicesTest.cs b/Contentstack.Management.Core.Unit.Tests/Services/BulkOperationServicesTest.cs
@@ -142,10 +142,10 @@ public void Test004_BulkPublishService_Initialization()
             Assert.IsNotNull(service);
             Assert.AreEqual("/bulk/publish", service.ResourcePath);
             Assert.AreEqual("POST", service.HttpMethod);
-            Assert.IsTrue(service.Headers.ContainsKey("skip_workflow_stage_check"));
-            Assert.IsTrue(service.Headers.ContainsKey("approvals"));
-            Assert.AreEqual("true", service.Headers["skip_workflow_stage_check"]);
-            Assert.AreEqual("true", service.Headers["approvals"]);
+            Assert.IsTrue(service.QueryResources.ContainsKey("skip_workflow_stage_check"));
+            Assert.IsTrue(service.QueryResources.ContainsKey("approvals"));
+            Assert.AreEqual("true", service.QueryResources["skip_workflow_stage_check"]);
+            Assert.AreEqual("true", service.QueryResources["approvals"]);
         }
 
         [TestMethod]
@@ -197,10 +197,10 @@ public void Test006_BulkPublishService_With_All_Flags()
             var service = new BulkPublishService(_serializer, _stack, publishDetails, true, true, true);
 
             Assert.IsNotNull(service);
-            Assert.IsTrue(service.Headers.ContainsKey("skip_workflow_stage_check"));
-            Assert.IsTrue(service.Headers.ContainsKey("approvals"));
-            Assert.AreEqual("true", service.Headers["skip_workflow_stage_check"]);
-            Assert.AreEqual("true", service.Headers["approvals"]);
+            Assert.IsTrue(service.QueryResources.ContainsKey("skip_workflow_stage_check"));
+            Assert.IsTrue(service.QueryResources.ContainsKey("approvals"));
+            Assert.AreEqual("true", service.QueryResources["skip_workflow_stage_check"]);
+            Assert.AreEqual("true", service.QueryResources["approvals"]);
         }
 
         [TestMethod]
@@ -218,8 +218,8 @@ public void Test007_BulkPublishService_Without_Flags()
             var service = new BulkPublishService(_serializer, _stack, publishDetails, false, false, false);
 
             Assert.IsNotNull(service);
-            Assert.IsFalse(service.Headers.ContainsKey("skip_workflow_stage_check"));
-            Assert.IsFalse(service.Headers.ContainsKey("approvals"));
+            Assert.IsFalse(service.QueryResources.ContainsKey("skip_workflow_stage_check"));
+            Assert.IsFalse(service.QueryResources.ContainsKey("approvals"));
         }
 
         [TestMethod]
@@ -248,8 +248,8 @@ public void Test008_BulkUnpublishService_Initialization()
             Assert.IsNotNull(service);
             Assert.AreEqual("/bulk/unpublish", service.ResourcePath);
             Assert.AreEqual("POST", service.HttpMethod);
-            Assert.IsTrue(service.Headers.ContainsKey("skip_workflow_stage_check"));
-            Assert.IsTrue(service.Headers.ContainsKey("approvals"));
+            Assert.IsTrue(service.QueryResources.ContainsKey("skip_workflow_stage_check"));
+            Assert.IsTrue(service.QueryResources.ContainsKey("approvals"));
         }
 
         [TestMethod]
diff --git a/Contentstack.Management.Core/Models/Workflow.cs b/Contentstack.Management.Core/Models/Workflow.cs
@@ -1,4 +1,4 @@
-﻿using System;
+using System;
 using System.Threading.Tasks;
 using Contentstack.Management.Core.Queryable;
 using Contentstack.Management.Core.Services.Models;
@@ -9,7 +9,7 @@ namespace Contentstack.Management.Core.Models
     public class Workflow: BaseModel<WorkflowModel>
     {
         internal Workflow(Stack stack, string uid)
-            : base(stack, "workflows", uid)
+            : base(stack, "workflow", uid)
         {
             resourcePath = uid == null ? "/workflows" : $"/workflows/{uid}";
         }
diff --git a/Contentstack.Management.Core/Models/WorkflowModel.cs b/Contentstack.Management.Core/Models/WorkflowModel.cs
@@ -1,4 +1,4 @@
-﻿using System.Collections.Generic;
+using System.Collections.Generic;
 using Newtonsoft.Json;
 namespace Contentstack.Management.Core.Models
 {
@@ -37,7 +37,7 @@ public class WorkflowStage
         public bool AllUsers { get; set; } = true;
         [JsonProperty(propertyName: "specificStages")]
         public bool SpecificStages { get; set; } = false;
-        [JsonProperty(propertyName: "enabspecificUsersled")]
+        [JsonProperty(propertyName: "specificUsers")]
         public bool SpecificUsers { get; set; } = false;
         [JsonProperty(propertyName: "entry_lock")]
         public string EntryLock { get; set; }
diff --git a/Contentstack.Management.Core/Services/Stack/BulkOperation/BulkPublishService.cs b/Contentstack.Management.Core/Services/Stack/BulkOperation/BulkPublishService.cs
@@ -35,15 +35,15 @@ public BulkPublishService(JsonSerializer serializer, Contentstack.Management.Cor
             ResourcePath = "/bulk/publish";
             HttpMethod = "POST";
 
-            // Set headers based on parameters
+            // Set query parameters based on options
             if (_skipWorkflowStage)
             {
-                Headers["skip_workflow_stage_check"] = "true";
+                AddQueryResource("skip_workflow_stage_check", "true");
             }
 
             if (_approvals)
             {
-                Headers["approvals"] = "true";
+                AddQueryResource("approvals", "true");
             }
 
             if (_isNested)
diff --git a/Contentstack.Management.Core/Services/Stack/BulkOperation/BulkUnpublishService.cs b/Contentstack.Management.Core/Services/Stack/BulkOperation/BulkUnpublishService.cs
@@ -38,12 +38,12 @@ public BulkUnpublishService(JsonSerializer serializer, Contentstack.Management.C
             // Set headers based on parameters
             if (_skipWorkflowStage)
             {
-                Headers["skip_workflow_stage_check"] = "true";
+                AddQueryResource("skip_workflow_stage_check", "true");
             }
 
             if (_approvals)
             {
-                Headers["approvals"] = "true";
+                AddQueryResource("approvals", "true");
             }
 
             if (_isNested)
diff --git a/Directory.Build.props b/Directory.Build.props
@@ -1,5 +1,5 @@
 <Project>
   <PropertyGroup>
-    <Version>0.6.1</Version>
+    <Version>0.7.0</Version>
   </PropertyGroup>
 </Project>

Original file line number	Diff line number	Diff line change
`@@ -48,25 +48,25 @@ public void Should_Create_Service_With_Valid_Parameters()`
`48`	`48`	`}`
`49`	`49`
`50`	`50`	`[TestMethod]`
`51`		`- public void Should_Set_Skip_Workflow_Stage_Header_When_True()`
	`51`	`+ public void Should_Set_Skip_Workflow_Stage_Query_Parameter_When_True()`
`52`	`52`	`{`
`53`	`53`	`var details = new BulkPublishDetails();`
`54`	`54`	`var service = new BulkPublishService(serializer, new Management.Core.Models.Stack(null), details, skipWorkflowStage: true);`
`55`	`55`
`56`	`56`	`Assert.IsNotNull(service);`
`57`		`- Assert.IsTrue(service.Headers.ContainsKey("skip_workflow_stage_check"));`
`58`		`- Assert.AreEqual("true", service.Headers["skip_workflow_stage_check"]);`
	`57`	`+ Assert.IsTrue(service.QueryResources.ContainsKey("skip_workflow_stage_check"));`
	`58`	`+ Assert.AreEqual("true", service.QueryResources["skip_workflow_stage_check"]);`
`59`	`59`	`}`
`60`	`60`
`61`	`61`	`[TestMethod]`
`62`		`- public void Should_Set_Approvals_Header_When_True()`
	`62`	`+ public void Should_Set_Approvals_Query_Parameter_When_True()`
`63`	`63`	`{`
`64`	`64`	`var details = new BulkPublishDetails();`
`65`	`65`	`var service = new BulkPublishService(serializer, new Management.Core.Models.Stack(null), details, approvals: true);`
`66`	`66`
`67`	`67`	`Assert.IsNotNull(service);`
`68`		`- Assert.IsTrue(service.Headers.ContainsKey("approvals"));`
`69`		`- Assert.AreEqual("true", service.Headers["approvals"]);`
	`68`	`+ Assert.IsTrue(service.QueryResources.ContainsKey("approvals"));`
	`69`	`+ Assert.AreEqual("true", service.QueryResources["approvals"]);`
`70`	`70`	`}`
`71`	`71`
`72`	`72`	`[TestMethod]`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-using System;`
	`1`	`+using System;`
`2`	`2`	`using System.Threading.Tasks;`
`3`	`3`	`using Contentstack.Management.Core.Queryable;`
`4`	`4`	`using Contentstack.Management.Core.Services.Models;`
`@@ -9,7 +9,7 @@ namespace Contentstack.Management.Core.Models`
`9`	`9`	`public class Workflow: BaseModel<WorkflowModel>`
`10`	`10`	`{`
`11`	`11`	`internal Workflow(Stack stack, string uid)`
`12`		`- : base(stack, "workflows", uid)`
	`12`	`+ : base(stack, "workflow", uid)`
`13`	`13`	`{`
`14`	`14`	`resourcePath = uid == null ? "/workflows" : $"/workflows/{uid}";`
`15`	`15`	`}`
Original file line number	Diff line number	Diff line change
`@@ -35,15 +35,15 @@ public BulkPublishService(JsonSerializer serializer, Contentstack.Management.Cor`
`35`	`35`	`ResourcePath = "/bulk/publish";`
`36`	`36`	`HttpMethod = "POST";`
`37`	`37`
`38`		`- // Set headers based on parameters`
	`38`	`+ // Set query parameters based on options`
`39`	`39`	`if (_skipWorkflowStage)`
`40`	`40`	`{`
`41`		`- Headers["skip_workflow_stage_check"] = "true";`
	`41`	`+ AddQueryResource("skip_workflow_stage_check", "true");`
`42`	`42`	`}`
`43`	`43`
`44`	`44`	`if (_approvals)`
`45`	`45`	`{`
`46`		`- Headers["approvals"] = "true";`
	`46`	`+ AddQueryResource("approvals", "true");`
`47`	`47`	`}`
`48`	`48`
`49`	`49`	`if (_isNested)`
Original file line number	Diff line number	Diff line change
`@@ -38,12 +38,12 @@ public BulkUnpublishService(JsonSerializer serializer, Contentstack.Management.C`
`38`	`38`	`// Set headers based on parameters`
`39`	`39`	`if (_skipWorkflowStage)`
`40`	`40`	`{`
`41`		`- Headers["skip_workflow_stage_check"] = "true";`
	`41`	`+ AddQueryResource("skip_workflow_stage_check", "true");`
`42`	`42`	`}`
`43`	`43`
`44`	`44`	`if (_approvals)`
`45`	`45`	`{`
`46`		`- Headers["approvals"] = "true";`
	`46`	`+ AddQueryResource("approvals", "true");`
`47`	`47`	`}`
`48`	`48`
`49`	`49`	`if (_isNested)`