Tasks

API Reference for ProcessMaker Task API

Create or update a new setting

post

Create a new Settings css-override

Authorizations

passport & bearer

OAuth2authorizationCodeRequired

Laravel passport oauth2 security.

Authorization URL: Token URL: Refresh URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

variablesstringOptional

sansSerifFontstringOptional

Responses

201

success

application/json

post

/customize-ui

HTTPcURLJavaScriptPython

POST /api/1.0/customize-ui HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 43

{
  "variables": "text",
  "sansSerifFont": "text"
}

201

success

{
  "key": "text",
  "config": [
    {}
  ],
  "name": "text",
  "helper": "text",
  "group": "text",
  "format": "text",
  "hidden": true,
  "readonly": true,
  "variables": "text",
  "sansSerifFont": "text",
  "id": "text",
  "created_at": "2026-01-07T13:35:34.783Z",
  "updated_at": "2026-01-07T13:35:34.783Z"
}

Returns all task assignments

get

Display a listing of the resource.

Authorizations

passport & bearer

OAuth2authorizationCodeRequired

Laravel passport oauth2 security.

Authorization URL: Token URL: Refresh URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

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

Responses

200

list of task assignments

application/json

get

/task_assignments

HTTPcURLJavaScriptPython

GET /api/1.0/task_assignments HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

list of task assignments

{
  "data": [
    {
      "process_id": 1,
      "process_task_id": "text",
      "assignment_id": 1,
      "assignment_type": "ProcessMaker\\Models\\User",
      "id": 1,
      "created_at": "2026-01-07T13:35:34.783Z",
      "updated_at": "2026-01-07T13:35:34.783Z"
    }
  ],
  "meta": {}
}

Save a new Task Assignment

post

Store a newly created task assignment in storage.

Authorizations

passport & bearer

OAuth2authorizationCodeRequired

Laravel passport oauth2 security.

Authorization URL: Token URL: Refresh URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

process_idinteger · idOptional

Represents a business process task assignment definition.

process_task_idstring · idOptional

assignment_idinteger · idOptional

assignment_typestring · enumOptionalPossible values:

Responses

201

success

application/json

422

Unprocessable Entity

application/json

post

/task_assignments

HTTPcURLJavaScriptPython

POST /api/1.0/task_assignments HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 106

{
  "process_id": 1,
  "process_task_id": "text",
  "assignment_id": 1,
  "assignment_type": "ProcessMaker\\Models\\User"
}

{
  "process_id": 1,
  "process_task_id": "text",
  "assignment_id": 1,
  "assignment_type": "ProcessMaker\\Models\\User",
  "id": 1,
  "created_at": "2026-01-07T13:35:34.783Z",
  "updated_at": "2026-01-07T13:35:34.783Z"
}

Update a Task Assignment

put

Update a task assignment

Authorizations

passport & bearer

OAuth2authorizationCodeRequired

Laravel passport oauth2 security.

Authorization URL: Token URL: Refresh URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

task_assignmentintegerRequired

ID of task assignment to update

Body

application/json

process_idinteger · idOptional

Represents a business process task assignment definition.

process_task_idstring · idOptional

assignment_idinteger · idOptional

assignment_typestring · enumOptionalPossible values:

Responses

204

success

404

Not Found

application/json

422

Unprocessable Entity

application/json

put

/task_assignments/{task_assignment}

HTTPcURLJavaScriptPython

PUT /api/1.0/task_assignments/{task_assignment} HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 106

{
  "process_id": 1,
  "process_task_id": "text",
  "assignment_id": 1,
  "assignment_type": "ProcessMaker\\Models\\User"
}

No content

Delete a Task Assignment

delete

Remove an assignment

Authorizations

passport & bearer

OAuth2authorizationCodeRequired

Laravel passport oauth2 security.

Authorization URL: Token URL: Refresh URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

task_assignmentintegerRequired

ID of task assignment to delete

Body

application/json

process_idinteger · idOptional

Represents a business process task assignment definition.

process_task_idstring · idOptional

assignment_idinteger · idOptional

assignment_typestring · enumOptionalPossible values:

Responses

200

success

delete

/task_assignments/{task_assignment}

HTTPcURLJavaScriptPython

DELETE /api/1.0/task_assignments/{task_assignment} HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 106

{
  "process_id": 1,
  "process_task_id": "text",
  "assignment_id": 1,
  "assignment_type": "ProcessMaker\\Models\\User"
}

200

success

No content

Returns all tasks that the user has access to

get

Display a listing of the resource.

Authorizations

passport & bearer

OAuth2authorizationCodeRequired

Laravel passport oauth2 security.

Authorization URL: Token URL: Refresh URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

process_request_idintegerOptional

Process request id

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:

includestringOptional

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

Default: ""

Responses

200

list of tasks

application/json

get

/tasks

HTTPcURLJavaScriptPython

GET /api/1.0/tasks HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

list of tasks

{
  "data": [
    {
      "user_id": "text",
      "status": "text",
      "due_at": "2026-01-07T13:35:34.783Z",
      "initiated_at": "2026-01-07T13:35:34.783Z",
      "riskchanges_at": "2026-01-07T13:35:34.783Z",
      "subprocess_start_event_id": "text",
      "data": {},
      "id": "text",
      "process_id": "text",
      "process_request_id": "text",
      "element_id": "text",
      "element_type": "text",
      "element_index": "text",
      "element_name": "text",
      "created_at": "2026-01-07T13:35:34.783Z",
      "updated_at": "2026-01-07T13:35:34.783Z",
      "advanceStatus": "text",
      "due_notified": 1,
      "user": {},
      "process": {},
      "process_request": {}
    }
  ],
  "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
  }
}

Get a single task by ID

get

Display the specified resource.

Authorizations

passport & bearer

OAuth2authorizationCodeRequired

Laravel passport oauth2 security.

Authorization URL: Token URL: Refresh URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

task_idintegerRequired

task id

Query parameters

includestringOptional

include

Responses

200

success

application/json

404

Not Found

application/json

get

/tasks/{task_id}

HTTPcURLJavaScriptPython

GET /api/1.0/tasks/{task_id} HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "user_id": "text",
  "status": "text",
  "due_at": "2026-01-07T13:35:34.783Z",
  "initiated_at": "2026-01-07T13:35:34.783Z",
  "riskchanges_at": "2026-01-07T13:35:34.783Z",
  "subprocess_start_event_id": "text",
  "data": {},
  "id": "text",
  "process_id": "text",
  "process_request_id": "text",
  "element_id": "text",
  "element_type": "text",
  "element_index": "text",
  "element_name": "text",
  "created_at": "2026-01-07T13:35:34.783Z",
  "updated_at": "2026-01-07T13:35:34.783Z",
  "advanceStatus": "text",
  "due_notified": 1,
  "user": {},
  "process": {},
  "process_request": {}
}

Update a task

put

Updates the current element

Authorizations

passport & bearer

OAuth2authorizationCodeRequired

Laravel passport oauth2 security.

Authorization URL: Token URL: Refresh URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

task_idintegerRequired

ID of task to update

Body

application/json

statusstringRequiredExample: COMPLETED

dataobjectRequired

Responses

200

success

application/json

404

Not Found

application/json

422

Unprocessable Entity

application/json

put

/tasks/{task_id}

HTTPcURLJavaScriptPython

PUT /api/1.0/tasks/{task_id} HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 32

{
  "status": "COMPLETED",
  "data": {}
}

{
  "user_id": "text",
  "status": "text",
  "due_at": "2026-01-07T13:35:34.783Z",
  "initiated_at": "2026-01-07T13:35:34.783Z",
  "riskchanges_at": "2026-01-07T13:35:34.783Z",
  "subprocess_start_event_id": "text",
  "data": {},
  "id": "text",
  "process_id": "text",
  "process_request_id": "text",
  "element_id": "text",
  "element_type": "text",
  "element_index": "text",
  "element_name": "text",
  "created_at": "2026-01-07T13:35:34.783Z",
  "updated_at": "2026-01-07T13:35:34.783Z",
  "advanceStatus": "text",
  "due_notified": 1,
  "user": {},
  "process": {},
  "process_request": {}
}