Batch metafields
Get All Cart Metafields
GET https://api.bigcommerce.com/stores/{store_hash}/v3/carts/metafieldsRequest
Authentication
- X-Auth-Token in header
Parameters
- store_hash in path - string
- page in query - integer
Specifies the page number in a limited (paginated) list of products.
- limit in query - integer
Controls the number of items per page in a limited (paginated) list of products.
- key in query - stringFilter based on a metafieldʼs key.
- key:in in query - arrayFilter based on comma-separated metafieldʼs keys. Could be used with vanilla
key
query parameter.Type: array[string] - namespace in query - stringFilter based on a metafieldʼs namespaces.
- namespace:in in query - arrayFilter based on comma-separated metafieldʼs namespaces. Could be used with vanilla
namespace
query parameterType: array[string] - direction in query - string
Sort direction. Acceptable values are:
asc
,desc
.Allowed: asc | desc
- include_fields in query - arrayFields to include, in a comma-separated list. The ID and the specified fields will be returned.Type: array[string]
Allowed: resource_id | key | value | namespace | permission_set | resource_type | description | owner_client_id | date_created | date_modified
- date_modified:min in query - string
'Query parameter that lets you filter by the minimum date modified created, for example,
2024-05-14T09:34:00
or2024-05-14
. Returns metafields modified after this date.' - date_modified:max in query - string
'Query parameter that lets you filter by the maximum date modified created, for example,
2024-05-14T09:34:00
or2024-05-14
. Returns metafields modified before this date.' - date_created:min in query - string
'Query parameter that lets you filter by the minimum date created, for example,
2024-05-14T09:34:00
or2024-05-14
. Returns metafields created after this date.' - date_created:max in query - string
'Query parameter that lets you filter by the maximum date created, for example,
2024-05-14T09:34:00
or2024-05-14
. Returns metafields created before this date.'
example
Response
List of Metafield
objects.
Body
Response payload for the BigCommerce API.
dataarray[object]
example
Create multiple Metafields
POST https://api.bigcommerce.com/stores/{store_hash}/v3/carts/metafieldsRequest
Authentication
- X-Auth-Token in header
Parameters
- store_hash in path - string
Body
namespacestring
required>= 1 characters<= 64 charactersNamespace for the metafield, for organizational purposes.
Example: Sales Departmentkeystring
required>= 1 characters<= 64 charactersThe name of the field, for example:
location_id
,color
.Example: Staff Namevaluestring
required>= 1 characters<= 65535 charactersThe value of the field, for example:
1
,blue
.Example: Ronaldodescriptionstring
>= 0 characters<= 255 charactersDescription for the metafields.
Example: Name of Staff Memberresource_idstring
requiredThe ID for the cart with which the metafield is associated.
Example: 42
example
Response
List of created Metafield
objects.
Body
Response payload for the BigCommerce API.
dataarray[object]
errorsarray[]
Empty for 200 responses.Example: []
example
Update multiple Metafields
PUT https://api.bigcommerce.com/stores/{store_hash}/v3/carts/metafieldsRequest
Authentication
- X-Auth-Token in header
Parameters
- store_hash in path - string
Body
namespacestring
required>= 1 characters<= 64 charactersNamespace for the metafield, for organizational purposes.
Example: Sales Departmentkeystring
required>= 1 characters<= 64 charactersThe name of the field, for example:
location_id
,color
.Example: Staff Namevaluestring
required>= 1 characters<= 65535 charactersThe value of the field, for example:
1
,blue
.Example: Ronaldodescriptionstring
>= 0 characters<= 255 charactersDescription for the metafields.
Example: Name of Staff Memberidstring
requiredThe ID of metafield to update.
Example: 42
example
Response
List of updated Metafield
objects.
Body
Response payload for the BigCommerce API.
dataarray[object]
errorsarray[]
Empty for 200 responses.Example: []
example
Delete multiple Metafields
DELETE https://api.bigcommerce.com/stores/{store_hash}/v3/carts/metafieldsRequest
Authentication
- X-Auth-Token in header
Parameters
- store_hash in path - string
id
s.Body
example
Response
Response object for metafields deletion with success.
Body
Response payload for the BigCommerce API.
dataarray[integer]
Type: array[integer]Example: [123,124,125]errorsarray[]
Empty for 200 responses.Example: []