Get Deployed Start Form
Retrieves the deployed form that can be referenced from a start event. For further information please refer to User Guide.
Method
GET
/process-definition/{id}/deployed-start-form
GET
/process-definition/key/{key}/deployed-start-form
GET
/process-definition/key/{key}/tenant-id/{tenant-id}/deployed-start-form
Parameters
Path Parameters
Name | Description |
---|---|
id | The id of the process definition to get the deployed start form for. |
key | The key of the process definition (the latest version thereof) to be retrieved. |
tenant-id | The id of the tenant the process definitions belong to. |
Result
An object with the deployed start form content.
Response Codes
Code | Media type | Description |
---|---|---|
200 | application/xhtml+xml | Request successful. |
400 | application/json | The form key has wrong format. See the Introduction for the error response format. |
403 | application/json | The deployed start form cannot be retrieved due to missing permissions on process definition resource. See the Introduction for the error response format. |
404 | application/json | No deployed start form for a given process definition exists. See the Introduction for the error response format. |
Example
Request
GET /process-definition/processDefinitionId/deployed-start-form
GET /process-definition/key/processDefinitionKey/deployed-start-form
GET /process-definition/key/processDefinitionKey/tenant-id/tenantId/deployed-start-form
Response
<form role="form" name="invoiceForm"
class="form-horizontal">
<div class="form-group">
<label class="control-label col-md-4"
for="creditor">Creditor</label>
<div class="col-md-8">
<input cam-variable-name="creditor"
cam-variable-type="String"
id="creditor"
class="form-control"
type="text"
required />
<div class="help">
(e.g. "Great Pizza for Everyone Inc.")
</div>
</div>
</div>
</form>