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 ) => {
})
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 ) => {
})
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 ) => {
})
Response example
200 OK