Update camunda REST API doc

api/camunda/v2/camunda-openapi.yaml

@@ -325,6 +325,8 @@ paths:
     $ref: "user-tasks.yaml#/paths/~1user-tasks~1{userTaskKey}~1assignee"
   /user-tasks/{userTaskKey}/assignment:
     $ref: "user-tasks.yaml#/paths/~1user-tasks~1{userTaskKey}~1assignment"
+  /user-tasks/{userTaskKey}/audit-logs/search:
+    $ref: "user-tasks.yaml#/paths/~1user-tasks~1{userTaskKey}~1audit-logs~1search"
   /user-tasks/{userTaskKey}/completion:
     $ref: "user-tasks.yaml#/paths/~1user-tasks~1{userTaskKey}~1completion"
   /user-tasks/{userTaskKey}/form:

api/camunda/v2/process-instances.yaml

@@ -1518,9 +1518,11 @@ components:
         mapping:
           direct: "#/components/schemas/DirectAncestorKeyInstruction"
           inferred: "#/components/schemas/InferredAncestorKeyInstruction"
+          sourceParent: "#/components/schemas/UseSourceParentKeyInstruction"
       oneOf:
         - $ref: "#/components/schemas/DirectAncestorKeyInstruction"
         - $ref: "#/components/schemas/InferredAncestorKeyInstruction"
+        - $ref: "#/components/schemas/UseSourceParentKeyInstruction"
     DirectAncestorKeyInstruction:
       type: object
       description: Provides a concrete key to use as ancestor scope for the created element instance.
@@ -1553,6 +1555,17 @@ components:
           example: inferred
       required:
         - ancestorScopeType
+    UseSourceParentKeyInstruction:
+      type: object
+      description: |
+        Instructs the engine to use the source's direct parent key as the ancestor scope key for the target element. This is a simpler alternative to `inferred` that skips hierarchy traversal and directly uses the source's parent key. This is useful when the source and target elements are siblings within the same flow scope.
+      properties:
+        ancestorScopeType:
+          description: The type of ancestor scope instruction.
+          type: string
+          example: sourceParent
+      required:
+        - ancestorScopeType
     ProcessInstanceModificationTerminateInstruction:
       description: Instruction describing which elements to terminate.
       oneOf:

api/camunda/v2/user-tasks.yaml

@@ -352,6 +352,44 @@ paths:
           $ref: "common-responses.yaml#/components/responses/InvalidData"
         "500":
           $ref: "common-responses.yaml#/components/responses/InternalServerError"
+  /user-tasks/{userTaskKey}/audit-logs/search:
+    post:
+      tags:
+        - User task
+      operationId: searchUserTaskAuditLogs
+      summary: Search user task audit logs
+      description: |-
+
+
+        [[CONSISTENCY:EVENTUAL]]
+
+        Search for user task audit logs based on given criteria.
+      parameters:
+        - name: userTaskKey
+          in: path
+          required: true
+          description: The key of the user task.
+          schema:
+            type: string
+            format: string<UserTaskKey>
+            description: System-generated key for a user task.
+      requestBody:
+        required: false
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/UserTaskAuditLogSearchQueryRequest"
+      responses:
+        "200":
+          description: The user task audit log search result.
+          content:
+            application/json:
+              schema:
+                $ref: "audit-logs.yaml#/components/schemas/AuditLogSearchQueryResult"
+        "400":
+          $ref: "common-responses.yaml#/components/responses/InvalidData"
+        "500":
+          $ref: "common-responses.yaml#/components/responses/InternalServerError"
 components:
   schemas:
     UserTaskSearchQuerySortRequest:
@@ -693,6 +731,17 @@ components:
           allOf:
             - $ref: "#/components/schemas/UserTaskVariableFilter"
           description: The user task variable search filters.
+    UserTaskAuditLogSearchQueryRequest:
+      allOf:
+        - $ref: "search-models.yaml#/components/schemas/SearchQueryRequest"
+      description: User task search query request.
+      type: object
+      properties:
+        sort:
+          description: Sort field criteria.
+          type: array
+          items:
+            $ref: "audit-logs.yaml#/components/schemas/AuditLogSearchQuerySortRequest"
     UserTaskStateEnum:
       description: The state of the user task.
       type: string

docs/apis-tools/orchestration-cluster-api-rest/specifications/modify-process-instance.api.mdx

@@ -5,7 +5,7 @@ description: "<MarkerStronglyConsistentExtension /> [Learn about endpoint consis
 sidebar_label: "Modify process instance"
 hide_title: true
 hide_table_of_contents: true
-api: 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
+api: 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
 sidebar_class_name: "post api-method"
 info_path: docs/apis-tools/orchestration-cluster-api-rest/specifications/orchestration-cluster-api
 custom_edit_url: null
@@ -386,6 +386,21 @@ For example, because an external system is not available or doesn't respond as e
                           required: ["ancestorScopeType"],
                           title: "InferredAncestorKeyInstruction",
                         },
+                        sourceParent: {
+                          type: "object",
+                          description:
+                            "Instructs the engine to use the source's direct parent key as the ancestor scope key for the target element. This is a simpler alternative to `inferred` that skips hierarchy traversal and directly uses the source's parent key. This is useful when the source and target elements are siblings within the same flow scope.\n",
+                          properties: {
+                            ancestorScopeType: {
+                              description:
+                                "The type of ancestor scope instruction.",
+                              type: "string",
+                              example: "sourceParent",
+                            },
+                          },
+                          required: ["ancestorScopeType"],
+                          title: "UseSourceParentKeyInstruction",
+                        },
                       },
                     },
                     oneOf: [
@@ -445,6 +460,21 @@ For example, because an external system is not available or doesn't respond as e
                         required: ["ancestorScopeType"],
                         title: "InferredAncestorKeyInstruction",
                       },
+                      {
+                        type: "object",
+                        description:
+                          "Instructs the engine to use the source's direct parent key as the ancestor scope key for the target element. This is a simpler alternative to `inferred` that skips hierarchy traversal and directly uses the source's parent key. This is useful when the source and target elements are siblings within the same flow scope.\n",
+                        properties: {
+                          ancestorScopeType: {
+                            description:
+                              "The type of ancestor scope instruction.",
+                            type: "string",
+                            example: "sourceParent",
+                          },
+                        },
+                        required: ["ancestorScopeType"],
+                        title: "UseSourceParentKeyInstruction",
+                      },
                     ],
                     title: "AncestorScopeInstruction",
                   },