ProcessMaker Developers Documentation
processmaker.comKnowledge CenterProcessMaker University
API
API
  • ProcessMaker Platform API Documentation
    • ProcessMaker Platform RESTful API
  • Platform API Reference
    • Users
    • Groups
    • Requests
    • Tasks
    • Processes
    • Screens
    • Environment Variables
    • Files
    • Notifications
    • Scripts
    • Administrative APIs
  • Premium API Reference
    • Data Connectors
    • Collections
    • Decision Engine
    • Saved Search
    • Versions
  • Tools
    • Postman Collection
Powered by GitBook
On this page
Edit on GitHub
  1. Platform API Reference

Users

API Reference for ProcessMaker Users API

PreviousProcessMaker Platform RESTful APINextGroups

Last updated 5 months ago

Get single user by ID

get

Display the specified resource.

Authorizations
Path parameters
user_idintegerRequired

ID of user to return

Responses
200
Successfully found the process
application/json
Responseall of
404
Not Found
application/json
get
GET /api/1.0/users/{user_id} HTTP/1.1
Host: 
Accept: */*
{
  "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-05-21T22:15:03.160Z",
      "updated_at": "2025-05-21T22:15:03.160Z"
    }
  ],
  "birthdate": "2025-05-21",
  "delegation_user_id": "text",
  "manager_id": "text",
  "meta": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "force_change_password": true,
  "id": 1,
  "created_at": "2025-05-21T22:15:03.160Z",
  "updated_at": "2025-05-21T22:15:03.160Z",
  "deleted_at": "2025-05-21T22:15:03.160Z"
}

Delete a user

delete

Delete a user

Authorizations
Path parameters
user_idintegerRequired

ID of user to delete

Responses
204
success
404
Not Found
application/json
delete
DELETE /api/1.0/users/{user_id} HTTP/1.1
Host: 
Accept: */*

No content

Display listing of access tokens for the specified user.

get

Display listing of access tokens for the specified user.

Authorizations
Path parameters
user_idintegerRequired

User id

Query parameters
per_pageintegerOptionalDefault: 10
Responses
200
List of tokens.
application/json
get
GET /api/1.0/users/{user_id}/tokens HTTP/1.1
Host: 
Accept: */*
200

List of tokens.

{
  "data": [
    {
      "id": "text",
      "user_id": 1,
      "client_id": 1,
      "name": "text",
      "scopes": {},
      "revoked": true,
      "client": {
        "id": 1,
        "user_id": 1,
        "name": "text",
        "provider": "text",
        "redirect": "text",
        "personal_access_client": true,
        "password_client": true,
        "revoked": true,
        "created_at": "2025-05-21T22:15:03.160Z",
        "updated_at": "2025-05-21T22:15:03.160Z"
      },
      "created_at": "2025-05-21T22:15:03.160Z",
      "updated_at": "2025-05-21T22:15:03.160Z",
      "expires_at": "2025-05-21T22:15:03.160Z"
    }
  ],
  "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 single token by ID

get

Show a personal access token for the user

Authorizations
Path parameters
user_idintegerRequired

ID of user

token_idstringRequired

ID of token to return

Responses
200
Successfully found the token
application/json
get
GET /api/1.0/users/{user_id}/tokens/{token_id} HTTP/1.1
Host: 
Accept: */*
200

Successfully found the token

{
  "id": "text",
  "user_id": 1,
  "client_id": 1,
  "name": "text",
  "scopes": {},
  "revoked": true,
  "client": {
    "id": 1,
    "user_id": 1,
    "name": "text",
    "provider": "text",
    "redirect": "text",
    "personal_access_client": true,
    "password_client": true,
    "revoked": true,
    "created_at": "2025-05-21T22:15:03.160Z",
    "updated_at": "2025-05-21T22:15:03.160Z"
  },
  "created_at": "2025-05-21T22:15:03.160Z",
  "updated_at": "2025-05-21T22:15:03.160Z",
  "expires_at": "2025-05-21T22:15:03.160Z"
}

Delete a token

delete

Delete the given token for a user

Authorizations
Path parameters
user_idintegerRequired

User ID

token_idstringRequired

Token ID

Responses
204
success
delete
DELETE /api/1.0/users/{user_id}/tokens/{token_id} HTTP/1.1
Host: 
Accept: */*
204

success

No content

  • GETReturns all users
  • POSTSave a new users
  • GETGet single user by ID
  • PUTUpdate a user
  • DELETEDelete a user
  • PUTSet the groups a users belongs to
  • PUTRestore a soft deleted user
  • GETDisplay listing of access tokens for the specified user.
  • POSTCreate new token for a specific user
  • GETGet single token by ID
  • DELETEDelete a token

Returns all users

get

Display a listing of the resource.

Authorizations
Query parameters
statusstring · enumOptional

ACTIVE or INACTIVE

Possible values:
filterstringOptional

Filter results by string. Searches First Name, Last Name, Email and Username.

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: ""
exclude_idsstringOptional

Comma separated list of IDs to exclude from the response

Default: ""
Responses
200
list of users
application/json
get
GET /api/1.0/users HTTP/1.1
Host: 
Accept: */*
200

list of users

{
  "data": [
    {
      "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-05-21T22:15:03.160Z",
          "updated_at": "2025-05-21T22:15:03.160Z"
        }
      ],
      "birthdate": "2025-05-21",
      "delegation_user_id": "text",
      "manager_id": "text",
      "meta": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "force_change_password": true,
      "id": 1,
      "created_at": "2025-05-21T22:15:03.160Z",
      "updated_at": "2025-05-21T22:15:03.160Z",
      "deleted_at": "2025-05-21T22:15:03.160Z"
    }
  ],
  "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 users

post

Store a newly created resource in storage.

Authorizations
Body
emailstring · emailOptional

The attributes that are mass assignable.

firstnamestringOptional
lastnamestringOptional
usernamestringOptional
passwordstringOptional
addressstringOptional
citystringOptional
statestringOptional
postalstringOptional
countrystringOptional
phonestringOptional
faxstringOptional
cellstringOptional
titlestringOptional
timezonestringOptional
datetime_formatstringOptional
languagestringOptional
is_administratorbooleanOptional
expires_atstringOptional
loggedin_atstringOptional
remember_tokenstringOptional
statusstring · enumOptionalPossible values:
fullnamestringOptional
avatarstringOptional
mediaall of[]Optional
and
birthdatestring · dateOptional
delegation_user_idstring · idOptional
manager_idstring · idOptional
force_change_passwordbooleanOptional
Responses
201
success
application/json
Responseall of
422
Unprocessable Entity
application/json
post
POST /api/1.0/users HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 899

{
  "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-05-21T22:15:03.160Z",
      "updated_at": "2025-05-21T22:15:03.160Z"
    }
  ],
  "birthdate": "2025-05-21",
  "delegation_user_id": "text",
  "manager_id": "text",
  "meta": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "force_change_password": true
}
{
  "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-05-21T22:15:03.160Z",
      "updated_at": "2025-05-21T22:15:03.160Z"
    }
  ],
  "birthdate": "2025-05-21",
  "delegation_user_id": "text",
  "manager_id": "text",
  "meta": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "force_change_password": true,
  "id": 1,
  "created_at": "2025-05-21T22:15:03.160Z",
  "updated_at": "2025-05-21T22:15:03.160Z",
  "deleted_at": "2025-05-21T22:15:03.160Z"
}

Update a user

put

Update a user

Authorizations
Path parameters
user_idintegerRequired

ID of user to return

Body
emailstring · emailOptional

The attributes that are mass assignable.

firstnamestringOptional
lastnamestringOptional
usernamestringOptional
passwordstringOptional
addressstringOptional
citystringOptional
statestringOptional
postalstringOptional
countrystringOptional
phonestringOptional
faxstringOptional
cellstringOptional
titlestringOptional
timezonestringOptional
datetime_formatstringOptional
languagestringOptional
is_administratorbooleanOptional
expires_atstringOptional
loggedin_atstringOptional
remember_tokenstringOptional
statusstring · enumOptionalPossible values:
fullnamestringOptional
avatarstringOptional
mediaall of[]Optional
and
birthdatestring · dateOptional
delegation_user_idstring · idOptional
manager_idstring · idOptional
force_change_passwordbooleanOptional
Responses
204
success
404
Not Found
application/json
422
Unprocessable Entity
application/json
put
PUT /api/1.0/users/{user_id} HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 899

{
  "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-05-21T22:15:03.160Z",
      "updated_at": "2025-05-21T22:15:03.160Z"
    }
  ],
  "birthdate": "2025-05-21",
  "delegation_user_id": "text",
  "manager_id": "text",
  "meta": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "force_change_password": true
}

No content

Set the groups a users belongs to

put

Update a user's groups

Authorizations
Path parameters
user_idintegerRequired

ID of user

Body
groupsinteger[]OptionalExample: 1
Responses
204
success
put
PUT /api/1.0/users/{user_id}/groups HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 14

{
  "groups": [
    1
  ]
}
204

success

No content

Restore a soft deleted user

put

Reverses the soft delete of a user

Authorizations
Body
usernamestringOptional

Username to restore

Responses
200
success
put
PUT /api/1.0/users/restore HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 19

{
  "username": "text"
}
200

success

No content

Create new token for a specific user

post

Create a new personal access token for the user.

Authorizations
Path parameters
user_idintegerRequired

User id

Body
namestringOptional
Responses
201
New token instance
application/json
post
POST /api/1.0/users/{user_id}/tokens HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 15

{
  "name": "text"
}
201

New token instance

{
  "id": "text",
  "user_id": 1,
  "client_id": 1,
  "name": "text",
  "scopes": {},
  "revoked": true,
  "client": {
    "id": 1,
    "user_id": 1,
    "name": "text",
    "provider": "text",
    "redirect": "text",
    "personal_access_client": true,
    "password_client": true,
    "revoked": true,
    "created_at": "2025-05-21T22:15:03.160Z",
    "updated_at": "2025-05-21T22:15:03.160Z"
  },
  "created_at": "2025-05-21T22:15:03.160Z",
  "updated_at": "2025-05-21T22:15:03.160Z",
  "expires_at": "2025-05-21T22:15:03.160Z"
}