processmaker.com Knowledge Center ProcessMaker University

Groups

API Reference for ProcessMaker Group API

PreviousUsers NextRequests

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:03:46.520Z",
  "updated_at": "2025-02-20T19:03:46.520Z"
}

success

Returns all groups that the user has access to

Display a listing of the resource.

get

/groups

Authorizations

Query parameters

statusstring · enum

ACTIVE or INACTIVE

Options: ACTIVE, INACTIVE

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/groups'

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": [
    {
      "name": "text",
      "description": "text",
      "manager_id": 1,
      "status": "ACTIVE",
      "created_at": "2025-02-20T19:03:46.520Z",
      "updated_at": "2025-02-20T19:03:46.520Z",
      "id": "text"
    }
  ]
}

list of groups

Save a new group

Store a newly created resource in storage.

post

/groups

Authorizations

Body

namestring

Represents a group definition.

descriptionstring

manager_idinteger · id

statusstring · enum

Options: ACTIVE, INACTIVE

Responses

application/json

cURL

JavaScript

Python

HTTP

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

201

422

{
  "name": "text",
  "description": "text",
  "manager_id": 1,
  "status": "ACTIVE",
  "created_at": "2025-02-20T19:03:46.520Z",
  "updated_at": "2025-02-20T19:03:46.520Z",
  "id": "text"
}

success

Get single group by ID

Display the specified resource.

get

/groups/{group_id}

Authorizations

Path parameters

group_idintegerrequired

ID of group to return

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url '/api/1.0/groups/{group_id}'

200

404

{
  "name": "text",
  "description": "text",
  "manager_id": 1,
  "status": "ACTIVE",
  "created_at": "2025-02-20T19:03:46.520Z",
  "updated_at": "2025-02-20T19:03:46.520Z",
  "id": "text"
}

Successfully found the group

Update a group

Update a user

put

/groups/{group_id}

Authorizations

Path parameters

group_idintegerrequired

ID of group to return

Body

namestring

Represents a group definition.

descriptionstring

manager_idinteger · id

statusstring · enum

Options: ACTIVE, INACTIVE

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request PUT \
  --url '/api/1.0/groups/{group_id}' \
  --header 'Content-Type: application/json' \
  --data '{"status":"ACTIVE"}'

204

404

No body

success

Delete a group

Delete a user

delete

/groups/{group_id}

Authorizations

Path parameters

group_idintegerrequired

ID of group to return

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request DELETE \
  --url '/api/1.0/groups/{group_id}'

204

404

No body

success

Returns all users of a group

Display the list of users in a group

get

/groups/{group_id}/users

Authorizations

Path parameters

group_idintegerrequired

ID of group

Query parameters

filterstring

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

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/groups/{group_id}/users'

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": [
    {
      "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:03:46.520Z",
          "updated_at": "2025-02-20T19:03:46.520Z"
        }
      ],
      "id": 1,
      "created_at": "2025-02-20T19:03:46.520Z",
      "updated_at": "2025-02-20T19:03:46.520Z",
      "deleted_at": "2025-02-20T19:03:46.520Z"
    }
  ]
}

list of members of a group

Returns all users of a group

Display the list of groups in a group

get

/groups/{group_id}/groups

Authorizations

Path parameters

group_idintegerrequired

ID of group

Query parameters

filterstring

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

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/groups/{group_id}/groups'

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": [
    {
      "name": "text",
      "description": "text",
      "manager_id": 1,
      "status": "ACTIVE",
      "created_at": "2025-02-20T19:03:46.520Z",
      "updated_at": "2025-02-20T19:03:46.520Z",
      "id": "text"
    }
  ]
}

list of members of a group

Returns all groups for a given member

Display a listing of the resource.

get

/group_members

Authorizations

Query parameters

member_idinteger

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/group_members'

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": [
    {
      "group_id": "text",
      "member_id": "text",
      "member_type": "text",
      "description": "text",
      "id": "text",
      "created_at": "2025-02-20T19:03:46.520Z",
      "updated_at": "2025-02-20T19:03:46.520Z"
    }
  ]
}

list of group_members

Save a new group member

Store a newly created resource in storage.

post

/group_members

Authorizations

Body

group_idstring · id

Represents a group Members definition.

member_idstring · id

member_typestring

descriptionstring

Responses

application/json

cURL

JavaScript

Python

HTTP

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

201

{
  "group_id": "text",
  "member_id": "text",
  "member_type": "text",
  "description": "text",
  "id": "text",
  "group": {},
  "member": {},
  "created_at": "2025-02-20T19:03:46.520Z",
  "updated_at": "2025-02-20T19:03:46.520Z"
}

success

Get single group member by ID

Display the specified resource.

get

/group_members/{group_member_id}

Authorizations

Path parameters

group_member_idstringrequired

ID of group members to return

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url '/api/1.0/group_members/{group_member_id}'

200

{
  "group_id": "text",
  "member_id": "text",
  "member_type": "text",
  "id": "text",
  "created_at": "2025-02-20T19:03:46.520Z",
  "updated_at": "2025-02-20T19:03:46.520Z"
}

Successfully found the group members

Delete a group member

Delete a group membership

delete

/group_members/{group_member_id}

Authorizations

Path parameters

group_member_idstringrequired

ID of group_members to return

Responses

cURL

JavaScript

Python

HTTP

curl -L \
  --request DELETE \
  --url '/api/1.0/group_members/{group_member_id}'

204

No body

success

Returns all groups available for a given member

Display a listing of groups available

get

/group_members_available

Authorizations

Path parameters

member_idstringrequired

ID of group member to return

member_typestringrequired

type of group member to return

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/group_members_available'

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": [
    {
      "id": "text",
      "description": "text",
      "name": "text",
      "created_at": "2025-02-20T19:03:46.520Z",
      "updated_at": "2025-02-20T19:03:46.520Z",
      "status": "ACTIVE"
    }
  ]
}

list of groups available to be assigned as member

Returns all users available for a given group

Display a listing of users available

get

/user_members_available

Authorizations

Path parameters

group_idstringrequired

ID of group to return

Query parameters

filterstring

Filter results by string. Searches Name. 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/user_members_available'

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": [
    {
      "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:03:46.520Z",
          "updated_at": "2025-02-20T19:03:46.520Z"
        }
      ],
      "id": 1,
      "created_at": "2025-02-20T19:03:46.520Z",
      "updated_at": "2025-02-20T19:03:46.520Z",
      "deleted_at": "2025-02-20T19:03:46.520Z"
    }
  ]
}

list of users available to be assigned as member