Skip to main content
POST
/
v1
/
products
/
metadata
/
async
Update Products' Metadata in Bulk
curl --request POST \
  --url https://{cluster}.voucherify.io/v1/products/metadata/async \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-App-Id: <api-key>' \
  --header 'X-App-Token: <api-key>' \
  --data '{
  "source_ids": [
    "123-567-3433",
    "test_volleyball"
  ],
  "metadata": {
    "label": true,
    "origin": "PL"
  }
}'
{
  "async_action_id": "aa_0a875d56c805df6601"
}

Authorizations

​
X-App-Id
string
header
required
​
X-App-Token
string
header
required
​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json

List the source_ids of the products you would like to update with the metadata key/value pairs.

Request schema for POST v1/products/metadata/async.

​
source_ids
string[]
required

Array of unique product source IDs.

​
metadata
object
required

The metadata object stores all custom attributes assigned to the product. A set of key/value pairs that you can attach to a product object. It can be useful for storing additional information about the product in a structured format.

Response

Returns the ID of the scheduled asynchronous action. The response informs you that the request has been accepted and the resources will be updated in the repository asynchronously. To check the status and result, copy the async_action_id from the response and use it as a query parameter in the GET Async Action endpoint.

Response body schema for POST v1/products/metadata/async. Response to requests that are processed asynchronously.

​
async_action_id
string
required

The ID of the scheduled asynchronous action.

Example:

"aa_0a875d56c805df6601"

⌘I