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/"}