Update variant attributes - Fabric
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Update variant attributes
cURL
curl --request PATCH \
--url https://marketplace-api.fabric.inc/v1/retailers/{retailer_id}/variants/{id}/ \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "T-Shirt, Blue, L",
"parent_identifier": "1000-BL",
"parent_name": "T-Shirt, Blue",
"identifier": "1000-BL-L",
"upc": "9119119111",
"color": "Blue",
"style": "print",
"size": "Medium",
"active_permit": {
"retailer_price": "12.99",
"retailer_cost": "8.99",
"pricing": {},
"attributes": {},
"start_at": "2021-09-10T15:24:56Z",
"end_at": "2024-09-10T15:24:56Z",
"revoked_at": "2022-09-10T15:24:56Z",
"acknowledged_at": "2022-09-10T15:24:56Z"
},
"proposal_variant": {
"attributes": [\
{\
"value": "<string>",\
"unit": {\
"system": "metric",\
"symbol": "USD"\
},\
"updated_at": "2023-11-07T05:31:56Z"\
}\
],
"memos": [\
{\
"text": "Immediate requirement",\
"visibility": "any",\
"notify_people": true,\
"created_by": {\
"first_name": "Sample",\
"last_name": "Demo",\
"title": "Demo",\
"status": "Active",\
"type": "standard"\
},\
"created_by_context": "retailer"\
}\
],
"approved_at": "2022-10-10T15:24:56Z",
"rejected_at": null,
"reject_reason": "Incomplete",
"reject": true,
"approve": false,
"delete": false
}
}
'
import requests
url = "https://marketplace-api.fabric.inc/v1/retailers/{retailer_id}/variants/{id}/"
payload = {
"name": "T-Shirt, Blue, L",
"parent_identifier": "1000-BL",
"parent_name": "T-Shirt, Blue",
"identifier": "1000-BL-L",
"upc": "9119119111",
"color": "Blue",
"style": "print",
"size": "Medium",
"active_permit": {
"retailer_price": "12.99",
"retailer_cost": "8.99",
"pricing": {},
"attributes": {},
"start_at": "2021-09-10T15:24:56Z",
"end_at": "2024-09-10T15:24:56Z",
"revoked_at": "2022-09-10T15:24:56Z",
"acknowledged_at": "2022-09-10T15:24:56Z"
},
"proposal_variant": {
"attributes": [\
{\
"value": "<string>",\
"unit": {\
"system": "metric",\
"symbol": "USD"\
},\
"updated_at": "2023-11-07T05:31:56Z"\
}\
],
"memos": [\
{\
"text": "Immediate requirement",\
"visibility": "any",\
"notify_people": True,\
"created_by": {\
"first_name": "Sample",\
"last_name": "Demo",\
"title": "Demo",\
"status": "Active",\
"type": "standard"\
},\
"created_by_context": "retailer"\
}\
],
"approved_at": "2022-10-10T15:24:56Z",
"rejected_at": None,
"reject_reason": "Incomplete",
"reject": True,
"approve": False,
"delete": False
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)
const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'T-Shirt, Blue, L',
parent_identifier: '1000-BL',
parent_name: 'T-Shirt, Blue',
identifier: '1000-BL-L',
upc: '9119119111',
color: 'Blue',
style: 'print',
size: 'Medium',
active_permit: {
retailer_price: '12.99',
retailer_cost: '8.99',
pricing: {},
attributes: {},
start_at: '2021-09-10T15:24:56Z',
end_at: '2024-09-10T15:24:56Z',
revoked_at: '2022-09-10T15:24:56Z',
acknowledged_at: '2022-09-10T15:24:56Z'
},
proposal_variant: {
attributes: [\
{\
value: '<string>',\
unit: {system: 'metric', symbol: 'USD'},\
updated_at: '2023-11-07T05:31:56Z'\
}\
],
memos: [\
{\
text: 'Immediate requirement',\
visibility: 'any',\
notify_people: true,\
created_by: {\
first_name: 'Sample',\
last_name: 'Demo',\
title: 'Demo',\
status: 'Active',\
type: 'standard'\
},\
created_by_context: 'retailer'\
}\
],
approved_at: '2022-10-10T15:24:56Z',
rejected_at: null,
reject_reason: 'Incomplete',
reject: true,
approve: false,
delete: false
}
})
};
fetch('https://marketplace-api.fabric.inc/v1/retailers/{retailer_id}/variants/{id}/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
<?php
$curl = curl_init();
curl_setopt_array($curl, [\
CURLOPT_URL => "https://marketplace-api.fabric.inc/v1/retailers/{retailer_id}/variants/{id}/",\
CURLOPT_RETURNTRANSFER => true,\
CURLOPT_ENCODING => "",\
CURLOPT_MAXREDIRS => 10,\
CURLOPT_TIMEOUT => 30,\
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,\
CURLOPT_CUSTOMREQUEST => "PATCH",\
CURLOPT_POSTFIELDS => json_encode([\
'name' => 'T-Shirt, Blue, L',\
'parent_identifier' => '1000-BL',\
'parent_name' => 'T-Shirt, Blue',\
'identifier' => '1000-BL-L',\
'upc' => '9119119111',\
'color' => 'Blue',\
'style' => 'print',\
'size' => 'Medium',\
'active_permit' => [\
'retailer_price' => '12.99',\
'retailer_cost' => '8.99',\
'pricing' => [\
\
],\
'attributes' => [\
\
],\
'start_at' => '2021-09-10T15:24:56Z',\
'end_at' => '2024-09-10T15:24:56Z',\
'revoked_at' => '2022-09-10T15:24:56Z',\
'acknowledged_at' => '2022-09-10T15:24:56Z'\
],\
'proposal_variant' => [\
'attributes' => [\
[\
'value' => '<string>',\
'unit' => [\
'system' => 'metric',\
'symbol' => 'USD'\
],\
'updated_at' => '2023-11-07T05:31:56Z'\
]\
],\
'memos' => [\
[\
'text' => 'Immediate requirement',\
'visibility' => 'any',\
'notify_people' => true,\
'created_by' => [\
'first_name' => 'Sample',\
'last_name' => 'Demo',\
'title' => 'Demo',\
'status' => 'Active',\
'type' => 'standard'\
],\
'created_by_context' => 'retailer'\
]\
],\
'approved_at' => '2022-10-10T15:24:56Z',\
'rejected_at' => null,\
'reject_reason' => 'Incomplete',\
'reject' => true,\
'approve' => false,\
'delete' => false\
]\
]),\
CURLOPT_HTTPHEADER => [\
"Authorization: Bearer <token>",\
"Content-Type: application/json"\
],\
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://marketplace-api.fabric.inc/v1/retailers/{retailer_id}/variants/{id}/"
payload := strings.NewReader("{\n \"name\": \"T-Shirt, Blue, L\",\n \"parent_identifier\": \"1000-BL\",\n \"parent_name\": \"T-Shirt, Blue\",\n \"identifier\": \"1000-BL-L\",\n \"upc\": \"9119119111\",\n \"color\": \"Blue\",\n \"style\": \"print\",\n \"size\": \"Medium\",\n \"active_permit\": {\n \"retailer_price\": \"12.99\",\n \"retailer_cost\": \"8.99\",\n \"pricing\": {},\n \"attributes\": {},\n \"start_at\": \"2021-09-10T15:24:56Z\",\n \"end_at\": \"2024-09-10T15:24:56Z\",\n \"revoked_at\": \"2022-09-10T15:24:56Z\",\n \"acknowledged_at\": \"2022-09-10T15:24:56Z\"\n },\n \"proposal_variant\": {\n \"attributes\": [\n {\n \"value\": \"<string>\",\n \"unit\": {\n \"system\": \"metric\",\n \"symbol\": \"USD\"\n },\n \"updated_at\": \"2023-11-07T05:31:56Z\"\n }\n ],\n \"memos\": [\n {\n \"text\": \"Immediate requirement\",\n \"visibility\": \"any\",\n \"notify_people\": true,\n \"created_by\": {\n \"first_name\": \"Sample\",\n \"last_name\": \"Demo\",\n \"title\": \"Demo\",\n \"status\": \"Active\",\n \"type\": \"standard\"\n },\n \"created_by_context\": \"retailer\"\n }\n ],\n \"approved_at\": \"2022-10-10T15:24:56Z\",\n \"rejected_at\": null,\n \"reject_reason\": \"Incomplete\",\n \"reject\": true,\n \"approve\": false,\n \"delete\": false\n }\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}
HttpResponse<String> response = Unirest.patch("https://marketplace-api.fabric.inc/v1/retailers/{retailer_id}/variants/{id}/")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"T-Shirt, Blue, L\",\n \"parent_identifier\": \"1000-BL\",\n \"parent_name\": \"T-Shirt, Blue\",\n \"identifier\": \"1000-BL-L\",\n \"upc\": \"9119119111\",\n \"color\": \"Blue\",\n \"style\": \"print\",\n \"size\": \"Medium\",\n \"active_permit\": {\n \"retailer_price\": \"12.99\",\n \"retailer_cost\": \"8.99\",\n \"pricing\": {},\n \"attributes\": {},\n \"start_at\": \"2021-09-10T15:24:56Z\",\n \"end_at\": \"2024-09-10T15:24:56Z\",\n \"revoked_at\": \"2022-09-10T15:24:56Z\",\n \"acknowledged_at\": \"2022-09-10T15:24:56Z\"\n },\n \"proposal_variant\": {\n \"attributes\": [\n {\n \"value\": \"<string>\",\n \"unit\": {\n \"system\": \"metric\",\n \"symbol\": \"USD\"\n },\n \"updated_at\": \"2023-11-07T05:31:56Z\"\n }\n ],\n \"memos\": [\n {\n \"text\": \"Immediate requirement\",\n \"visibility\": \"any\",\n \"notify_people\": true,\n \"created_by\": {\n \"first_name\": \"Sample\",\n \"last_name\": \"Demo\",\n \"title\": \"Demo\",\n \"status\": \"Active\",\n \"type\": \"standard\"\n },\n \"created_by_context\": \"retailer\"\n }\n ],\n \"approved_at\": \"2022-10-10T15:24:56Z\",\n \"rejected_at\": null,\n \"reject_reason\": \"Incomplete\",\n \"reject\": true,\n \"approve\": false,\n \"delete\": false\n }\n}")
.asString();
require 'uri'
require 'net/http'
url = URI("https://marketplace-api.fabric.inc/v1/retailers/{retailer_id}/variants/{id}/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"T-Shirt, Blue, L\",\n \"parent_identifier\": \"1000-BL\",\n \"parent_name\": \"T-Shirt, Blue\",\n \"identifier\": \"1000-BL-L\",\n \"upc\": \"9119119111\",\n \"color\": \"Blue\",\n \"style\": \"print\",\n \"size\": \"Medium\",\n \"active_permit\": {\n \"retailer_price\": \"12.99\",\n \"retailer_cost\": \"8.99\",\n \"pricing\": {},\n \"attributes\": {},\n \"start_at\": \"2021-09-10T15:24:56Z\",\n \"end_at\": \"2024-09-10T15:24:56Z\",\n \"revoked_at\": \"2022-09-10T15:24:56Z\",\n \"acknowledged_at\": \"2022-09-10T15:24:56Z\"\n },\n \"proposal_variant\": {\n \"attributes\": [\n {\n \"value\": \"<string>\",\n \"unit\": {\n \"system\": \"metric\",\n \"symbol\": \"USD\"\n },\n \"updated_at\": \"2023-11-07T05:31:56Z\"\n }\n ],\n \"memos\": [\n {\n \"text\": \"Immediate requirement\",\n \"visibility\": \"any\",\n \"notify_people\": true,\n \"created_by\": {\n \"first_name\": \"Sample\",\n \"last_name\": \"Demo\",\n \"title\": \"Demo\",\n \"status\": \"Active\",\n \"type\": \"standard\"\n },\n \"created_by_context\": \"retailer\"\n }\n ],\n \"approved_at\": \"2022-10-10T15:24:56Z\",\n \"rejected_at\": null,\n \"reject_reason\": \"Incomplete\",\n \"reject\": true,\n \"approve\": false,\n \"delete\": false\n }\n}"
response = http.request(request)
puts response.read_body
200
{
"id": 100024,
"name": "T-Shirt, Blue, L",
"brand_identifier": "1000-BL-L",
"parent_identifier": "1000-BL",
"parent_name": "T-Shirt, Blue",
"attributes": [\
{\
"code": "size",\
"name": "Size",\
"type": "money",\
"id": 44,\
"editable_by": "brand",\
"grouping": "general",\
"description": "demo product description",\
"units": "USD",\
"values": {\
"id": 123,\
"value": "<string>",\
"unit": {\
"id": 677,\
"name": "Sample unit",\
"standard_unit": "<string>",\
"type": "cost",\
"system": "metric",\
"symbol": "USD"\
},\
"retailer": {\
"name": "Demo Retailer",\
"code": "demo-retailer",\
"id": 500,\
"logo_url": "https://images.demo.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/logo-lg.png",\
"cover_url": "https://images.sampke.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/cover.jpg",\
"profile_tile_url": "https://images.demo.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/profile-tile.jpg",\
"joined_at": "2021-08-03T17:24:12Z",\
"is_rcn_retailer": false,\
"is_onboarded": false,\
"platform": "fabric",\
"requires_subscription": "disabled",\
"brand_permit_creation_allowed": false,\
"website": "https://demoabc.com",\
"status": "active"\
},\
"updated_at": "2023-11-07T05:31:56Z",\
"created_at": "2023-11-07T05:31:56Z"\
}\
}\
],
"brand": {
"code": "demo-brand",
"id": 500,
"name": "Marla Cielo",
"joined_at": "2022-09-10T15:24:56Z",
"logo_url": "https://images.revcascade.com/retailers/defaults/logo-lg.png",
"cover_url": "https://images.revcascade.com/retailers/defaults/cover.png",
"profile_tile_url": "https://images.revcascade.com/retailers/defaults/profile-tile.png",
"website": null,
"is_onboarded": false,
"is_on_rcn": false,
"requires_subscription": "enabled",
"subscription_expires_at": "2024-09-19T13:32:10Z",
"grace_period_ends_at": "2024-10-26T13:32:10Z",
"subscription_is_expired": false,
"subscription_is_on_grace_period": false,
"subscription_is_delinquent": false,
"inventory_policy": "managed",
"status": "active"
},
"identifier": "1000-BL-L",
"product_id": "4511",
"cartons": [\
{\
"id": 48,\
"number": 1,\
"length": "1",\
"length_unit": "1",\
"width": "1",\
"width_unit": "meter",\
"height": "1",\
"height_unit": "meter",\
"weight": "15",\
"weight_unit": "KG",\
"package_girth_inches": "1",\
"package_size_inches": "1"\
}\
],
"upc": "9119119111",
"color": "Blue",
"style": "print",
"size": "Medium",
"active_permit": {
"id": 10104,
"retailer": {
"name": "Demo Retailer",
"code": "demo-retailer",
"id": 500,
"logo_url": "https://images.demo.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/logo-lg.png",
"cover_url": "https://images.sampke.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/cover.jpg",
"profile_tile_url": "https://images.demo.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/profile-tile.jpg",
"joined_at": "2021-08-03T17:24:12Z",
"is_rcn_retailer": false,
"is_onboarded": false,
"platform": "fabric",
"requires_subscription": "disabled",
"brand_permit_creation_allowed": false,
"website": "https://demoabc.com",
"status": "active"
},
"retailer_price": "12.99",
"retailer_cost": "8.99",
"pricing": {},
"attributes": {},
"start_at": "2021-09-10T15:24:56Z",
"end_at": "2024-09-10T15:24:56Z",
"is_in_effect": true,
"revoked_at": "2022-09-10T15:24:56Z",
"is_acknowledged": true,
"acknowledged_at": "2022-09-10T15:24:56Z"
},
"permits": [\
{\
"id": 10104,\
"retailer": {\
"name": "Demo Retailer",\
"code": "demo-retailer",\
"id": 500,\
"logo_url": "https://images.demo.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/logo-lg.png",\
"cover_url": "https://images.sampke.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/cover.jpg",\
"profile_tile_url": "https://images.demo.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/profile-tile.jpg",\
"joined_at": "2021-08-03T17:24:12Z",\
"is_rcn_retailer": false,\
"is_onboarded": false,\
"platform": "fabric",\
"requires_subscription": "disabled",\
"brand_permit_creation_allowed": false,\
"website": "https://demoabc.com",\
"status": "active"\
},\
"retailer_price": "12.99",\
"retailer_cost": "8.99",\
"pricing": {},\
"attributes": {},\
"start_at": "2021-09-10T15:24:56Z",\
"end_at": "2024-09-10T15:24:56Z",\
"is_in_effect": true,\
"revoked_at": "2022-09-10T15:24:56Z",\
"is_acknowledged": true,\
"acknowledged_at": "2022-09-10T15:24:56Z"\
}\
],
"permits_count": 1,
"inventory_policy": "Managed",
"inventory": {
"inventory_updated_at": "2022-09-10T15:24:56Z",
"inventory_last_submitted_at": "2022-09-10T15:24:56Z",
"brand_inventory_updated_at": "2022-09-10T15:24:56Z",
"sellable_updated_at": "2022-11-10T15:24:56Z",
"estimated_availability_date": "2022-09-10T15:24:56Z",
"discontinued": true,
"discontinued_updated_at": null,
"inventory": 0,
"sellable": "No",
"replenishable": true,
"locations": [\
{\
"id": 1,\
"address": {\
"name1": "Demo Brand, Inc",\
"street1": "1332 Hermosa Ave",\
"city": "Hermosa Beach",\
"province": "CA",\
"postal_code": "90254",\
"country": "US",\
"id": 10,\
"type": "residential",\
"name2": null,\
"street2": null,\
"phone1": "3105551212",\
"phone2": "3105551213",\
"fax": null,\
"email": null,\
"federal_tax_id": null\
},\
"inventory": 0,\
"nickname": "LA Warehouse"\
}\
]
},
"media": [\
{\
"id": 249,\
"width": 100,\
"height": 100,\
"media": "default",\
"priority": 1,\
"url": "192.168.99.100/media/default/original",\
"updated_at": "2022-09-10T15:24:56Z",\
"created_at": "2022-08-10T15:24:56Z"\
}\
],
"ruleset_variants": [\
{\
"id": 1232,\
"status": "processing",\
"results": "<string>",\
"created_at": "2022-08-10T15:24:56Z",\
"updated_at": "2022-09-10T15:24:56Z"\
}\
],
"ruleset_variant_summary": "<string>",
"is_compatible": true,
"proposal_variant": {
"id": 3456,
"pricing": "12.00",
"attributes": [\
{\
"id": 123,\
"value": "<string>",\
"unit": {\
"id": 677,\
"name": "Sample unit",\
"standard_unit": "<string>",\
"type": "cost",\
"system": "metric",\
"symbol": "USD"\
},\
"retailer": {\
"name": "Demo Retailer",\
"code": "demo-retailer",\
"id": 500,\
"logo_url": "https://images.demo.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/logo-lg.png",\
"cover_url": "https://images.sampke.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/cover.jpg",\
"profile_tile_url": "https://images.demo.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/profile-tile.jpg",\
"joined_at": "2021-08-03T17:24:12Z",\
"is_rcn_retailer": false,\
"is_onboarded": false,\
"platform": "fabric",\
"requires_subscription": "disabled",\
"brand_permit_creation_allowed": false,\
"website": "https://demoabc.com",\
"status": "active"\
},\
"updated_at": "2023-11-07T05:31:56Z",\
"created_at": "2023-11-07T05:31:56Z"\
}\
],
"memos": [\
{\
"id": 1234,\
"text": "Immediate requirement",\
"visibility": "any",\
"acknowledged_at": "2022-01-10T15:24:56Z",\
"notify_people": true,\
"created_by": {\
"id": 542,\
"first_name": "Sample",\
"last_name": "Demo",\
"title": "Demo",\
"status": "Active",\
"type": "standard",\
"photo_url": "https://assets.demo.com/attachments/path_to_attachment/attachment.pdf",\
"profile_photo": "https://assets.demo.com/attachments/path_to_attachment/attachment.pdf",\
"is_me": true\
},\
"created_by_context": "retailer",\
"created_at": "2021-09-10T15:24:56Z",\
"updated_at": "2022-09-10T15:24:56Z"\
}\
],
"issues": [\
{\
"id": 123,\
"memos": [\
{\
"id": 1234,\
"text": "Immediate requirement",\
"visibility": "any",\
"acknowledged_at": "2022-01-10T15:24:56Z",\
"notify_people": true,\
"created_by": {\
"id": 542,\
"first_name": "Sample",\
"last_name": "Demo",\
"title": "Demo",\
"status": "Active",\
"type": "standard",\
"photo_url": "https://assets.demo.com/attachments/path_to_attachment/attachment.pdf",\
"profile_photo": "https://assets.demo.com/attachments/path_to_attachment/attachment.pdf",\
"is_me": true\
},\
"created_by_context": "retailer",\
"created_at": "2021-09-10T15:24:56Z",\
"updated_at": "2022-09-10T15:24:56Z"\
}\
],\
"created_at": "2023-11-07T05:31:56Z",\
"updated_at": "2023-11-07T05:31:56Z",\
"resolved_at": "2023-11-07T05:31:56Z",\
"is_resolved": "<string>",\
"issue_id": 123,\
"message": "<string>",\
"title": "<string>"\
}\
],
"variant_id": 249,
"approved_at": "2022-10-10T15:24:56Z",
"created_at": "2022-07-10T15:24:56Z",
"updated_at": "2022-09-10T15:24:56Z",
"rejected_at": null,
"reject_reason": "Incomplete",
"reject": true,
"approve": false,
"delete": false
},
"retailer_identifiers": [\
{\
"id": 5642,\
"retailer": {\
"name": "Demo Retailer",\
"code": "demo-retailer",\
"id": 500,\
"logo_url": "https://images.demo.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/logo-lg.png",\
"cover_url": "https://images.sampke.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/cover.jpg",\
"profile_tile_url": "https://images.demo.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/profile-tile.jpg",\
"joined_at": "2021-08-03T17:24:12Z",\
"is_rcn_retailer": false,\
"is_onboarded": false,\
"platform": "fabric",\
"requires_subscription": "disabled",\
"brand_permit_creation_allowed": false,\
"website": "https://demoabc.com",\
"status": "active"\
},\
"identifier": "SKU976",\
"name": "Retailer Sample"\
}\
],
"retailer_categories": {
"category": "CategoryANC",
"id": 453,
"retailer": {
"name": "Demo Retailer",
"code": "demo-retailer",
"id": 500,
"logo_url": "https://images.demo.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/logo-lg.png",
"cover_url": "https://images.sampke.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/cover.jpg",
"profile_tile_url": "https://images.demo.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/profile-tile.jpg",
"joined_at": "2021-08-03T17:24:12Z",
"is_rcn_retailer": false,
"is_onboarded": false,
"platform": "fabric",
"requires_subscription": "disabled",
"brand_permit_creation_allowed": false,
"website": "https://demoabc.com",
"status": "active"
}
}
}
PATCH
/
v1
/
retailers
/
{retailer_id}
/
variants
/
{id}
/
Try it
Update variant attributes
cURL
import requests
url = "https://marketplace-api.fabric.inc/v1/retailers/{retailer_id}/variants/{id}/"
response = requests.patch(url, json=payload, headers=headers)
print(response.text)
<?php
$curl = curl_init();
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://marketplace-api.fabric.inc/v1/retailers/{retailer_id}/variants/{id}/"
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}
require 'uri'
require 'net/http'
url = URI("https://marketplace-api.fabric.inc/v1/retailers/{retailer_id}/variants/{id}/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
response = http.request(request)
puts response.read_body
200
Authorizations
Authorization
string
header
required
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
retailer_id
integer
required
The unique retailer ID. In the Dropship UI this is called the Merchant ID. To find your Merchant ID, click your merchant name in the top nav.
Example:
1001
id
integer
required
The unique variant identifier. This ID is automatically generated when a variant is created.
Body
application/json
name
string | null
Variant name
Maximum string length: 200
Example:
"T-Shirt, Blue, L"
parent_identifier
string | null
Parent identifier of variant
Maximum string length: 100
Example:
"1000-BL"
parent_name
string | null
Parent name of variant
Maximum string length: 200
Example:
"T-Shirt, Blue"
brand
object
Showchild attributes
identifier
string | null
Stock Keeping Unit (SKU), unique identifier of a product
Maximum string length: 128
Example:
"1000-BL-L"
upc
string
Universal product code (UPC) is a 12-digit combination of numbers assigned to each product in your dropshipping store.
Maximum string length: 64
Example:
"9119119111"
color
string | null
Variant color
Maximum string length: 128
Example:
"Blue"
style
string | null
Variant style
Maximum string length: 128
Example:
"print"
size
string | null
Variant size
Maximum string length: 128
Example:
"Medium"
active_permit
object
Showchild attributes
inventory
object
Showchild attributes
proposal_variant
object
Showchild attributes
retailer_categories
object
Showchild attributes
Response
200 - application/json
OK
id
integer
read-only
Variant ID
Example:
100024
name
string | null
Variant name
Maximum string length: 200
Example:
"T-Shirt, Blue, L"
brand_identifier
string
read-only
Brand identifier
Minimum string length: 1
Example:
"1000-BL-L"
parent_identifier
string | null
Parent identifier of variant
Maximum string length: 100
Example:
"1000-BL"
parent_name
string | null
Parent name of variant
Maximum string length: 200
Example:
"T-Shirt, Blue"
attributes
object[]
read-only
Showchild attributes
brand
object
Showchild attributes
identifier
string | null
Stock Keeping Unit (SKU), unique identifier of a product
Maximum string length: 128
Example:
"1000-BL-L"
product_id
string
read-only
Product ID
Example:
"4511"
cartons
object[]
read-only
Showchild attributes
upc
string
Universal product code (UPC) is a 12-digit combination of numbers assigned to each product in your dropshipping store.
Maximum string length: 64
Example:
"9119119111"
color
string | null
Variant color
Maximum string length: 128
Example:
"Blue"
style
string | null
Variant style
Maximum string length: 128
Example:
"print"
size
string | null
Variant size
Maximum string length: 128
Example:
"Medium"
active_permit
object
Showchild attributes
permits
object[]
read-only
Showchild attributes
permits_count
integer
read-only
Count of permits
Example:
1
inventory_policy
string
read-only
Inventory policy
Example:
"Managed"
inventory
object
Showchild attributes
media
object[]
read-only
Showchild attributes
ruleset_variants
object[]
read-only
Showchild attributes
ruleset_variant_summary
string
read-only
Summary of ruleset variant
is_compatible
string
read-only
true: variant is compatible | false: variant is not compatible
Example:
true
proposal_variant
object
Showchild attributes
retailer_identifiers
object[]
read-only
Showchild attributes
retailer_categories
object
Showchild attributes
Was this page helpful?
YesNo
Get a variant by ID Get a permit
Ctrl+I
Assistant
Responses are generated using AI and may contain mistakes.