Users

API Reference for ProcessMaker Users API

Returns all users

Display a listing of the resource.

GET/api/1.0/users

Query parameters

Response

200

list of users

Body

application/json

dataarray of users (all of)

metametadata (object)

Request

JavaScriptCurlPython

const response = await fetch('/api/1.0/users', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "data": [
    {
      "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": false,
      "expires_at": "text",
      "loggedin_at": "text",
      "remember_token": "text",
      "status": "ACTIVE",
      "fullname": "text",
      "avatar": "text",
      "media": [
        {
          "id": 0,
          "model_id": 0,
          "model_type": "text",
          "collection_name": "text",
          "name": "text",
          "file_name": "text",
          "mime_type": "text",
          "disk": "text",
          "size": 0,
          "order_column": 0,
          "created_at": "2024-12-04T18:51:47.072Z",
          "updated_at": "2024-12-04T18:51:47.072Z"
        }
      ],
      "birthdate": "2024-12-04",
      "delegation_user_id": "text",
      "manager_id": "text",
      "force_change_password": false,
      "id": 0,
      "created_at": "2024-12-04T18:51:47.072Z",
      "updated_at": "2024-12-04T18:51:47.072Z",
      "deleted_at": "2024-12-04T18:51:47.072Z"
    }
  ],
  "meta": {
    "filter": "text",
    "sort_by": "text",
    "sort_order": "asc",
    "count": 0,
    "total_pages": 0,
    "current_page": 0,
    "form": 0,
    "last_page": 0,
    "path": "text",
    "per_page": 0,
    "to": 0,
    "total": 0
  }
}

Save a new users

Store a newly created resource in storage.

POST/api/1.0/users

Body

application/json

emailstring (email)

The attributes that are mass assignable.

firstnamestring

lastnamestring

usernamestring

passwordstring

addressstring

citystring

statestring

postalstring

countrystring

phonestring

faxstring

cellstring

titlestring

timezonestring

datetime_formatstring

languagestring

is_administratorboolean

expires_atstring

loggedin_atstring

remember_tokenstring

statusenum

ACTIVEINACTIVESCHEDULEDOUT_OF_OFFICE

fullnamestring

avatarstring

mediaarray of media (object)

birthdatestring (date)

delegation_user_idstring (id)

manager_idstring (id)

metaobject

force_change_passwordboolean

Response

201422

success

Body

application/json

emailstring (email)

The attributes that are mass assignable.

firstnamestring

lastnamestring

usernamestring

passwordstring

addressstring

citystring

statestring

postalstring

countrystring

phonestring

faxstring

cellstring

titlestring

timezonestring

datetime_formatstring

languagestring

is_administratorboolean

expires_atstring

loggedin_atstring

remember_tokenstring

statusenum

ACTIVEINACTIVESCHEDULEDOUT_OF_OFFICE

fullnamestring

avatarstring

mediaarray of media (object)

birthdatestring (date)

delegation_user_idstring (id)

manager_idstring (id)

metaobject

force_change_passwordboolean

idinteger

created_atstring (date-time)

updated_atstring (date-time)

deleted_atstring (date-time)

Request

JavaScriptCurlPython

const response = await fetch('/api/1.0/users', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

201422

{
  "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": false,
  "expires_at": "text",
  "loggedin_at": "text",
  "remember_token": "text",
  "status": "ACTIVE",
  "fullname": "text",
  "avatar": "text",
  "media": [
    {
      "id": 0,
      "model_id": 0,
      "model_type": "text",
      "collection_name": "text",
      "name": "text",
      "file_name": "text",
      "mime_type": "text",
      "disk": "text",
      "size": 0,
      "order_column": 0,
      "created_at": "2024-12-04T18:51:47.072Z",
      "updated_at": "2024-12-04T18:51:47.072Z"
    }
  ],
  "birthdate": "2024-12-04",
  "delegation_user_id": "text",
  "manager_id": "text",
  "force_change_password": false,
  "id": 0,
  "created_at": "2024-12-04T18:51:47.072Z",
  "updated_at": "2024-12-04T18:51:47.072Z",
  "deleted_at": "2024-12-04T18:51:47.072Z"
}

Get single user by ID

Display the specified resource.

GET/api/1.0/users/{user_id}

Path parameters

user_id*integer

ID of user to return

Response

200404

Successfully found the process

Body

application/json

emailstring (email)

The attributes that are mass assignable.

firstnamestring

lastnamestring

usernamestring

passwordstring

addressstring

citystring

statestring

postalstring

countrystring

phonestring

faxstring

cellstring

titlestring

timezonestring

datetime_formatstring

languagestring

is_administratorboolean

expires_atstring

loggedin_atstring

remember_tokenstring

statusenum

ACTIVEINACTIVESCHEDULEDOUT_OF_OFFICE

fullnamestring

avatarstring

mediaarray of media (object)

birthdatestring (date)

delegation_user_idstring (id)

manager_idstring (id)

metaobject

force_change_passwordboolean

idinteger

created_atstring (date-time)

updated_atstring (date-time)

deleted_atstring (date-time)

Request

JavaScriptCurlPython

const response = await fetch('/api/1.0/users/{user_id}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200404

{
  "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": false,
  "expires_at": "text",
  "loggedin_at": "text",
  "remember_token": "text",
  "status": "ACTIVE",
  "fullname": "text",
  "avatar": "text",
  "media": [
    {
      "id": 0,
      "model_id": 0,
      "model_type": "text",
      "collection_name": "text",
      "name": "text",
      "file_name": "text",
      "mime_type": "text",
      "disk": "text",
      "size": 0,
      "order_column": 0,
      "created_at": "2024-12-04T18:51:47.072Z",
      "updated_at": "2024-12-04T18:51:47.072Z"
    }
  ],
  "birthdate": "2024-12-04",
  "delegation_user_id": "text",
  "manager_id": "text",
  "force_change_password": false,
  "id": 0,
  "created_at": "2024-12-04T18:51:47.072Z",
  "updated_at": "2024-12-04T18:51:47.072Z",
  "deleted_at": "2024-12-04T18:51:47.072Z"
}

Update a user

Update a user

PUT/api/1.0/users/{user_id}

Path parameters

user_id*integer

ID of user to return

Body

application/json

emailstring (email)

The attributes that are mass assignable.

firstnamestring

lastnamestring

usernamestring

passwordstring

addressstring

citystring

statestring

postalstring

countrystring

phonestring

faxstring

cellstring

titlestring

timezonestring

datetime_formatstring

languagestring

is_administratorboolean

expires_atstring

loggedin_atstring

remember_tokenstring

statusenum

ACTIVEINACTIVESCHEDULEDOUT_OF_OFFICE

fullnamestring

avatarstring

mediaarray of media (object)

birthdatestring (date)

delegation_user_idstring (id)

manager_idstring (id)

metaobject

force_change_passwordboolean

Response

204404422

success

Request

JavaScriptCurlPython

const response = await fetch('/api/1.0/users/{user_id}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

404422

{
  "error": "text"
}

Delete a user

Delete a user

DELETE/api/1.0/users/{user_id}

Path parameters

user_id*integer

ID of user to delete

Response

204404

success

Request

JavaScriptCurlPython

const response = await fetch('/api/1.0/users/{user_id}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Response

404

{
  "error": "text"
}

Set the groups a users belongs to

Update a user's groups

PUT/api/1.0/users/{user_id}/groups

Path parameters

user_id*integer

ID of user

Body

application/json

groupsarray of integer

Response

204

success

Request

JavaScriptCurlPython

const response = await fetch('/api/1.0/users/{user_id}/groups', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Restore a soft deleted user

Reverses the soft delete of a user

PUT/api/1.0/users/restore

Body

application/json

usernamestring

Username to restore

Response

200

success

Request

JavaScriptCurlPython

const response = await fetch('/api/1.0/users/restore', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Display listing of access tokens for the specified user.

Display listing of access tokens for the specified user.

GET/api/1.0/users/{user_id}/tokens

Path parameters

user_id*integer

User id

Query parameters

Response

200

List of tokens.

Body

application/json

dataarray of UserToken (object)

metametadata (object)

Request

JavaScriptCurlPython

const response = await fetch('/api/1.0/users/{user_id}/tokens', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "data": [
    {
      "id": "text",
      "user_id": 0,
      "client_id": 0,
      "name": "text",
      "revoked": false,
      "client": {
        "id": 0,
        "user_id": 0,
        "name": "text",
        "provider": "text",
        "redirect": "text",
        "personal_access_client": false,
        "password_client": false,
        "revoked": false,
        "created_at": "2024-12-04T18:51:47.072Z",
        "updated_at": "2024-12-04T18:51:47.072Z"
      },
      "created_at": "2024-12-04T18:51:47.072Z",
      "updated_at": "2024-12-04T18:51:47.072Z",
      "expires_at": "2024-12-04T18:51:47.072Z"
    }
  ],
  "meta": {
    "filter": "text",
    "sort_by": "text",
    "sort_order": "asc",
    "count": 0,
    "total_pages": 0,
    "current_page": 0,
    "form": 0,
    "last_page": 0,
    "path": "text",
    "per_page": 0,
    "to": 0,
    "total": 0
  }
}

Create new token for a specific user

Create a new personal access token for the user.

POST/api/1.0/users/{user_id}/tokens

Path parameters

user_id*integer

User id

Body

application/json

namestring

Response

201

New token instance

Body

application/json

idstring

user_idinteger

client_idinteger

namestring

scopesobject

revokedboolean

clientTokenClient (object)

created_atstring (date-time)

updated_atstring (date-time)

expires_atstring (date-time)

Request

JavaScriptCurlPython

const response = await fetch('/api/1.0/users/{user_id}/tokens', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

201

{
  "id": "text",
  "user_id": 0,
  "client_id": 0,
  "name": "text",
  "revoked": false,
  "client": {
    "id": 0,
    "user_id": 0,
    "name": "text",
    "provider": "text",
    "redirect": "text",
    "personal_access_client": false,
    "password_client": false,
    "revoked": false,
    "created_at": "2024-12-04T18:51:47.072Z",
    "updated_at": "2024-12-04T18:51:47.072Z"
  },
  "created_at": "2024-12-04T18:51:47.072Z",
  "updated_at": "2024-12-04T18:51:47.072Z",
  "expires_at": "2024-12-04T18:51:47.072Z"
}

Get single token by ID

Show a personal access token for the user

GET/api/1.0/users/{user_id}/tokens/{token_id}

Path parameters

user_id*integer

ID of user

token_id*string

ID of token to return

Response

200

Successfully found the token

Body

application/json

idstring

user_idinteger

client_idinteger

namestring

scopesobject

revokedboolean

clientTokenClient (object)

created_atstring (date-time)

updated_atstring (date-time)

expires_atstring (date-time)

Request

JavaScriptCurlPython

const response = await fetch('/api/1.0/users/{user_id}/tokens/{token_id}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "id": "text",
  "user_id": 0,
  "client_id": 0,
  "name": "text",
  "revoked": false,
  "client": {
    "id": 0,
    "user_id": 0,
    "name": "text",
    "provider": "text",
    "redirect": "text",
    "personal_access_client": false,
    "password_client": false,
    "revoked": false,
    "created_at": "2024-12-04T18:51:47.072Z",
    "updated_at": "2024-12-04T18:51:47.072Z"
  },
  "created_at": "2024-12-04T18:51:47.072Z",
  "updated_at": "2024-12-04T18:51:47.072Z",
  "expires_at": "2024-12-04T18:51:47.072Z"
}

Delete a token

Delete the given token for a user

DELETE/api/1.0/users/{user_id}/tokens/{token_id}

Path parameters

user_id*integer

User ID

token_id*string

Token ID

Response

204

success

Request

JavaScriptCurlPython

const response = await fetch('/api/1.0/users/{user_id}/tokens/{token_id}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();