Submit Task Form
Completes a task and updates process variables using a form submit. There are two difference between this method and the complete
method:
- If the task is in state
PENDING
- i.e., has been delegated before, it is not completed but resolved. Otherwise it will be completed. - If the task has Form Field Metadata defined, the process engine will perform backend validation for any form fields which have validators defined. See the Generated Task Forms section of the User Guide for more information.
Method
POST /task/{id}/submit-form
Parameters
Path Parameters
Name | Description |
---|---|
id | The id of the task to submit the form for. |
Request Body
A JSON object with the following properties:
Name | Description | ||||||||
---|---|---|---|---|---|---|---|---|---|
variables | A JSON object containing variable key-value pairs. Each key is a variable name and each value a JSON variable value object and has the following properties:
|
Result
This method returns no content.
Response Codes
Code | Media type | Description |
---|---|---|
204 | Request successful. | |
400 | application/json | The variable value or type is invalid, for example if the value could not be parsed to an Integer value or the passed variable type is not supported. See the Introduction for the error response format. |
500 | application/json | If the task does not exist or the corresponding process instance could not be resumed successfully. See the Introduction for the error response format. |
Example
Request
POST /task/anId/submit-form
Request Body:
{
"variables": {
"aVariable": {
"value": "aStringValue"
},
"anotherVariable": {
"value": 42
},
"aThirdVariable": {
"value": true
},
"aFileVariable": {
"value": "TG9yZW0gaXBzdW0=",
"type": "File",
"valueInfo": {
"filename": "myFile.txt"
}
}
}
}
Response
Status 204. No content.