Variations Relationship

Choose the right endpoint

If you are using the Product Experience Manager (EP PXM) services, use the pcm/products endpoints instead of the v2/products endpoints. For details about the pcm/products endpoints, see the topics in the EP PXM Products section.

POST Create Variations Relationships

https://api.moltin.com/v2/products/:productId/relationships/variations

Parameters

Path parameters

Name	Required	Type	Description
productId	Required	string	The ID of the product you want to relate to the variation(s).

Headers

Name	Required	Type	Description
Authorization	Required	string	The Bearer token required to get access to the API.

Body

Name	Required	Type	Description
data[].type	Required	string	Represents the type of object (should be product-variation).
data[].id	Required	string	The ID of the product-variation.

Request examples

Curl

curl -X POST https://api.moltin.com/v2/products/:productId/relationships/variations \
     -H "Authorization: Bearer XXXX" \
     -H "Content-Type: application/json" \
     -d $'{
      "data": [
        {
          "type": "product-variation",
          "id": "3ab3deca-1f11-47b7-a409-24ea3234d72c"
        },
        {
          "type": "product-variation",
          "id": "7c740aa0-7fb7-4bd6-9347-78988cf60f9a"
        }
      ]
    }'

JavaScript SDK

const MoltinGateway = require('@moltin/sdk').gateway
const Moltin = MoltinGateway({
  client_id: 'X',
  client_secret: 'X'
})
const productId = 'XXXX'
const variationIds = [
    '5ab3deca-1f11-47b7-a409-24ea3234d72c',
    '2c740aa0-7fb7-4bd6-9347-78988cf60f9a'
]
Moltin.Products.CreateRelationships(productId, 'product-variation', variationIds).then((relationships) => {
  // Do something
})

Response example

200 OK

{
    "data": [
        {
            "type": "product-variation",
            "id": "3ab3deca-1f11-47b7-a409-24ea3234d72c"
        },
        {
          "type": "product-variation",
          "id": "7c740aa0-7fb7-4bd6-9347-78988cf60f9a"
        }
    ]
}

PUT Update Variation Relationships

https://api.moltin.com/v2/products/:productId/relationships/variations

Replace the relationships between a product and a variation. Unlike a POST to this endpoint, a PUT overrides any existing relationships. ****

Parameters

Path parameters

Name	Required	Type	Description
productId	Required	string	The ID of the product you want to relate to the variation(s).

Headers

Name	Required	Type	Description
Authorization	Required	string	The Bearer token required to get access to the API.

Body

Name	Required	Type	Description
data[].type	Required	string	Represents the type of object (should be product-variation).
data[].id	Required	string	The ID of the variation.

Request examples

Curl

url -X PUT https://api.moltin.com/v2/products/:productId/relationships/variations \
     -H "Authorization: Bearer XXXX" \
     -H "Content-Type: application/json" \
     -d $'{
      "data": [
        {
          "type": "product-variation",
          "id": "2c740aa0-7fb7-4bd6-9347-78988cf60f9a"
        }
      ]
    }'

JavaScript SDK

const MoltinGateway = require('@moltin/sdk').gateway
const Moltin = MoltinGateway({
  client_id: 'X',
  client_secret: 'X'
})
const productId = 'XXXX'
const variationIds = [
    '2c740aa0-7fb7-4bd6-9347-78988cf60f9a'
]
Moltin.Products.UpdateRelationships(productId, 'variation', variationIds).then((relationships) => {
  // Do something
})

Response example

200 OK

{
    "data": [
        {
            "type": "product-variation",
            "id": "2c740aa0-7fb7-4bd6-9347-78988cf60f9a"
        }
    ]
}

DELETE Delete Variation Relationships

https://api.moltin.com/v2/products/:productId/relationships/variations

Remove a relationship between a Product and a Variation(s). This deletes the relationships specified in the payload.

Parameters

Path parameters

Name	Required	Type	Description
productId	Required	string	The ID of the product you want to relate to the variations(s).

Headers

Name	Required	Type	Description
Authorization	Required	string	The Bearer token required to get access to the API.

Body

Name	Required	Type	Description
data[].type	Required	string	Represents the type of object (should be product-variation).
data[].id	Required	string	The ID of the variation.

Request examples

Curl

curl -X DELETE https://api.moltin.com/v2/products/:productId/relationships/variations \
     -H "Authorization: Bearer XXXX" \
     -H "Content-Type: application/json" \
     -d $'{
      "data": [
        {
          "type": "product-variation",
          "id": "2c740aa0-7fb7-4bd6-9347-78988cf60f9a"
        }
      ]
    }'

JavaScript SDK

const MoltinGateway = require('@moltin/sdk').gateway
const Moltin = MoltinGateway({
  client_id: 'X',
  client_secret: 'X'
})
const productId = 'XXXX'
const variationIds = [
    '2c740aa0-7fb7-4bd6-9347-78988cf60f9a'
]
Moltin.Products.DeleteRelationships(productId, 'variation', variationIds).then((relationships) => {
  // Do something
})

Response example

200 OK