Retrieves the form key for a task. The form key corresponds to the FormData#formKey property in the engine. This key can be used to do task-specific form rendering in client applications. Additionally, the context path of the containing process application is returned.

Method

GET /task/{id}/form

Parameters

Path Parameters

Name Description
id The id of the task to retrieve the form for.

Result

A JSON object containing the form key.

Name Value Description
key String The form key for the task.
contextPath String The process application's context path the task belongs to. If the task does not belong to a process application deployment or a process definition at all, this property is not set.

Response Codes

Code Media type Description
200 application/json Request successful.
400 application/json Task with given id does not exist. See the Introduction for the error response format.

Example

Request

GET /task/anId/form

Response

{"key":"aFormKey",
"contextPath":"http://localhost:8080/my-process-application/"}

On this Page: