/
[POST] /process-definitions

[POST] /process-definitions

/api/bpm/process-definitions

Description

Creates a new process definition inside a specified family. The name of the new process definition and the id of the target parent family are sent in the request body as name and parentId. The parent must be a family.

Optionally, an organizationId can be sent as a query parameter if the target family belongs to a non-active organization - by default, the active organization is used.

After successful creation, the new process definition is returned with the id and creation timestamp assigned by the enaio server. The process definition is created in state EDIT_UNLOCKED, meaning it is immediately available for editing.

Required System-role

R_WFEDIT_START (ID = 21)

Request
Method

POST

Request Optional Query Parameter

  • organizationId (String): The Id of the organization. If not set, the active organization is used.

Response
Format

JSON

Minimum Version

BPM Service: 1.5.0
enaio Server: 13.0

Request
Example

/api/bpm/process-definitions

/api/bpm/process-definitions?organizationId=914FC91A55D542F79D8ED1BADDE1AFE6

{ "name": "New process definition", "parentId": "1D3F4694BF1B4056B8A9DF75CE36006C" }

Result
Example

{ "objects": [{ "id": "62AFC01A55B555F70DAED1DAADE1EF00", "name": "New process definition", "parentId": "1D3F4694BF1B4056B8A9DF75CE36006C", "userId": "146B2B9F2E334E6EA97FF566E6E8EDBA", "createTime": "2026-05-19T11:46:00+02:00", "state": "EDIT_UNLOCKED" }] }