processmaker.com Knowledge Center ProcessMaker University

Requests

API Reference for ProcessMaker Request API

PreviousGroups NextTasks

Last updated 2 months ago

Was this helpful?

Create or update a new setting

Create a new Settings css-override

post

/customize-ui

Authorizations

Body

variablesstring

sansSerifFontstring

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url '/api/1.0/customize-ui' \
  --header 'Content-Type: application/json'

201

{
  "key": "text",
  "name": "text",
  "helper": "text",
  "group": "text",
  "format": "text",
  "hidden": true,
  "readonly": true,
  "variables": "text",
  "sansSerifFont": "text",
  "config": [
    {}
  ],
  "id": "text",
  "created_at": "2025-02-20T19:15:52.611Z",
  "updated_at": "2025-02-20T19:15:52.611Z"
}

success

Returns all process Requests that the user has access to

Display a listing of the resource.

get

/requests

Authorizations

Query parameters

typestring · enum

Only return requests by type (all|in_progress|completed)

Options: all, in_progress, completed, started_me

filterstring

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

order_bystring

Field to order results by

order_directionstring · enum · default: asc

Options: asc, desc

per_pageinteger · default: 10

includestring

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

Responses

application/json

cURL

JavaScript

Python

HTTP

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

200

{
  "meta": {
    "filter": "text",
    "sort_by": "text",
    "count": 1,
    "total_pages": 1,
    "current_page": 1,
    "form": 1,
    "last_page": 1,
    "path": "text",
    "per_page": 1,
    "to": 1,
    "total": 1,
    "sort_order": "asc"
  },
  "data": [
    {
      "user_id": "text",
      "callable_id": "text",
      "data": {},
      "name": "text",
      "process_id": "text",
      "process": {},
      "status": "ACTIVE",
      "user": null,
      "id": "text",
      "process_collaboration_id": "text",
      "participant_id": "text",
      "process_category_id": "text",
      "created_at": "2025-02-20T19:15:52.611Z",
      "updated_at": "2025-02-20T19:15:52.611Z",
      "participants": [
        {
          "email": "hello@example.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",
          "fullname": "text",
          "avatar": "text",
          "birthdate": "2025-02-20",
          "delegation_user_id": "text",
          "manager_id": "text",
          "meta": {
            "ANY_ADDITIONAL_PROPERTY": "anything"
          },
          "force_change_password": true,
          "status": "ACTIVE",
          "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-02-20T19:15:52.611Z",
              "updated_at": "2025-02-20T19:15:52.611Z"
            }
          ],
          "id": 1,
          "created_at": "2025-02-20T19:15:52.611Z",
          "updated_at": "2025-02-20T19:15:52.611Z",
          "deleted_at": "2025-02-20T19:15:52.611Z"
        }
      ]
    }
  ]
}

list of processes

Get single process request by ID

Display the specified resource.

get

/requests/{process_request_id}

Authorizations

Path parameters

process_request_idintegerrequired

ID of process request to return

Query parameters

includestring

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

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url '/api/1.0/requests/{process_request_id}'

200

404

{
  "user_id": "text",
  "callable_id": "text",
  "data": {},
  "name": "text",
  "process_id": "text",
  "process": {},
  "status": "ACTIVE",
  "user": null,
  "id": "text",
  "process_collaboration_id": "text",
  "participant_id": "text",
  "process_category_id": "text",
  "created_at": "2025-02-20T19:15:52.611Z",
  "updated_at": "2025-02-20T19:15:52.611Z",
  "participants": [
    {
      "email": "hello@example.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",
      "fullname": "text",
      "avatar": "text",
      "birthdate": "2025-02-20",
      "delegation_user_id": "text",
      "manager_id": "text",
      "meta": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "force_change_password": true,
      "status": "ACTIVE",
      "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-02-20T19:15:52.611Z",
          "updated_at": "2025-02-20T19:15:52.611Z"
        }
      ],
      "id": 1,
      "created_at": "2025-02-20T19:15:52.611Z",
      "updated_at": "2025-02-20T19:15:52.611Z",
      "deleted_at": "2025-02-20T19:15:52.611Z"
    }
  ]
}

Successfully found the process

Update a process request

Update a request

put

/requests/{process_request_id}

Authorizations

Path parameters

process_request_idintegerrequired

ID of process request to return

Body

user_idstring · id

Represents an Eloquent model of a Request which is an instance of a Process.

callable_idstring · id

dataobject

namestring

process_idinteger

processobject

statusstring · enum

Options: ACTIVE, COMPLETED, ERROR, CANCELED

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request PUT \
  --url '/api/1.0/requests/{process_request_id}' \
  --header 'Content-Type: application/json' \
  --data '{"data":{},"process":{},"status":"ACTIVE"}'

204

404

No body

success

Delete a process request

Delete a request

delete

/requests/{process_request_id}

Authorizations

Path parameters

process_request_idintegerrequired

ID of process request to return

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request DELETE \
  --url '/api/1.0/requests/{process_request_id}'

204

404

{
  "user_id": "text",
  "callable_id": "text",
  "data": {},
  "name": "text",
  "process_id": "text",
  "process": {},
  "status": "ACTIVE",
  "user": null,
  "id": "text",
  "process_collaboration_id": "text",
  "participant_id": "text",
  "process_category_id": "text",
  "created_at": "2025-02-20T19:15:52.611Z",
  "updated_at": "2025-02-20T19:15:52.611Z",
  "participants": [
    {
      "email": "hello@example.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",
      "fullname": "text",
      "avatar": "text",
      "birthdate": "2025-02-20",
      "delegation_user_id": "text",
      "manager_id": "text",
      "meta": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "force_change_password": true,
      "status": "ACTIVE",
      "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-02-20T19:15:52.611Z",
          "updated_at": "2025-02-20T19:15:52.611Z"
        }
      ],
      "id": 1,
      "created_at": "2025-02-20T19:15:52.611Z",
      "updated_at": "2025-02-20T19:15:52.611Z",
      "deleted_at": "2025-02-20T19:15:52.611Z"
    }
  ]
}

success

Update a process request event

Trigger a intermediate catch event

post

/requests/{process_request_id}/events/{event_id}

Authorizations

Path parameters

process_request_idstringrequired

ID of process request to return

event_idstringrequired

ID of process event to return

Responses

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url '/api/1.0/requests/{process_request_id}/events/{event_id}'

204

No body

success

Returns the list of files associated with a request

Display a listing of the resource.

get

/requests/{request_id}/files

Authorizations

Path parameters

request_idintegerrequired

ID of the request

Query parameters

filterstring

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

order_bystring

Field to order results by

order_directionstring · enum · default: asc

Options: asc, desc

per_pageinteger · default: 10

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url '/api/1.0/requests/{request_id}/files'

200

{
  "data": [
    {
      "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-02-20T19:15:52.611Z",
      "updated_at": "2025-02-20T19:15:52.611Z"
    }
  ],
  "meta": {
    "filter": "text",
    "sort_by": "text",
    "count": 1,
    "total_pages": 1,
    "current_page": 1,
    "form": 1,
    "last_page": 1,
    "path": "text",
    "per_page": 1,
    "to": 1,
    "total": 1,
    "sort_order": "asc"
  }
}

list of files

Save a new media file to a request

Store a newly created resource in storage.

post

/requests/{request_id}/files

Authorizations

Path parameters

request_idintegerrequired

ID of the request

Query parameters

data_namestring

Variable name in the request data to use for the file name

Body

filestring · binary

save a new media file

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url '/api/1.0/requests/{request_id}/files' \
  --header 'Content-Type: multipart/form-data'

200

{
  "message": "text",
  "fileUploadId": 1
}

success

Get a file uploaded to a request

Display the specified resource.

get

/requests/{request_id}/files/{file_id}

Authorizations

Path parameters

request_idintegerrequired

ID of the request

file_idintegerrequired

ID of the file to return

Responses

application/octet-stream

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url '/api/1.0/requests/{request_id}/files/{file_id}'

200

404

text

File stream

Delete all media associated with a request

Remove the specified resource from storage.

delete

/requests/{request_id}/files/{file_id}

Authorizations

Path parameters

file_idintegerrequired

ID of the file

request_idstringrequired

ID of the request

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request DELETE \
  --url '/api/1.0/requests/{request_id}/files/{file_id}'

204

404

No body

success