Appearance
POST
/product-information/media/medias/disconnectRequired scope:
media:updateDisconnects media from products, colors and variants. Max batch size is 100.
The match is exact. A media with only productNumber is disconnected from the product level only. With attribute1Code or attribute1Number (and attribute2 and attribute3 the same way) it is disconnected from that attribute combination only, for example the color. stockKeepingUnitId or priceLookUpNumber means that variant. Without mediaType every media type of the media at that level is disconnected, with mediaType only that one. The media is found by 'filename', or its filename is built from 'mediaURL' (with 'prefix' and the attribute codes or numbers) the same way as when it was connected. With stockKeepingUnitId or priceLookUpNumber the attribute codes and numbers are only used to build the filename, the same way POST /medias names the file.
Every media that can be disconnected is, a media that fails does not stop the others. The response has the result of each media, in the order they were sent. A media that is not connected where it was asked to be removed fails with the error code 'media-not-connected'. The media itself is never deleted, it stays in the media library.
Request body
JSON
{
"attribute1Code": "Red",
"attribute1Number": "10",
"attribute2Code": "Large",
"attribute2Number": "20",
"attribute3Code": "75cm",
"attribute3Number": "30",
"filename": "image-Red.jpg",
"mediaType": "FRONT_IMAGE",
"mediaURL": "https://www.example.com/path-to-image/image.jpg",
"prefix": "viskan-",
"priceLookUpNumber": "ABC-123",
"productNumber": "123PRODUCT",
"stockKeepingUnitId": 12345
}
Response
The media were handled, see the result of each media.
JSON
{
"results": [
{
"errorCode": "",
"filename": "image-Red.jpg",
"index": 0,
"message": "",
"removed": true,
"removedConnections": 1
}
]
}