processmaker.com Knowledge Center ProcessMaker University

Processes

API Reference for ProcessMaker Process API

PreviousTasks NextScreens

Last updated 3 months ago

Was this helpful?

Get single process category by ID

get

Display the specified Process category.

Authorizations

Path parameters

process_category_idintegerrequired

ID of process category to return

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url '/api/1.0/process_categories/{process_category_id}'

200

{
  "name": "text",
  "status": "ACTIVE",
  "id": "text",
  "created_at": "2025-03-28T01:25:04.570Z",
  "updated_at": "2025-03-28T01:25:04.570Z"
}

Successfully found the process

Delete a process category

delete

Remove the specified resource from storage.

Authorizations

Path parameters

process_category_idintegerrequired

ID of process category to return

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request DELETE \
  --url '/api/1.0/process_categories/{process_category_id}'

204

{
  "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-03-28T01:25:04.570Z",
  "created_at": "2025-03-28T01:25:04.570Z",
  "updated_at": "2025-03-28T01:25:04.570Z",
  "notifications": {},
  "task_notifications": {}
}

success

Returns all processes that the user has access to

get

Get list Process

Authorizations

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 · enum · default: "asc"optional

Options: asc, desc

per_pageinteger · default: "10"optional

statusstring · enumoptional

ACTIVE or INACTIVE

Options: ACTIVE, INACTIVE

includestring · default: ""optional

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

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url '/api/1.0/processes'

200

{
  "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-03-28T01:25:04.570Z",
      "created_at": "2025-03-28T01:25:04.570Z",
      "updated_at": "2025-03-28T01:25:04.570Z",
      "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
  }
}

list of processes

Get single process by ID

get

Display the specified resource.

Authorizations

Path parameters

processIdintegerrequired

ID of process to return

Query parameters

includestring · default: ""optional

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

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url '/api/1.0/processes/{processId}'

200

{
  "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-03-28T01:25:04.570Z",
  "created_at": "2025-03-28T01:25:04.570Z",
  "updated_at": "2025-03-28T01:25:04.570Z",
  "notifications": {},
  "task_notifications": {}
}

Successfully found the process

Delete a process

delete

Remove the specified resource from storage.

Authorizations

Path parameters

processIdintegerrequired

ID of process to return

Responses

cURL

JavaScript

Python

HTTP

curl -L \
  --request DELETE \
  --url '/api/1.0/processes/{processId}'

204

No body

success

Returns the list of processes that the user can start

get

Returns the list of processes that the user can start.

Authorizations

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 · enum · default: "asc"optional

Options: asc, desc

per_pageinteger · default: "10"optional

includestring · default: ""optional

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

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url '/api/1.0/start_processes'

200

{
  "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-03-28T01:25:04.570Z",
      "created_at": "2025-03-28T01:25:04.570Z",
      "updated_at": "2025-03-28T01:25:04.570Z",
      "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
  }
}

list of processes that the user can start

Restore an inactive process

put

Reverses the soft delete of the element.

Authorizations

Path parameters

processIdintegerrequired

ID of process to return

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request PUT \
  --url '/api/1.0/processes/{processId}/restore'

200

{
  "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-03-28T01:25:04.570Z",
  "created_at": "2025-03-28T01:25:04.570Z",
  "updated_at": "2025-03-28T01:25:04.570Z",
  "notifications": {},
  "task_notifications": {}
}

success

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

post

Export the specified process.

Authorizations

Path parameters

processIdintegerrequired

ID of process to export

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url '/api/1.0/processes/{processId}/export'

200

{
  "url": "text"
}

Successfully built the process for export

Check if the import is ready

head

Check if the import is ready

Authorizations

Path parameters

codestringrequired

Import code

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request HEAD \
  --url '/api/1.0/processes/import/{code}/is_ready'

200

{
  "ready": true
}

check is import is ready

Update a process Category

put

Updates the current element

Authorizations

Path parameters

process_category_idintegerrequired

ID of process category to return

Body

namestringoptional

Represents a business process category definition.

statusstring · enumoptional

Options: ACTIVE, INACTIVE

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request PUT \
  --url '/api/1.0/process_categories/{process_category_id}' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "text",
    "status": "ACTIVE"
  }'

200

{
  "name": "text",
  "status": "ACTIVE",
  "id": "text",
  "created_at": "2025-03-28T01:25:04.570Z",
  "updated_at": "2025-03-28T01:25:04.570Z"
}

success

Save a new process

post

Store a newly created resource in storage.

Authorizations

Body

process_category_idinteger · idoptional

Represents a business process definition.

namestringoptional

descriptionstringoptional

statusstring · enumoptional

Options: ACTIVE, INACTIVE, ARCHIVED

pause_timer_startintegeroptional

cancel_screen_idintegeroptional

has_timer_start_eventsbooleanoptional

request_detail_screen_idinteger · idoptional

is_validintegeroptional

package_keystringoptional

start_eventsobject[]optional

warningsstringoptional

self_service_tasksobjectoptional

signal_eventsobject[]optional

categoryobjectoptional

manager_idinteger · idoptional

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url '/api/1.0/processes' \
  --header 'Content-Type: application/json' \
  --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
  }'

201

{
  "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-03-28T01:25:04.570Z",
  "created_at": "2025-03-28T01:25:04.570Z",
  "updated_at": "2025-03-28T01:25:04.570Z",
  "notifications": {},
  "task_notifications": {}
}

success

Update a process

put

Updates the current element.

Authorizations

Path parameters

processIdintegerrequired

ID of process to return

Body

process_category_idinteger · idoptional

Represents a business process definition.

namestringoptional

descriptionstringoptional

statusstring · enumoptional

Options: ACTIVE, INACTIVE, ARCHIVED

pause_timer_startintegeroptional

cancel_screen_idintegeroptional

has_timer_start_eventsbooleanoptional

request_detail_screen_idinteger · idoptional

is_validintegeroptional

package_keystringoptional

start_eventsobject[]optional

warningsstringoptional

self_service_tasksobjectoptional

signal_eventsobject[]optional

categoryobjectoptional

manager_idinteger · idoptional

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request PUT \
  --url '/api/1.0/processes/{processId}' \
  --header 'Content-Type: application/json' \
  --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
  }'

200

{
  "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-03-28T01:25:04.570Z",
  "created_at": "2025-03-28T01:25:04.570Z",
  "updated_at": "2025-03-28T01:25:04.570Z",
  "notifications": {},
  "task_notifications": {}
}

success

Validate a import

post

Validate the specified process before importing.

Authorizations

Body

filestring · binaryoptional

file to import

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url '/api/1.0/processes/import/validation' \
  --header 'Content-Type: multipart/form-data' \
  --form 'file=binary'

200

{
  "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
}

success

Import a new process

post

Import the specified process.

Authorizations

Body

filestring · binaryoptional

file to import

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url '/api/1.0/processes/import' \
  --header 'Content-Type: multipart/form-data' \
  --form 'file=binary'

200

{
  "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
}

success

Update assignments after import

post

Import Assignments of process.

Authorizations

Path parameters

process_idintegerrequired

ID of process to return

Body

assignableobject[]optional

cancel_requestobjectoptional

edit_dataobjectoptional

Responses

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url '/api/1.0/processes/{process_id}/import/assignments' \
  --header 'Content-Type: application/json' \
  --data '{
    "assignable": [
      {}
    ],
    "cancel_request": {},
    "edit_data": {}
  }'

204

No body

success

Start a new process

post

Trigger an start event within a process.

Authorizations

Path parameters

process_idintegerrequired

ID of process to return

Query parameters

eventstringrequired

Node ID of the start event

Body

objectoptional

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url '/api/1.0/process_events/{process_id}?event=text' \
  --header 'Content-Type: application/json' \
  --data '{}'

200

{
  "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-03-28T01:25:04.570Z",
  "updated_at": "2025-03-28T01:25:04.570Z",
  "user": null,
  "participants": [
    {
      "email": "name@gmail.com",
      "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-03-28T01:25:04.570Z",
          "updated_at": "2025-03-28T01:25:04.570Z"
        }
      ],
      "birthdate": "2025-03-28",
      "delegation_user_id": "text",
      "manager_id": "text",
      "meta": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "force_change_password": true,
      "id": 1,
      "created_at": "2025-03-28T01:25:04.570Z",
      "updated_at": "2025-03-28T01:25:04.570Z",
      "deleted_at": "2025-03-28T01:25:04.570Z"
    }
  ]
}

success

Save a new process Category

post

Store a newly created Process Category in storage

Authorizations

Body

namestringoptional

Represents a business process category definition.

statusstring · enumoptional

Options: ACTIVE, INACTIVE

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url '/api/1.0/process_categories' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "text",
    "status": "ACTIVE"
  }'

201

{
  "name": "text",
  "status": "ACTIVE",
  "id": "text",
  "created_at": "2025-03-28T01:25:04.570Z",
  "updated_at": "2025-03-28T01:25:04.570Z"
}

success

Returns all processes categories that the user has access to

get

Display a listing of the Process Categories.

Authorizations

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 · enum · default: "asc"optional

Options: asc, desc

per_pageinteger · default: "10"optional

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url '/api/1.0/process_categories'

200

{
  "data": [
    {
      "name": "text",
      "status": "ACTIVE",
      "id": "text",
      "created_at": "2025-03-28T01:25:04.570Z",
      "updated_at": "2025-03-28T01:25:04.570Z"
    }
  ],
  "meta": {}
}

list of processes categories

Get single process category by ID

Delete a process category

Returns all processes that the user has access to

Get single process by ID

Delete a process

Returns the list of processes that the user can start

Restore an inactive process

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

Check if the import is ready

Update a process Category

Save a new process

Show child attributes

Show child attributes

Show child attributes

Show child attributes

Update a process

Show child attributes

Show child attributes

Show child attributes

Show child attributes

Validate a import

Import a new process

Update assignments after import

Show child attributes

Show child attributes

Show child attributes

Start a new process

Show child attributes

Save a new process Category

Returns all processes categories that the user has access to