Get Definition

Retrieves a process definition according to the ProcessDefinition interface in the engine.

Method

GET /process-definition/{id}

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

GET /process-definition/key/{key}/tenant-id/{tenant-id} (returns the latest version of the process definition for 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.
tenant-id	The id of the tenant the process definition belongs to.

Result

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

Name	Value	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.

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 /process-definition/invoice:1:c3a63aaa-2046-11e7-8f94-34f39ab71d4e

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

Options