GET /bpm-engine/api/process-definitions

As of Version

product version 2021 Autumn | component version

Request Method GET

Response Format JSON

Description

Retrieves a list of process definitions matching the conditions defined in various query parameters.

The following query parameters can optionally be added to the request URL.

Parameter	Type	Description
`category`	string	Only return process definitions with the given category.
`categoryLike`	string	Only return process definitions with a category like the given name.
`categoryNotEquals`	string	Only return process definitions which do not have the given category.
`key`	string	Only return process definitions with the given key.
`keyLike`	string	Only return process definitions with a name like the given key.
`latest`	boolean	Only return the latest process definition versions. Can only be used together with `key` and `keyLike` parameters. Combination with any other parameter will result in an error with HTTP status code `400`.
`name`	string	Only return process definitions with the given name.
`nameLike`	string	Only return process definitions with a name like the given name.
`page`	integer($int32)	Results page you want to retrieve (0…N). Default is `0` which means the first page.
`size`	integer($int32)	Number of objects per page.
`sort`	string	Sorting of results either ascending (`asc`) or descending (`desc`). Default sort order is ascending.
`startableByUser`	string	A valid user ID. Only return process definitions which user specified by the ID is authorized to start.
`suspended`	boolean	If `true`, only suspended process definitions which are returned. If `false`, only active process definitions (which are not suspended) are returned.
`version`	integer	Only return process definitions with the given version.

Meaning of HTTP status codes:

HTTP Status Code	Description
200	Request was successful and the process definitions are returned.
400	A parameter was passed in the wrong format or `latest` is used with other parameters other than `key` and `keyLike`. The status message contains additional information.
401	The calling user is not authorized.

Request Header Content-Type: application/json

Request Example

https://<host>/bpm-engine/api/process-definitions/?page=0&size=50&sort=desc&version=1

Response Example

{
  "objects": [
    {
      "id": "follow-up:1:00000000-0000-0000-0000-000000000000",
      "category": "examplecategory",
      "key": "follow-up",
      "name": "Follow-up",
      "description": "Follow up any document (NOTE: The start-form enforces 1 parameter (expiryDateTime) and 1 optional parameter (whatAbout))",
      "version": 1,
      "global": false,
      "startFormDefined": true,
      "suspended": false
    },
    {
      "id": "onesteptest_proc:1:00000000-0000-0000-0000-000000000001",
      "category": "exampleprocess",
      "key": "onesteptest_proc",
      "name": "One step test process",
      "description": null,
      "version": 1,
      "global": false,
      "startFormDefined": false,
      "suspended": false
    },
    {
      "id": "twosteptest_proc:1:00000000-0000-0000-0000-000000000002",
      "category": "exampleprocess",
      "key": "twosteptest_proc",
      "name": "Process-definition-name: Two step test process",
      "description": "This is description from model editor (high level, not the visual editor of process). The first step goes to initiator, second to no one (can be played with id-links). There is one form reference (get group id) in the first task.",
      "version": 1,
      "global": false,
      "startFormDefined": false,
      "suspended": false
    }
  ],
  "numItems": 3,
  "totalNumItems": 3,
  "hasMoreItems": false
}