/
[PUT] /variables

[PUT] /variables

/api/bpm/tasks/{id}/variables

Description

Enables the update of variable values associated with a workflow task. The request body must include either the id or the name of the variable to be updated, along with its new value(s). The values provided in the request must match the format returned by the GET endpoint.

If a null value is sent for a variable, that variable’s value will be deleted. If a variable is not included in the request, it remains unchanged.

Required Systemrole

R_WFADM_START (ID = 20)

Request
Method

PUT

Response
Format

JSON

Minimum Version

1.0.0

Request
Example

/api/bpm/tasks/33AFD89453E248B4BC7CBF594D64BE36/variables

Request
Example

{ "objects": [{ "id": "72FA13878B7C4744BB33C58B5AAFF5F0", "value": [ [ "25.05.2022", "17:18:31", "I'll be back", null, "test" ], [ "25.05.2023", "18:18:31", "I'll be back", null, "test" ], null ] }, { "id": "04A6DFE4517F44689DD45DD28D6F6107", "value": "Test" } ]}

Result Example

Response HTTP status codes:

  • 200 - The task was found and the list of variables was updated.

  • 404 - The requested task was not found.

  • 400 - The requested variable values are not in the correct format.

  • 500 - Server error.