Get Process Definition

No authentication is required to get process definition

Known limitations

If you want the process to be accessible without authentication, you need to add some configuration when designing the process.

Method

GET /process-definition/{id}

GET /process-definition/key/{key} (returns the latest version of the process definition which belongs to no tenant)

Parameters

Path Parameters

Name Description
id The id of the process definition to be retrieved.
key The key of the process definition (the latest version thereof) to be retrieved.

Result

A JSON object corresponding to the ProcessDefinition interface in the engine. Its properties are as follows:

Name Type Description
id String The id of the process definition.
key String The key of the process definition, i.e., the id of the BPMN 2.0 XML process definition.
category String The category of the process definition.
description String The description of the process definition.
name String The name of the process definition.
version Number The version of the process definition that the engine assigned to it.
resource String The file name of the process definition.
deploymentId String The deployment id of the process definition.
diagram String The file name of the process definition diagram, if it exists.
suspended Boolean A flag indicating whether the definition is suspended or not.
tenantId String The tenant id of the process definition.
versionTag String The version tag of the process definition.
historyTimeToLive Number History time to live value of the process definition. Is used within History cleanup.
startableInTasklist Boolean A flag indicating whether the process definition is startable in Tasklist or not.
formId String The process defintion start event form id.
formData Object FormId corresponds to the form details.

Response Codes

Code Media type Description
200 application/json Request successful.
404 application/json Process definition with given id or key does not exist. See the Introduction for the error response format.

Example

Request

GET /enhancement/open/process-definition/invoice:1:c3a63aaa-2046-11e7-8f94-34f39ab71d4e

GET /enhancement/open/process-definition/key/invoice

Response

{
  "id":"invoice:1:c3a63aaa-2046-11e7-8f94-34f39ab71d4e",
  "key":"invoice",
  "category":"http://www.omg.org/spec/BPMN/20100524/MODEL",
  "description":null,
  "name":"Invoice Receipt",
  "version":1,
  "resource":"invoice.v1.bpmn",
  "deploymentId":"c398cd26-2046-11e7-8f94-34f39ab71d4e",
  "diagram":null,
  "suspended":false,
  "tenantId":null,
  "versionTag":null,
  "historyTimeToLive":5,
  "startableInTasklist": true
}

On this Page: