processmaker.com Knowledge Center ProcessMaker University

Data Connectors

PreviousAdministrative APIs NextCollections

Last updated 3 months ago

Was this helpful?

Get single Data Connector category by ID

get

Display the specified data Source category.

Authorizations

Path parameters

data_source_category_idstringrequired

ID of Data Connector category to return

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url '/api/1.0/data_source_categories/{data_source_category_id}'

200

{
  "name": "text",
  "status": "ACTIVE",
  "id": "text",
  "created_at": "2025-03-28T02:07:31.729Z",
  "updated_at": "2025-03-28T02:07:31.729Z"
}

Successfully found the Data Connector

Delete a Data Connector category

delete

Remove the specified resource from storage.

Authorizations

Path parameters

data_source_category_idstringrequired

ID of Data Connector category to return

Responses

cURL

JavaScript

Python

HTTP

curl -L \
  --request DELETE \
  --url '/api/1.0/data_source_categories/{data_source_category_id}'

204

No body

success

Returns all Data Connectors that the user has access to

get

Get the list of records of a Data Connector

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

200

{
  "data": [
    {
      "id": "text",
      "name": "text",
      "description": "text",
      "endpoints": "text",
      "mappings": "text",
      "authtype": "text",
      "credentials": "text",
      "status": "text",
      "data_source_category_id": "text",
      "created_at": "2025-03-28T02:07:31.729Z",
      "updated_at": "2025-03-28T02:07:31.729Z"
    }
  ],
  "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 Data Connectors

Get single Data Connector by ID

get

Get a single Data Connector.

Authorizations

Path parameters

data_source_idstringrequired

ID of Data Connector to return

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url '/api/1.0/data_sources/data_source_id'

200

{
  "id": "text",
  "name": "text",
  "description": "text",
  "endpoints": "text",
  "mappings": "text",
  "authtype": "text",
  "credentials": "text",
  "status": "text",
  "data_source_category_id": "text",
  "created_at": "2025-03-28T02:07:31.729Z",
  "updated_at": "2025-03-28T02:07:31.729Z"
}

Successfully found the Data Connector

Delete a Data Connector

delete

Delete a Data Connector.

Authorizations

Path parameters

data_source_idstringrequired

ID of Data Connector to return

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request DELETE \
  --url '/api/1.0/data_sources/data_source_id'

204

{
  "id": "text",
  "name": "text",
  "description": "text",
  "endpoints": "text",
  "mappings": "text",
  "authtype": "text",
  "credentials": "text",
  "status": "text",
  "data_source_category_id": "text",
  "created_at": "2025-03-28T02:07:31.729Z",
  "updated_at": "2025-03-28T02:07:31.729Z"
}

success

Get Data from Data Source

post

Authorizations

Path parameters

data_source_idstringrequired

ID of DataSource to be run

endpointstringrequired

Endpoint of the data source

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url '/api/1.0/requests/data_sources/{data_source_id}/resources/{endpoint}/data'

200

{
  "status": 1,
  "response": {}
}

success

Returns all Data Connectors categories that the user has access to

get

Display a listing of the Data Connector Categories.

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

Responses

application/json

cURL

JavaScript

Python

HTTP

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

200

{
  "data": [
    {
      "name": "text",
      "status": "ACTIVE",
      "id": "text",
      "created_at": "2025-03-28T02:07:31.729Z",
      "updated_at": "2025-03-28T02:07:31.729Z"
    }
  ],
  "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 Data Connectors categories

Save a new Data Connector Category

post

Store a newly created Data Connector Category in storage

Authorizations

Body

namestringoptional

Represents a business data Source category definition.

statusstring · enumoptional

Options: ACTIVE, INACTIVE

Responses

application/json

cURL

JavaScript

Python

HTTP

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

201

{
  "name": "text",
  "status": "ACTIVE",
  "id": "text",
  "created_at": "2025-03-28T02:07:31.729Z",
  "updated_at": "2025-03-28T02:07:31.729Z"
}

success

Update a Data Connector Category

put

Updates the current element

Authorizations

Path parameters

data_source_category_idstringrequired

ID of Data Connector category to return

Body

namestringoptional

Represents a business data Source category definition.

statusstring · enumoptional

Options: ACTIVE, INACTIVE

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request PUT \
  --url '/api/1.0/data_source_categories/{data_source_category_id}' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "text",
    "status": "ACTIVE"
  }'

200

{
  "name": "text",
  "status": "ACTIVE",
  "id": "text",
  "created_at": "2025-03-28T02:07:31.729Z",
  "updated_at": "2025-03-28T02:07:31.729Z"
}

success

Save a new Data Connector

post

Create a new Data Connector.

Authorizations

Body

idstring · idoptional

Class DataSource

namestringoptional

descriptionstringoptional

endpointsstringoptional

mappingsstringoptional

authtypestringoptional

credentialsstringoptional

statusstringoptional

data_source_category_idstringoptional

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url '/api/1.0/data_sources' \
  --header 'Content-Type: application/json' \
  --data '{
    "id": "text",
    "name": "text",
    "description": "text",
    "endpoints": "text",
    "mappings": "text",
    "authtype": "text",
    "credentials": "text",
    "status": "text",
    "data_source_category_id": "text"
  }'

201

{
  "id": "text",
  "name": "text",
  "description": "text",
  "endpoints": "text",
  "mappings": "text",
  "authtype": "text",
  "credentials": "text",
  "status": "text",
  "data_source_category_id": "text",
  "created_at": "2025-03-28T02:07:31.729Z",
  "updated_at": "2025-03-28T02:07:31.729Z"
}

success

Update a Data Connector

put

Update a Data Connector.

Authorizations

Path parameters

data_source_idstringrequired

ID of Data Connector to return

Body

idstring · idoptional

Class DataSource

namestringoptional

descriptionstringoptional

endpointsstringoptional

mappingsstringoptional

authtypestringoptional

credentialsstringoptional

statusstringoptional

data_source_category_idstringoptional

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request PUT \
  --url '/api/1.0/data_sources/data_source_id' \
  --header 'Content-Type: application/json' \
  --data '{
    "id": "text",
    "name": "text",
    "description": "text",
    "endpoints": "text",
    "mappings": "text",
    "authtype": "text",
    "credentials": "text",
    "status": "text",
    "data_source_category_id": "text"
  }'

204

{
  "id": "text",
  "name": "text",
  "description": "text",
  "endpoints": "text",
  "mappings": "text",
  "authtype": "text",
  "credentials": "text",
  "status": "text",
  "data_source_category_id": "text",
  "created_at": "2025-03-28T02:07:31.729Z",
  "updated_at": "2025-03-28T02:07:31.729Z"
}

success

Send a Data Connector request

post

Send a Data Connector request.

Authorizations

Path parameters

data_source_idstringrequired

ID of Data Connector to return

Body

idstring · idoptional

Class DataSource

namestringoptional

descriptionstringoptional

endpointsstringoptional

mappingsstringoptional

authtypestringoptional

credentialsstringoptional

statusstringoptional

data_source_category_idstringoptional

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url '/api/1.0/data_sources/data_source_id/test' \
  --header 'Content-Type: application/json' \
  --data '{
    "id": "text",
    "name": "text",
    "description": "text",
    "endpoints": "text",
    "mappings": "text",
    "authtype": "text",
    "credentials": "text",
    "status": "text",
    "data_source_category_id": "text"
  }'

204

{
  "id": "text",
  "name": "text",
  "description": "text",
  "endpoints": "text",
  "mappings": "text",
  "authtype": "text",
  "credentials": "text",
  "status": "text",
  "data_source_category_id": "text",
  "created_at": "2025-03-28T02:07:31.729Z",
  "updated_at": "2025-03-28T02:07:31.729Z"
}

success

execute Data Source

post

Execute a data Source endpoint

Authorizations

Path parameters

request_idstringrequired

ID of the request in whose context the datasource will be executed

data_source_idstringrequired

ID of DataSource to be run

Body

configobjectoptional

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url '/api/1.0/requests/{request_id}/data_sources/{data_source_id}' \
  --header 'Content-Type: application/json' \
  --data '{
    "config": {
      "endpoint": "text",
      "dataMapping": [
        {
          "key": "text",
          "value": "text"
        }
      ],
      "outboundConfig": [
        {
          "key": "text",
          "value": "text"
        }
      ]
    }
  }'

200

{
  "status": 1,
  "response": {}
}

success

execute Data Source

post

Authorizations

Path parameters

data_source_idstringrequired

ID of DataSource to be run

Body

configobjectoptional

dataobjectoptional

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url '/api/1.0/requests/data_sources/{data_source_id}' \
  --header 'Content-Type: application/json' \
  --data '{
    "config": {
      "endpoint": "text",
      "dataMapping": [
        {
          "key": "text",
          "value": "text"
        }
      ],
      "outboundConfig": [
        {
          "key": "text",
          "value": "text"
        }
      ]
    },
    "data": {}
  }'

200

{
  "status": 1,
  "response": {}
}

success

Get single Data Connector category by ID

Delete a Data Connector category

Returns all Data Connectors that the user has access to

Get single Data Connector by ID

Delete a Data Connector

Get Data from Data Source

Returns all Data Connectors categories that the user has access to

Save a new Data Connector Category

Update a Data Connector Category

Save a new Data Connector

Update a Data Connector

Send a Data Connector request

execute Data Source

Show child attributes

execute Data Source

Show child attributes

Show child attributes