Processes

API Reference for ProcessMaker Process API

Returns all processes categories that the user has access to

get

Display a listing of the Process Categories.

Authorizations

passportbearer

Query parameters

filterstringOptional

Filter results by string. Searches Name and Status. All fields must match exactly.

order_bystringOptional

Field to order results by

order_directionstring · enumOptionalDefault: ascPossible values:

per_pageintegerOptionalDefault: 10

Responses

200

list of processes categories

application/json

get

HTTPcURLJavaScriptPython

GET /api/1.0/process_categories HTTP/1.1
Host: 
Accept: */*

200

list of processes categories

{
  "data": [
    {
      "name": "text",
      "status": "ACTIVE",
      "id": "text",
      "created_at": "2025-05-01T05:48:19.392Z",
      "updated_at": "2025-05-01T05:48:19.392Z"
    }
  ],
  "meta": {}
}

Save a new process Category

post

Store a newly created Process Category in storage

Authorizations

passportbearer

Body

namestringOptional

Represents a business process category definition.

statusstring · enumOptionalPossible values:

Responses

201

success

application/json

Responseall of

post

HTTPcURLJavaScriptPython

POST /api/1.0/process_categories HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 33

{
  "name": "text",
  "status": "ACTIVE"
}

201

success

{
  "name": "text",
  "status": "ACTIVE",
  "id": "text",
  "created_at": "2025-05-01T05:48:19.392Z",
  "updated_at": "2025-05-01T05:48:19.392Z"
}

Get single process category by ID

get

Display the specified Process category.

Authorizations

passportbearer

Path parameters

process_category_idintegerRequired

ID of process category to return

Responses

200

Successfully found the process

application/json

Responseall of

get

HTTPcURLJavaScriptPython

GET /api/1.0/process_categories/{process_category_id} HTTP/1.1
Host: 
Accept: */*

200

Successfully found the process

{
  "name": "text",
  "status": "ACTIVE",
  "id": "text",
  "created_at": "2025-05-01T05:48:19.392Z",
  "updated_at": "2025-05-01T05:48:19.392Z"
}

Update a process Category

put

Updates the current element

Authorizations

passportbearer

Path parameters

process_category_idintegerRequired

ID of process category to return

Body

namestringOptional

Represents a business process category definition.

statusstring · enumOptionalPossible values:

Responses

200

success

application/json

Responseall of

put

HTTPcURLJavaScriptPython

PUT /api/1.0/process_categories/{process_category_id} HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 33

{
  "name": "text",
  "status": "ACTIVE"
}

200

success

{
  "name": "text",
  "status": "ACTIVE",
  "id": "text",
  "created_at": "2025-05-01T05:48:19.392Z",
  "updated_at": "2025-05-01T05:48:19.392Z"
}

Delete a process category

delete

Remove the specified resource from storage.

Authorizations

passportbearer

Path parameters

process_category_idintegerRequired

ID of process category to return

Responses

204

success

application/json

Responseall of

delete

HTTPcURLJavaScriptPython

DELETE /api/1.0/process_categories/{process_category_id} HTTP/1.1
Host: 
Accept: */*

204

success

{
  "process_category_id": 1,
  "name": "text",
  "description": "text",
  "status": "ACTIVE",
  "pause_timer_start": 1,
  "cancel_screen_id": 1,
  "has_timer_start_events": true,
  "request_detail_screen_id": 1,
  "is_valid": 1,
  "package_key": "text",
  "start_events": [
    {
      "eventDefinitions": {},
      "parallelMultiple": true,
      "outgoing": {},
      "incoming": {},
      "id": "text",
      "name": "text"
    }
  ],
  "warnings": "text",
  "self_service_tasks": {},
  "signal_events": [
    {}
  ],
  "category": {},
  "manager_id": 1,
  "user_id": 1,
  "id": "text",
  "deleted_at": "2025-05-01T05:48:19.392Z",
  "created_at": "2025-05-01T05:48:19.392Z",
  "updated_at": "2025-05-01T05:48:19.392Z",
  "notifications": {},
  "task_notifications": {}
}

Returns all processes that the user has access to

get

Get list Process

Authorizations

passportbearer

Query parameters

filterstringOptional

Filter results by string. Searches Name, Description, and Status. Status must match exactly. Others can be a substring.

order_bystringOptional

Field to order results by

order_directionstring · enumOptionalDefault: ascPossible values:

per_pageintegerOptionalDefault: 10

statusstring · enumOptional

ACTIVE or INACTIVE

Possible values:

includestringOptional

Include data from related models in payload. Comma separated list.

Default: ""

Responses

200

list of processes

application/json

get

HTTPcURLJavaScriptPython

GET /api/1.0/processes HTTP/1.1
Host: 
Accept: */*

200

list of processes

{
  "data": [
    {
      "process_category_id": 1,
      "name": "text",
      "description": "text",
      "status": "ACTIVE",
      "pause_timer_start": 1,
      "cancel_screen_id": 1,
      "has_timer_start_events": true,
      "request_detail_screen_id": 1,
      "is_valid": 1,
      "package_key": "text",
      "start_events": [
        {
          "eventDefinitions": {},
          "parallelMultiple": true,
          "outgoing": {},
          "incoming": {},
          "id": "text",
          "name": "text"
        }
      ],
      "warnings": "text",
      "self_service_tasks": {},
      "signal_events": [
        {}
      ],
      "category": {},
      "manager_id": 1,
      "user_id": 1,
      "id": "text",
      "deleted_at": "2025-05-01T05:48:19.392Z",
      "created_at": "2025-05-01T05:48:19.392Z",
      "updated_at": "2025-05-01T05:48:19.392Z",
      "notifications": {},
      "task_notifications": {}
    }
  ],
  "meta": {
    "filter": "text",
    "sort_by": "text",
    "sort_order": "asc",
    "count": 1,
    "total_pages": 1,
    "current_page": 1,
    "form": 1,
    "last_page": 1,
    "path": "text",
    "per_page": 1,
    "to": 1,
    "total": 1
  }
}

Save a new process

post

Store a newly created resource in storage.

Authorizations

passportbearer

Body

process_category_idinteger · idOptional

Represents a business process definition.

namestringOptional

descriptionstringOptional

statusstring · enumOptionalPossible values:

pause_timer_startintegerOptional

cancel_screen_idintegerOptional

has_timer_start_eventsbooleanOptional

request_detail_screen_idinteger · idOptional

is_validintegerOptional

package_keystringOptional

warningsstringOptional

self_service_tasksobjectOptional

signal_eventsobject[]Optional

categoryobjectOptional

manager_idinteger · idOptional

Responses

201

success

application/json

Responseall of

post

HTTPcURLJavaScriptPython

POST /api/1.0/processes HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 425

{
  "process_category_id": 1,
  "name": "text",
  "description": "text",
  "status": "ACTIVE",
  "pause_timer_start": 1,
  "cancel_screen_id": 1,
  "has_timer_start_events": true,
  "request_detail_screen_id": 1,
  "is_valid": 1,
  "package_key": "text",
  "start_events": [
    {
      "eventDefinitions": {},
      "parallelMultiple": true,
      "outgoing": {},
      "incoming": {},
      "id": "text",
      "name": "text"
    }
  ],
  "warnings": "text",
  "self_service_tasks": {},
  "signal_events": [
    {}
  ],
  "category": {},
  "manager_id": 1
}

201

success

{
  "process_category_id": 1,
  "name": "text",
  "description": "text",
  "status": "ACTIVE",
  "pause_timer_start": 1,
  "cancel_screen_id": 1,
  "has_timer_start_events": true,
  "request_detail_screen_id": 1,
  "is_valid": 1,
  "package_key": "text",
  "start_events": [
    {
      "eventDefinitions": {},
      "parallelMultiple": true,
      "outgoing": {},
      "incoming": {},
      "id": "text",
      "name": "text"
    }
  ],
  "warnings": "text",
  "self_service_tasks": {},
  "signal_events": [
    {}
  ],
  "category": {},
  "manager_id": 1,
  "user_id": 1,
  "id": "text",
  "deleted_at": "2025-05-01T05:48:19.392Z",
  "created_at": "2025-05-01T05:48:19.392Z",
  "updated_at": "2025-05-01T05:48:19.392Z",
  "notifications": {},
  "task_notifications": {}
}

Get single process by ID

get

Display the specified resource.

Authorizations

passportbearer

Path parameters

processIdintegerRequired

ID of process to return

Query parameters

includestringOptional

Include data from related models in payload. Comma separated list.

Default: ""

Responses

200

Successfully found the process

application/json

Responseall of

get

HTTPcURLJavaScriptPython

GET /api/1.0/processes/{processId} HTTP/1.1
Host: 
Accept: */*

200

Successfully found the process

{
  "process_category_id": 1,
  "name": "text",
  "description": "text",
  "status": "ACTIVE",
  "pause_timer_start": 1,
  "cancel_screen_id": 1,
  "has_timer_start_events": true,
  "request_detail_screen_id": 1,
  "is_valid": 1,
  "package_key": "text",
  "start_events": [
    {
      "eventDefinitions": {},
      "parallelMultiple": true,
      "outgoing": {},
      "incoming": {},
      "id": "text",
      "name": "text"
    }
  ],
  "warnings": "text",
  "self_service_tasks": {},
  "signal_events": [
    {}
  ],
  "category": {},
  "manager_id": 1,
  "user_id": 1,
  "id": "text",
  "deleted_at": "2025-05-01T05:48:19.392Z",
  "created_at": "2025-05-01T05:48:19.392Z",
  "updated_at": "2025-05-01T05:48:19.392Z",
  "notifications": {},
  "task_notifications": {}
}

Update a process

put

Updates the current element.

Authorizations

passportbearer

Path parameters

processIdintegerRequired

ID of process to return

Body

process_category_idinteger · idOptional

Represents a business process definition.

namestringOptional

descriptionstringOptional

statusstring · enumOptionalPossible values:

pause_timer_startintegerOptional

cancel_screen_idintegerOptional

has_timer_start_eventsbooleanOptional

request_detail_screen_idinteger · idOptional

is_validintegerOptional

package_keystringOptional

warningsstringOptional

self_service_tasksobjectOptional

signal_eventsobject[]Optional

categoryobjectOptional

manager_idinteger · idOptional

Responses

200

success

application/json

Responseall of

put

HTTPcURLJavaScriptPython

PUT /api/1.0/processes/{processId} HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 425

{
  "process_category_id": 1,
  "name": "text",
  "description": "text",
  "status": "ACTIVE",
  "pause_timer_start": 1,
  "cancel_screen_id": 1,
  "has_timer_start_events": true,
  "request_detail_screen_id": 1,
  "is_valid": 1,
  "package_key": "text",
  "start_events": [
    {
      "eventDefinitions": {},
      "parallelMultiple": true,
      "outgoing": {},
      "incoming": {},
      "id": "text",
      "name": "text"
    }
  ],
  "warnings": "text",
  "self_service_tasks": {},
  "signal_events": [
    {}
  ],
  "category": {},
  "manager_id": 1
}

200

success

{
  "process_category_id": 1,
  "name": "text",
  "description": "text",
  "status": "ACTIVE",
  "pause_timer_start": 1,
  "cancel_screen_id": 1,
  "has_timer_start_events": true,
  "request_detail_screen_id": 1,
  "is_valid": 1,
  "package_key": "text",
  "start_events": [
    {
      "eventDefinitions": {},
      "parallelMultiple": true,
      "outgoing": {},
      "incoming": {},
      "id": "text",
      "name": "text"
    }
  ],
  "warnings": "text",
  "self_service_tasks": {},
  "signal_events": [
    {}
  ],
  "category": {},
  "manager_id": 1,
  "user_id": 1,
  "id": "text",
  "deleted_at": "2025-05-01T05:48:19.392Z",
  "created_at": "2025-05-01T05:48:19.392Z",
  "updated_at": "2025-05-01T05:48:19.392Z",
  "notifications": {},
  "task_notifications": {}
}

Delete a process

delete

Remove the specified resource from storage.

Authorizations

passportbearer

Path parameters

processIdintegerRequired

ID of process to return

Responses

204

success

delete

HTTPcURLJavaScriptPython

DELETE /api/1.0/processes/{processId} HTTP/1.1
Host: 
Accept: */*

204

success

No content

Returns the list of processes that the user can start

get

Returns the list of processes that the user can start.

Authorizations

passportbearer

Path parameters

without_event_definitionsbooleanOptional

If true return only processes that haven't start event definitions

Query parameters

filterstringOptional

Filter results by string. Searches Name, Description, and Status. Status must match exactly. Others can be a substring.

order_bystringOptional

Field to order results by

order_directionstring · enumOptionalDefault: ascPossible values:

per_pageintegerOptionalDefault: 10

includestringOptional

Include data from related models in payload. Comma separated list.

Default: ""

Responses

200

list of processes that the user can start

application/json

get

HTTPcURLJavaScriptPython

GET /api/1.0/start_processes HTTP/1.1
Host: 
Accept: */*

200

list of processes that the user can start

{
  "data": [
    {
      "process_category_id": 1,
      "name": "text",
      "description": "text",
      "status": "ACTIVE",
      "pause_timer_start": 1,
      "cancel_screen_id": 1,
      "has_timer_start_events": true,
      "request_detail_screen_id": 1,
      "is_valid": 1,
      "package_key": "text",
      "start_events": [
        {
          "eventDefinitions": {},
          "parallelMultiple": true,
          "outgoing": {},
          "incoming": {},
          "id": "text",
          "name": "text"
        }
      ],
      "warnings": "text",
      "self_service_tasks": {},
      "signal_events": [
        {}
      ],
      "category": {},
      "manager_id": 1,
      "user_id": 1,
      "id": "text",
      "deleted_at": "2025-05-01T05:48:19.392Z",
      "created_at": "2025-05-01T05:48:19.392Z",
      "updated_at": "2025-05-01T05:48:19.392Z",
      "notifications": {},
      "task_notifications": {}
    },
    {
      "events": [
        {
          "eventDefinitions": {},
          "parallelMultiple": true,
          "outgoing": {},
          "incoming": {},
          "id": "text",
          "name": "text"
        }
      ]
    }
  ],
  "meta": {
    "filter": "text",
    "sort_by": "text",
    "sort_order": "asc",
    "count": 1,
    "total_pages": 1,
    "current_page": 1,
    "form": 1,
    "last_page": 1,
    "path": "text",
    "per_page": 1,
    "to": 1,
    "total": 1
  }
}

Restore an inactive process

put

Reverses the soft delete of the element.

Authorizations

passportbearer

Path parameters

processIdintegerRequired

ID of process to return

Responses

200

success

application/json

Responseall of

put

HTTPcURLJavaScriptPython

PUT /api/1.0/processes/{processId}/restore HTTP/1.1
Host: 
Accept: */*

200

success

{
  "process_category_id": 1,
  "name": "text",
  "description": "text",
  "status": "ACTIVE",
  "pause_timer_start": 1,
  "cancel_screen_id": 1,
  "has_timer_start_events": true,
  "request_detail_screen_id": 1,
  "is_valid": 1,
  "package_key": "text",
  "start_events": [
    {
      "eventDefinitions": {},
      "parallelMultiple": true,
      "outgoing": {},
      "incoming": {},
      "id": "text",
      "name": "text"
    }
  ],
  "warnings": "text",
  "self_service_tasks": {},
  "signal_events": [
    {}
  ],
  "category": {},
  "manager_id": 1,
  "user_id": 1,
  "id": "text",
  "deleted_at": "2025-05-01T05:48:19.392Z",
  "created_at": "2025-05-01T05:48:19.392Z",
  "updated_at": "2025-05-01T05:48:19.392Z",
  "notifications": {},
  "task_notifications": {}
}

Export a single process by ID and return a URL to download it

post

Export the specified process.

Authorizations

passportbearer

Path parameters

processIdintegerRequired

ID of process to export

Responses

200

Successfully built the process for export

application/json

post

HTTPcURLJavaScriptPython

POST /api/1.0/processes/{processId}/export HTTP/1.1
Host: 
Accept: */*

200

Successfully built the process for export

{
  "url": "text"
}

Validate a import

post

Validate the specified process before importing.

Authorizations

passportbearer

Body

filestring · binaryOptional

file to import

Responses

200

success

application/json

Responseall of

post

HTTPcURLJavaScriptPython

POST /api/1.0/processes/import/validation HTTP/1.1
Host: 
Content-Type: multipart/form-data
Accept: */*
Content-Length: 17

{
  "file": "binary"
}

200

success

{
  "process_category_id": 1,
  "name": "text",
  "description": "text",
  "status": [
    {}
  ],
  "pause_timer_start": 1,
  "cancel_screen_id": 1,
  "has_timer_start_events": true,
  "request_detail_screen_id": 1,
  "is_valid": 1,
  "package_key": "text",
  "start_events": [
    {
      "eventDefinitions": {},
      "parallelMultiple": true,
      "outgoing": {},
      "incoming": {},
      "id": "text",
      "name": "text"
    }
  ],
  "warnings": "text",
  "self_service_tasks": {},
  "signal_events": [
    {}
  ],
  "category": {},
  "manager_id": 1,
  "assignable": [
    {}
  ],
  "process": null
}

Import a new process

post

Import the specified process.

Authorizations

passportbearer

Body

filestring · binaryOptional

file to import

Responses

200

success

application/json

Responseall of

post

HTTPcURLJavaScriptPython

POST /api/1.0/processes/import HTTP/1.1
Host: 
Content-Type: multipart/form-data
Accept: */*
Content-Length: 17

{
  "file": "binary"
}

200

success

{
  "process_category_id": 1,
  "name": "text",
  "description": "text",
  "status": [
    {}
  ],
  "pause_timer_start": 1,
  "cancel_screen_id": 1,
  "has_timer_start_events": true,
  "request_detail_screen_id": 1,
  "is_valid": 1,
  "package_key": "text",
  "start_events": [
    {
      "eventDefinitions": {},
      "parallelMultiple": true,
      "outgoing": {},
      "incoming": {},
      "id": "text",
      "name": "text"
    }
  ],
  "warnings": "text",
  "self_service_tasks": {},
  "signal_events": [
    {}
  ],
  "category": {},
  "manager_id": 1,
  "assignable": [
    {}
  ],
  "process": null
}

Check if the import is ready

head

Check if the import is ready

Authorizations

passportbearer

Path parameters

codestringRequired

Import code

Responses

200

check is import is ready

application/json

head

HTTPcURLJavaScriptPython

HEAD /api/1.0/processes/import/{code}/is_ready HTTP/1.1
Host: 
Accept: */*

200

check is import is ready

{
  "ready": true
}

Update assignments after import

post

Import Assignments of process.

Authorizations

passportbearer

Path parameters

process_idintegerRequired

ID of process to return

Body

assignableobject[]Optional

cancel_requestobjectOptional

edit_dataobjectOptional

Responses

204

success

post

HTTPcURLJavaScriptPython

POST /api/1.0/processes/{process_id}/import/assignments HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 54

{
  "assignable": [
    {}
  ],
  "cancel_request": {},
  "edit_data": {}
}

204

success

No content

Start a new process

post

Trigger an start event within a process.

Authorizations

passportbearer

Path parameters

process_idintegerRequired

ID of process to return

Query parameters

eventstringRequired

Node ID of the start event

Body

objectOptional

Responses

200

success

application/json

Responseall of

post

HTTPcURLJavaScriptPython

POST /api/1.0/process_events/{process_id}?event=text HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 2

{}

200

success

{
  "user_id": "text",
  "callable_id": "text",
  "data": {},
  "status": "ACTIVE",
  "name": "text",
  "process_id": "text",
  "process": {},
  "id": "text",
  "process_collaboration_id": "text",
  "participant_id": "text",
  "process_category_id": "text",
  "created_at": "2025-05-01T05:48:19.392Z",
  "updated_at": "2025-05-01T05:48:19.392Z",
  "user": null,
  "participants": [
    {
      "email": "[e-mail]",
      "firstname": "text",
      "lastname": "text",
      "username": "text",
      "password": "text",
      "address": "text",
      "city": "text",
      "state": "text",
      "postal": "text",
      "country": "text",
      "phone": "text",
      "fax": "text",
      "cell": "text",
      "title": "text",
      "timezone": "text",
      "datetime_format": "text",
      "language": "text",
      "is_administrator": true,
      "expires_at": "text",
      "loggedin_at": "text",
      "remember_token": "text",
      "status": "ACTIVE",
      "fullname": "text",
      "avatar": "text",
      "media": [
        {
          "id": 1,
          "model_id": 1,
          "model_type": "text",
          "collection_name": "text",
          "name": "text",
          "file_name": "text",
          "mime_type": "text",
          "disk": "text",
          "size": 1,
          "manipulations": {},
          "custom_properties": {},
          "responsive_images": {},
          "order_column": 1,
          "created_at": "2025-05-01T05:48:19.392Z",
          "updated_at": "2025-05-01T05:48:19.392Z"
        }
      ],
      "birthdate": "2025-05-01",
      "delegation_user_id": "text",
      "manager_id": "text",
      "meta": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "force_change_password": true,
      "id": 1,
      "created_at": "2025-05-01T05:48:19.392Z",
      "updated_at": "2025-05-01T05:48:19.392Z",
      "deleted_at": "2025-05-01T05:48:19.392Z"
    }
  ]
}