From b12e80c7ded6db496c36759c423c2938d86a689b Mon Sep 17 00:00:00 2001
From: Julian Haupt <julian@haupt.media>
Date: Fri, 22 Nov 2024 10:31:40 +0100
Subject: [PATCH] openapi(tasks): include task state in response specification
 (#247)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Related to https://github.com/camunda/camunda-bpm-platform/issues/4683

Backported commit d27a7be1a70 from the camunda-bpm-platform repository.
Original author: Joaquín <joaquin.felici@camunda.com>
---
 .../engine/rest/dto/history/HistoricTaskInstanceDto.ftl   | 8 +++++++-
 .../operaton/bpm/engine/rest/dto/runtime/task/TaskDto.ftl | 7 ++++++-
 2 files changed, 13 insertions(+), 2 deletions(-)

diff --git a/engine-rest/engine-rest-openapi/src/main/templates/models/org/operaton/bpm/engine/rest/dto/history/HistoricTaskInstanceDto.ftl b/engine-rest/engine-rest-openapi/src/main/templates/models/org/operaton/bpm/engine/rest/dto/history/HistoricTaskInstanceDto.ftl
index 872fea7e749..93ed4b1a63d 100644
--- a/engine-rest/engine-rest-openapi/src/main/templates/models/org/operaton/bpm/engine/rest/dto/history/HistoricTaskInstanceDto.ftl
+++ b/engine-rest/engine-rest-openapi/src/main/templates/models/org/operaton/bpm/engine/rest/dto/history/HistoricTaskInstanceDto.ftl
@@ -167,7 +167,13 @@
       type = "string"
       desc = "The process instance id of the root process instance that initiated the process
               containing this task."
-      last = true
+  />
+
+  <@lib.property
+    name = "taskState"
+    type = "string"
+    desc = "The task's state."
+    last = true
   />
 
 </@lib.dto>
diff --git a/engine-rest/engine-rest-openapi/src/main/templates/models/org/operaton/bpm/engine/rest/dto/runtime/task/TaskDto.ftl b/engine-rest/engine-rest-openapi/src/main/templates/models/org/operaton/bpm/engine/rest/dto/runtime/task/TaskDto.ftl
index 03789707e3d..978d0e49c0f 100644
--- a/engine-rest/engine-rest-openapi/src/main/templates/models/org/operaton/bpm/engine/rest/dto/runtime/task/TaskDto.ftl
+++ b/engine-rest/engine-rest-openapi/src/main/templates/models/org/operaton/bpm/engine/rest/dto/runtime/task/TaskDto.ftl
@@ -129,8 +129,13 @@
     <@lib.property
         name = "tenantId"
         type = "string"
-        last = true
         desc = "If not `null`, the tenant id of the task." />
 
+    <@lib.property
+        name = "taskState"
+        type = "string"
+        desc = "The task's state."
+        last = true />
+
 </@lib.dto>
 </#macro>