Get support

Data stores / Data

The following endpoints allow you to create and manage records in data stores.

List data store records

get
/data-stores/{dataStoreId}/data

Retrieves a collection of all records from a data store with a given ID. Each returned record consists of the key (custom or automatically generated) and data.

Required scopes
This endpoint requires the following scopes:
Authorizations
AuthorizationstringRequired

Authorize the API call with your API token in the Authorization header with the value: Token your-api-token.

If you don't have an API token yet, please refer to the "Authentication" section to learn how to create one.

Path parameters
dataStoreIdintegerRequired

The ID of the data store. Get the dataStoreId from the List data stores endpoint.

Example: 137
Query parameters
pg[limit]integerOptional

The maximum number of entities you want to get in the response.

pg[offset]integerOptional

The number of entities you want to skip before getting entities you want.

Responses
200

Successful response

application/json
get
/data-stores/{dataStoreId}/data
GET /api/v2/data-stores/{dataStoreId}/data HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Accept: */*
200

Successful response

{
  "records": [
    {
      "key": "8f7162828bc0",
      "data": {
        "price": 600
      }
    }
  ],
  "spec": [
    {
      "name": "price",
      "label": "Price",
      "type": "number",
      "default": null,
      "required": true
    }
  ],
  "strict": false,
  "count": 2,
  "pg": {
    "limit": 10,
    "offset": 0
  }
}

Create data store record

post
/data-stores/{dataStoreId}/data

Creates a new record in a data store with a given ID and returns all record details.

Required scopes
This endpoint requires the following scopes:
Authorizations
AuthorizationstringRequired

Authorize the API call with your API token in the Authorization header with the value: Token your-api-token.

If you don't have an API token yet, please refer to the "Authentication" section to learn how to create one.

Path parameters
dataStoreIdintegerRequired

The ID of the data store. Get the dataStoreId from the List data stores endpoint.

Example: 137
Body
keystringOptional

The unique key of the data store record. If no key is provided, it will be automatically generated.

dataobjectOptional

The data of the data store record. The structure strictly depends on the included data structure. If no data is provided, in response the values will be set to null.

Responses
200

Successful response

application/json
post
/data-stores/{dataStoreId}/data
POST /api/v2/data-stores/{dataStoreId}/data HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 43

{
  "key": "8f7162828bc0",
  "data": {
    "price": 600
  }
}
200

Successful response

{
  "key": "8f7162828bc0",
  "data": {
    "price": 600
  }
}

Delete data store records

delete
/data-stores/{dataStoreId}/data

Deletes records from the specified data store.

Specify the keys of the records you want to delete in the keys array in the request body.

Use the all parameter in the request body to delete all records from the data store. You have to add the confirmed parameter in the API call query to confirm deleting the data, otherwise you get an error.

When you are deleting all records, you can use the exceptKeys parameter to specify keys of the records which you want to keep.

The response contains keys of the deleted records.

Required scopes
This endpoint requires the following scopes:
Authorizations
AuthorizationstringRequired

Authorize the API call with your API token in the Authorization header with the value: Token your-api-token.

If you don't have an API token yet, please refer to the "Authentication" section to learn how to create one.

Path parameters
dataStoreIdintegerRequired

The ID of the data store. Get the dataStoreId from the List data stores endpoint.

Example: 137
Query parameters
confirmedbooleanOptional

Set to true to confirm deleting of the data store records. Otherwise, you get an error and Make won't delete the data store records.

Example: {"value":true}
Body
keysstring[]Optional

The keys of data store records you want to delete. Use the all and confirmed parameters if you want to delete all records in the data store.

allbooleanOptional

Set to true to delete all records in the data store. Use the confirmed parameter to confirm the deletion. You can also use the exceptKeys parameter to specify keys of the records that you want to keep in the data store.

exceptKeysstring[]Optional

Specify the keys of the data store records you want to keep when deleting all records from the data store.

Responses
200

Successful response

application/json
delete
/data-stores/{dataStoreId}/data
DELETE /api/v2/data-stores/{dataStoreId}/data HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 34

{
  "keys": [
    "1abd2defk",
    "568tyuj45"
  ]
}
200

Successful response

{
  "keys": [
    "1abd2defk",
    "568tyuj45"
  ]
}

Update entire data store record

put
/data-stores/{dataStoreId}/data/{dataStoreKeyRecord}

Updates a data store record with a given key by passing new data in the request body. It replaces the entire resource with the new values. In the response, this endpoint returns all details of the updated data.

Required scopes
This endpoint requires the following scopes:
Authorizations
AuthorizationstringRequired

Authorize the API call with your API token in the Authorization header with the value: Token your-api-token.

If you don't have an API token yet, please refer to the "Authentication" section to learn how to create one.

Path parameters
dataStoreIdintegerRequired

The ID of the data store. Get the dataStoreId from the List data stores endpoint.

Example: 137
dataStoreKeyRecordstringRequired

The key of the data store record. It can be retrieved from the List data store records endpoint.

Example: ecc4819b2260
Body
objectOptional

The data is different for each data store so there are no predefined body properties to use. Please see the request example for more details.

Responses
200

Successful response

application/json
put
/data-stores/{dataStoreId}/data/{dataStoreKeyRecord}
PUT /api/v2/data-stores/{dataStoreId}/data/{dataStoreKeyRecord} HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 13

{
  "price": 600
}
200

Successful response

{
  "key": "8f7162828bc0",
  "data": {
    "price": 600
  }
}

Update data store record details

patch
/data-stores/{dataStoreId}/data/{dataStoreKeyRecord}

Updates a data store record with a given key by passing new data in the request body. Any property that is not provided will be left unchanged. In the response, it returns all details of the updated data including properties that were not changed.

Required scopes
This endpoint requires the following scopes:
Authorizations
AuthorizationstringRequired

Authorize the API call with your API token in the Authorization header with the value: Token your-api-token.

If you don't have an API token yet, please refer to the "Authentication" section to learn how to create one.

Path parameters
dataStoreIdintegerRequired

The ID of the data store. Get the dataStoreId from the List data stores endpoint.

Example: 137
dataStoreKeyRecordstringRequired

The key of the data store record. It can be retrieved from the List data store records endpoint.

Example: ecc4819b2260
Body
objectOptional

The data is different for each data store so there are no predefined body properties to use. Please see the request example for more details.

Responses
200

Successful response

application/json
patch
/data-stores/{dataStoreId}/data/{dataStoreKeyRecord}
PATCH /api/v2/data-stores/{dataStoreId}/data/{dataStoreKeyRecord} HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 13

{
  "price": 600
}
200

Successful response

{
  "key": "8f7162828bc0",
  "data": {
    "price": 600
  }
}
PreviousData storesNextData structures

Last updated