Skip to main content

Update Human Task

Endpoint: POST /api/human/tasks/{taskId}/update

Updates or completes a claimed Human task with the form field inputs.

The invoking user should be one of the following:

  • Cluster admin
  • Task owner of the Human task
  • Task claimant

Path parameters

ParameterDescriptionTypeRequired/ Optional
taskIdThe unique identifier for the Human task execution to be updated.stringRequired.

Query parameters

ParameterDescriptionTypeRequired/ Optional
completeWhether to mark the task as complete or not. Set to false to keep the task in progress. Default is false.booleanOptional.

Response body

Format the request as an object containing the form field inputs.

Example

{
"formFieldName": "yourInputHere"
}

Examples

Update a claimed Human task

Request

curl -X 'POST' \
'https://<YOUR_CLUSTER>/api/human/tasks/869ed0ee-cf07-11ef-a89d-86a819bd92bf/update' \
-H 'accept: */*' \
-H 'X-Authorization: <TOKEN>' \
-H 'Content-Type: application/json' \
-d '{
"policyType": "travel",
"payout": true
}'

Response

Returns 200 OK, indicating that the Human task has been updated successfully.

Complete a claimed Human task

Request

curl -X 'POST' \
'https://<YOUR_CLUSTER>/api/human/tasks/869ed0ee-cf07-11ef-a89d-86a819bd92bf/update?complete=true' \
-H 'accept: */*' \
-H 'X-Authorization: <TOKEN>' \
-H 'Content-Type: application/json' \
-d '{
"policyType": "travel",
"payout": true
}'

Response

Returns 200 OK, indicating that the Human task has been completed successfully.