processmaker.com Knowledge Center ProcessMaker University

Collections

PreviousData Connectors NextDecision Engine

Last updated 3 months ago

Was this helpful?

Get single collections by ID

get

Get a single Collection.

Authorizations

Path parameters

collection_idstringrequired

ID of collection to return

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url '/api/1.0/collections/{collection_id}'

200

{
  "name": "text",
  "description": "text",
  "custom_title": "text",
  "create_screen_id": "text",
  "read_screen_id": "text",
  "update_screen_id": "text",
  "signal_create": true,
  "signal_update": true,
  "signal_delete": true,
  "id": 1,
  "created_at": "2025-03-28T01:45:01.643Z",
  "updated_at": "2025-03-28T01:45:01.643Z",
  "created_by_id": "text",
  "updated_by_id": "text",
  "columns": [
    {}
  ]
}

Successfully found the collections

Delete a collection

delete

Delete a Collection.

Authorizations

Path parameters

collection_idstringrequired

ID of collection to return

Responses

cURL

JavaScript

Python

HTTP

curl -L \
  --request DELETE \
  --url '/api/1.0/collections/{collection_id}'

204

No body

success

Trigger export collections job

post

Export the specified collection.

Authorizations

Path parameters

collection_idstringrequired

ID of the collection to export

Responses

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url '/api/1.0/collections/{collection_id}/export'

202

No body

success

Deletes all records in a collection

delete

Truncate a Collection.

Authorizations

Path parameters

collection_idstringrequired

ID of collection to truncate

Responses

cURL

JavaScript

Python

HTTP

curl -L \
  --request DELETE \
  --url '/api/1.0/collections/{collection_id}/truncate'

204

No body

success

Returns all records

get

Get the list of records of a collection.

Authorizations

Path parameters

collection_idstringrequired

ID of collection to get records for

Query parameters

pmqlstringoptional

per_pageinteger · default: "10"optional

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 · enum · default: "asc"optional

Options: asc, desc

includestring · default: ""optional

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

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url '/api/1.0/collections/{collection_id}/records'

200

{
  "data": [
    {
      "data": {},
      "id": 1,
      "collection_id": "text"
    }
  ],
  "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
  }
}

list of records of a collection

Get single record of a collection

get

Get a single record of a Collection.

Authorizations

Path parameters

collection_idstringrequired

ID of the collection

record_idstringrequired

ID of the record to return

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url '/api/1.0/collections/{collection_id}/records/{record_id}'

200

{
  "data": {},
  "id": 1,
  "collection_id": "text"
}

Successfully found the record

Delete a collection record

delete

Delete a record of a Collection.

Authorizations

Path parameters

collection_idstringrequired

ID of collection

record_idstringrequired

ID of record in collection

Responses

cURL

JavaScript

Python

HTTP

curl -L \
  --request DELETE \
  --url '/api/1.0/collections/{collection_id}/records/{record_id}'

204

No body

success

Returns all collections that the user has access to

get

Get a list of Collections.

Authorizations

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 · enum · default: "asc"optional

Options: asc, desc

per_pageinteger · default: "10"optional

includestring · default: ""optional

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

Responses

application/json

cURL

JavaScript

Python

HTTP

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

200

{
  "data": [
    {
      "name": "text",
      "description": "text",
      "custom_title": "text",
      "create_screen_id": "text",
      "read_screen_id": "text",
      "update_screen_id": "text",
      "signal_create": true,
      "signal_update": true,
      "signal_delete": true,
      "id": 1,
      "created_at": "2025-03-28T01:45:01.643Z",
      "updated_at": "2025-03-28T01:45:01.643Z",
      "created_by_id": "text",
      "updated_by_id": "text",
      "columns": [
        {}
      ]
    }
  ],
  "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
  }
}

list of collections

Save a new collections

post

Create a new Collection.

Authorizations

Body

namestringoptional

descriptionstringoptional

custom_titlestringoptional

create_screen_idstring · idoptional

read_screen_idstring · idoptional

update_screen_idstring · idoptional

signal_createbooleanoptional

signal_updatebooleanoptional

signal_deletebooleanoptional

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url '/api/1.0/collections' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "text",
    "description": "text",
    "custom_title": "text",
    "create_screen_id": "text",
    "read_screen_id": "text",
    "update_screen_id": "text",
    "signal_create": true,
    "signal_update": true,
    "signal_delete": true
  }'

201

{
  "name": "text",
  "description": "text",
  "custom_title": "text",
  "create_screen_id": "text",
  "read_screen_id": "text",
  "update_screen_id": "text",
  "signal_create": true,
  "signal_update": true,
  "signal_delete": true,
  "id": 1,
  "created_at": "2025-03-28T01:45:01.643Z",
  "updated_at": "2025-03-28T01:45:01.643Z",
  "created_by_id": "text",
  "updated_by_id": "text",
  "columns": [
    {}
  ]
}

success

Update a collection

put

Update a Collection.

Authorizations

Path parameters

collection_idstringrequired

ID of collection to update

Body

namestringoptional

descriptionstringoptional

custom_titlestringoptional

create_screen_idstring · idoptional

read_screen_idstring · idoptional

update_screen_idstring · idoptional

signal_createbooleanoptional

signal_updatebooleanoptional

signal_deletebooleanoptional

Responses

cURL

JavaScript

Python

HTTP

curl -L \
  --request PUT \
  --url '/api/1.0/collections/{collection_id}' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "text",
    "description": "text",
    "custom_title": "text",
    "create_screen_id": "text",
    "read_screen_id": "text",
    "update_screen_id": "text",
    "signal_create": true,
    "signal_update": true,
    "signal_delete": true
  }'

204

No body

success

Import a new collection

post

Import the specified collection.

Authorizations

Body

filefile · filerequired

file to upload

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url '/api/1.0/collections/import' \
  --header 'Content-Type: multipart/form-data' \
  --form 'file=null'

200

201

No body

success

Save a new record in a collection

post

Create a new record in a Collection.

Authorizations

Path parameters

collection_idstringrequired

ID of the collection

Body

dataobjectoptional

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url '/api/1.0/collections/{collection_id}/records' \
  --header 'Content-Type: application/json' \
  --data '{
    "data": {}
  }'

201

{
  "data": {},
  "id": 1,
  "collection_id": "text"
}

success

Update a record

put

Update a record in a Collection.

Authorizations

Path parameters

collection_idstringrequired

ID of collection

record_idstringrequired

ID of the record

Body

dataobjectoptional

Responses

cURL

JavaScript

Python

HTTP

curl -L \
  --request PUT \
  --url '/api/1.0/collections/{collection_id}/records/{record_id}' \
  --header 'Content-Type: application/json' \
  --data '{
    "data": {}
  }'

204

No body

success

Partial update of a record

patch

Implements a partial update of a record in a Collection.

Authorizations

Path parameters

collection_idstringrequired

ID of collection

record_idstringrequired

ID of the record

Body

namestringoptional

descriptionstringoptional

custom_titlestringoptional

create_screen_idstring · idoptional

read_screen_idstring · idoptional

update_screen_idstring · idoptional

signal_createbooleanoptional

signal_updatebooleanoptional

signal_deletebooleanoptional

Responses

cURL

JavaScript

Python

HTTP

curl -L \
  --request PATCH \
  --url '/api/1.0/collections/{collection_id}/records/{record_id}' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "text",
    "description": "text",
    "custom_title": "text",
    "create_screen_id": "text",
    "read_screen_id": "text",
    "update_screen_id": "text",
    "signal_create": true,
    "signal_update": true,
    "signal_delete": true
  }'

200

No body

success

Get single collections by ID

Delete a collection

Trigger export collections job

Deletes all records in a collection

Returns all records

Get single record of a collection

Delete a collection record

Returns all collections that the user has access to

Save a new collections

Update a collection

Import a new collection

Save a new record in a collection

Show child attributes

Update a record

Show child attributes

Partial update of a record