/
[POST] /{id}/copy

[POST] /{id}/copy

/api/bpm/process-definitions/{id}/copy

Description

Creates a copy of an existing process definition identified by {id}.

The copy is created in the target organization under the specified family. The new process definition inherits the workflow model of the source but is treated as an independent definition — it can be edited, versioned, and started separately from the original.

The request body must specify:

  • sourceOrganizationId — the organization the source process definition belongs to

  • targetOrganizationId — the organization where the copy will be created

  • targetFamilyId — the family in the target organization the copy will be placed under

  • targetName — the name for the copied process definition

On success, the full details of the newly created process definition are returned, including its generated id, parentId, name, type, version, state, userId, createTime, and optionally iconId, description, and locking information if applicable (same data as [GET] /process-definitions without optional parameters).

Required Systemrole

R_WFEDIT_START (ID = 21)

Request
Method

POST

Response
Format

JSON

Minimum Version

BPM Service: 1.5.0
enaio Server: 12.10

Request
Example

/api/bpm/process-definitions/020BE136312646B6B90E0ED84B66DCE8/copy

{ "sourceOrganizationId": "0947CC57A9C24B3E8D1DC27BAE777CBE", "targetOrganizationId": "0947CC57A9C24B3E8D1DC27BAE777CBE", "targetFamilyId": "9BB398531BAE4792B494DB161EAA40CB", "targetName": "Process Definition Copy" }

Result
Example

{ "id": "82656722C1E64489B87B8A2B1D727626", "parentId": "9BB398531BAE4792B494DB161EAA40CB", "name": "Process Definition Copy", "userId": "BF894230A0324FB887CDD732FCDDD61D", "createTime": "2026-04-14T02:04:58+02:00", "type": "PROCESS_DEFINITION", "version": 6, "state": "EDIT_UNLOCKED", "iconId": 1073742164 }