From a73ad3735f62bed86362a3dafafbd99ea4b2af13 Mon Sep 17 00:00:00 2001 From: Florian HEGRON <> Date: Thu, 27 Jun 2024 11:55:01 +0200 Subject: [PATCH] fix typo --- content/swagger/akeneo-web-api.json | 2 +- content/swagger/resources/categories/routes/categories.yaml | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/content/swagger/akeneo-web-api.json b/content/swagger/akeneo-web-api.json index e70c0a674..0d66c3df3 100644 --- a/content/swagger/akeneo-web-api.json +++ b/content/swagger/akeneo-web-api.json @@ -1 +1 @@ -{"swagger":"2.0","info":{"title":"Akeneo PIM REST API","version":"1.0.0"},"host":"demo.akeneo.com","schemes":["http"],"produces":["application/json"],"paths":{"/api/rest/v1/products-uuid":{"get":{"summary":"Get list of products","operationId":"get_products_uuid","tags":["Product [uuid]"],"x-versions":["7.0","SaaS"],"description":"This endpoint allows you to get a list of products. Products are paginated and they can be filtered. In the Enterprise Edition, permissions based on your user groups are applied to the set of products you request.","parameters":[{"name":"search","in":"query","description":"Filter products, for more details see the Filters section","required":false,"type":"string"},{"name":"scope","in":"query","type":"string","description":"Filter product values to return scopable attributes for the given channel as well as the non localizable/non scopable attributes, for more details see the Filter product values via channel section","required":false},{"name":"locales","in":"query","type":"string","description":"Filter product values to return localizable attributes for the given locales as well as the non localizable/non scopable attributes, for more details see the Filter product values via locale section","required":false},{"name":"attributes","in":"query","type":"string","description":"Filter product values to only return those concerning the given attributes, for more details see the Filter on product values section","required":false},{"name":"pagination_type","in":"query","description":"Pagination method type, see Pagination section","required":false,"type":"string","default":"page","x-validation-rules":"One of the following values","enum":["page","search_after"]},{"name":"page","in":"query","description":"Number of the page to retrieve when using the `page` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"integer","default":1},{"name":"search_after","in":"query","description":"Cursor when using the `search_after` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"string","default":"cursor to the first page"},{"name":"limit","in":"query","description":"Number of results by page, see Pagination section","required":false,"type":"integer","minimum":1,"maximum":100,"default":10},{"name":"with_count","in":"query","description":"Return the count of items in the response. Be carefull with that, on a big catalog, it can decrease performance in a significative way","default":false,"type":"boolean","required":false},{"name":"with_attribute_options","in":"query","description":"Return labels of attribute options in the response. See the `linked_data` format section for more details. (Only available since the 5.0 version)","default":false,"type":"boolean","required":false,"x-from-version":"5.0"},{"name":"with_asset_share_links","in":"query","description":"Return asset collection share link urls in the response. See the `linked_data` format section for more details. (Only available in the SaaS version)","default":false,"type":"boolean","required":false,"x-from-version":"SaaS"},{"name":"with_quality_scores","in":"query","description":"Return product quality scores in the response. (Only available since the 5.0 version)","default":false,"type":"boolean","required":false,"x-from-version":"5.0"},{"name":"with_completenesses","in":"query","description":"Return product completenesses in the response. (Only available since the 6.0 version)","default":false,"type":"boolean","required":false,"x-from-version":"6.0"}],"responses":{"200":{"description":"Return products paginated","schema":{"title":"Products","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"previous":{"type":"object","properties":{"href":{"type":"string","description":"URI of the previous page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}},"current_page":{"type":"integer","description":"Current page number"}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","properties":{"uuid":{"type":"string","description":"Product uuid"},"enabled":{"type":"boolean","description":"Whether the product is enabled","default":true},"family":{"type":"string","description":"Family code from which the product inherits its attributes and attributes requirements.","x-validation-rules":"It is equal to an existing family code. In the case of variant product, the given family should be the same as the product model family.","default":"null only in the case of a non variant product"},"categories":{"type":"array","description":"Codes of the categories in which the product is classified","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"groups":{"type":"array","description":"Codes of the groups to which the product belong","x-validation-rules":"Each string of the array is equal to an existing group code","items":{"type":"string"},"default":[]},"parent":{"type":"string","description":"Code of the parent product model when the product is a variant (only available since the 2.0). This parent can be modified since the 2.3.","x-validation-rules":"It is equal to an existing product model code only if the product is variant otherwise it's equal to null","default":"null","x-from-version":"2.0"},"values":{"type":"object","description":"Product attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value. See the `data` format section for more details."},"linked_data":{"type":"object","x-read-only":true,"description":"Object containing additional data when a related query parameter is enabled. See the `linked_data` format section for more details. (only available since the 5.0)","x-from-version":"5.0","properties":{"attribute":{"type":"string"},"code":{"type":"string"},"labels":{"type":"object"}}},"attribute_type":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"The type of the value's attribute. See type section for more details."},"reference_data_name":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"Reference entity code when the attribute type is `akeneo_reference_entity` or `akeneo_reference_entity_collection` OR Asset family code when the attribute type is `pim_catalog_asset_collection`","x-warning":"Only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types"}}}}}},"associations":{"type":"object","description":"Several associations related to groups, product models and/or other products, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the uuid of an existing product. • Each string in the array of the property `product_models` is the code of an existing product model.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of product uuids with which the product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Several quantified associations related to products and/or product models, grouped by quantified association types (only available since the 5.0)","x-validation-rules":"• The `quantifiedAssociationTypeCode` is the code of an existing association type which provides quantity information. • Each object in the array of the property `products` contains the uuid of an existing product and the quantity of it.","x-from-version":"5.0","properties":{"quantifiedAssociationTypeCode":{"type":"object","properties":{"products":{"type":"array","description":"Array of objects containing product uuids and quantities with which the product is in relation","items":{"type":"object","properties":{"uuid":{"type":"string"},"quantity":{"type":"integer"}}}},"product_models":{"type":"array","description":"Array of objects containing product model codes and quantities with which the product is in relation","items":{"type":"object","properties":{"code":{"type":"string"},"quantity":{"type":"integer"}}}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"metadata":{"type":"object","description":"More information around the product (only available since the v2.0 in the Enterprise Edition)","x-immutable":true,"x-read-only":true,"x-from-version":"2.0","properties":{"workflow_status":{"description":"Status of the product regarding the user permissions","type":"string","enum":["read_only","draft_in_progress","proposal_waiting_for_approval","working_copy"]}}},"quality_scores":{"type":"object","description":"Product quality scores for each channel/locale combination (only available since the 5.0 and when the \"with_quality_scores\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"5.0"},"completenesses":{"type":"array","description":"Product completenesses for each channel/locale combination (only available since the 7.0 version, and when the \"with_completenesses\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"7.0","items":{"type":"object","properties":{"scope":{"type":"string"},"locale":{"type":"string"},"data":{"type":"integer"}}}}},"example":{"uuid":"25566245-55c3-42ce-86d9-8610ac459fa8","enabled":true,"family":"tshirt","categories":["summer_collection"],"groups":[],"parent":null,"values":{"sku":[{"data":"top","locale":null,"scope":null}],"name":[{"data":"Top","locale":"en_US","scope":null},{"data":"Débardeur","locale":"fr_FR","scope":null}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce"},{"data":"Top","locale":"en_US","scope":"tablet"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}}}],"size":[{"locale":null,"scope":null,"data":"m","linked_data":{"attribute":"size","code":"m","labels":{"en_US":"M","fr_FR":"M"}}}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"],"linked_data":{"winter_2016":{"attribute":"collection","code":"winter_2016","labels":{"en_US":"Winter 2016","fr_FR":"Hiver 2016"}}}}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["d055527c-0698-4967-8f16-8a5f23f4e5cf"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"uuid":"fc24e6c3-933c-4a93-8a81-e5c703d134d5","quantity":2},{"uuid":"a9b69002-a0b1-4ead-85c2-f8dbf59c6cfc","quantity":1}],"product_models":[{"identifier":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"completenesses":[{"scope":"ecommerce","locale":"en_US","data":10},{"scope":"ecommerce","locale":"fr_FR","data":20},{"scope":"tablet","locale":"en_US","data":30},{"scope":"tablet","locale":"fr_FR","data":40}]}}]}}}}}}]},"x-examples-per-version":[{"x-version":"SaaS","x-example":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/products-uuid?page=3&limit=3&with_quality_scores=true&with_completenesses=true&with_attribute_options=true"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/products-uuid?page=1&limit=3&with_quality_scores=true&with_completenesses=true&with_attribute_options=true"},"previous":{"href":"https://demo.akeneo.com/api/rest/v1/products-uuid?page=2&limit=3&with_quality_scores=true&with_completenesses=true&with_attribute_options=true"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/products-uuid?page=4&limit=3&with_quality_scores=true&with_completenesses=true&with_attribute_options=true"}},"current_page":3,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product-uuid/25566245-55c3-42ce-86d9-8610ac459fa8"}},"uuid":"25566245-55c3-42ce-86d9-8610ac459fa8","family":"tshirt","groups":[],"parent":null,"categories":["summer_collection"],"enabled":true,"values":{"sku":[{"data":"top","locale":null,"scope":null,"attribute_type":"pim_catalog_identifier"}],"name":[{"data":"Top","locale":"en_US","scope":null,"attribute_type":"pim_catalog_text"},{"data":"Débardeur","locale":"fr_FR","scope":null,"attribute_type":"pim_catalog_text"}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce","attribute_type":"pim_catalog_textarea"},{"data":"Top","locale":"en_US","scope":"tablet","attribute_type":"pim_catalog_textarea"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce","attribute_type":"pim_catalog_textarea"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet","attribute_type":"pim_catalog_textarea"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}],"attribute_type":"pim_catalog_price_collection"}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}},"attribute_type":"pim_catalog_simpleselect"}],"size":[{"locale":null,"scope":null,"data":"m","linked_data":{"attribute":"size","code":"m","labels":{"en_US":"M","fr_FR":"M"}},"attribute_type":"pim_catalog_simpleselect"}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"],"linked_data":{"winter_2016":{"attribute":"collection","code":"winter_2016","labels":{"en_US":"Winter 2016","fr_FR":"Hiver 2016"}}},"attribute_type":"pim_catalog_multiselect"}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["d055527c-0698-4967-8f16-8a5f23f4e5cf"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"uuid":"fc24e6c3-933c-4a93-8a81-e5c703d134d5","quantity":2},{"uuid":"a9b69002-a0b1-4ead-85c2-f8dbf59c6cfc","quantity":1}],"product_models":[{"identifier":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"completenesses":[{"scope":"ecommerce","locale":"en_US","data":20},{"scope":"ecommerce","locale":"fr_FR","data":30},{"scope":"tablet","locale":"en_US","data":55},{"scope":"tablet","locale":"fr_FR","data":70}]},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/fc24e6c3-933c-4a93-8a81-e5c703d134d5"}},"uuid":"fc24e6c3-933c-4a93-8a81-e5c703d134d5","family":"caps","groups":[],"parent":null,"categories":["summer_collection"],"enabled":true,"values":{"sku":[{"data":"cap","locale":null,"scope":null}],"name":[{"data":"Cap","locale":"en_US","scope":null},{"data":"Casquette","locale":"fr_FR","scope":null}],"description":[{"data":"Cap unisex","locale":"en_US","scope":"ecommerce"},{"data":"Cap unisex","locale":"en_US","scope":"tablet"},{"data":"Casquette unisexe","locale":"fr_FR","scope":"ecommerce"},{"data":"Casquette unisexe","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"20","currency":"EUR"},{"amount":"20","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}}}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["d055527c-0698-4967-8f16-8a5f23f4e5cf"],"product_models":[],"groups":[]}},"quantified_associations":{},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"completenesses":[{"scope":"ecommerce","locale":"en_US","data":20},{"scope":"ecommerce","locale":"fr_FR","data":30},{"scope":"tablet","locale":"en_US","data":55},{"scope":"tablet","locale":"fr_FR","data":70}]},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product-uuid/fa0b115e-46ec-4527-beab-7207452f1b47"}},"uuid":"fa0b115e-46ec-4527-beab-7207452f1b47","family":null,"groups":[],"parent":null,"categories":["winter_collection"],"enabled":true,"values":{"sku":[{"data":"sweat","locale":null,"scope":null}]},"created":"2016-06-23T11:24:44+02:00","updated":"2016-06-23T11:24:44+02:00","associations":{},"quantified_associations":{},"quality_scores":{},"completenesses":[]}]}}}]},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}},"post":{"summary":"Create a new product","operationId":"post_products_uuid","tags":["Product [uuid]"],"x-versions":["7.0","SaaS"],"description":"This endpoint allows you to create a new product. In the Enterprise Edition, permissions based on your user groups are applied to the product you try to create. If no uuid is provided, the PIM will generate one for you.","parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"uuid":{"type":"string","description":"Product uuid"},"enabled":{"type":"boolean","description":"Whether the product is enabled","default":true},"family":{"type":"string","description":"Family code from which the product inherits its attributes and attributes requirements.","x-validation-rules":"It is equal to an existing family code. In the case of variant product, the given family should be the same as the product model family.","default":"null only in the case of a non variant product"},"categories":{"type":"array","description":"Codes of the categories in which the product is classified","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"groups":{"type":"array","description":"Codes of the groups to which the product belong","x-validation-rules":"Each string of the array is equal to an existing group code","items":{"type":"string"},"default":[]},"parent":{"type":"string","description":"Code of the parent product model when the product is a variant (only available since the 2.0). This parent can be modified since the 2.3.","x-validation-rules":"It is equal to an existing product model code only if the product is variant otherwise it's equal to null","default":"null","x-from-version":"2.0"},"values":{"type":"object","description":"Product attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value. See the `data` format section for more details."},"linked_data":{"type":"object","x-read-only":true,"description":"Object containing additional data when a related query parameter is enabled. See the `linked_data` format section for more details. (only available since the 5.0)","x-from-version":"5.0","properties":{"attribute":{"type":"string"},"code":{"type":"string"},"labels":{"type":"object"}}},"attribute_type":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"The type of the value's attribute. See type section for more details."},"reference_data_name":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"Reference entity code when the attribute type is `akeneo_reference_entity` or `akeneo_reference_entity_collection` OR Asset family code when the attribute type is `pim_catalog_asset_collection`","x-warning":"Only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types"}}}}}},"associations":{"type":"object","description":"Several associations related to groups, product models and/or other products, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the uuid of an existing product. • Each string in the array of the property `product_models` is the code of an existing product model.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of product uuids with which the product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Several quantified associations related to products and/or product models, grouped by quantified association types (only available since the 5.0)","x-validation-rules":"• The `quantifiedAssociationTypeCode` is the code of an existing association type which provides quantity information. • Each object in the array of the property `products` contains the uuid of an existing product and the quantity of it.","x-from-version":"5.0","properties":{"quantifiedAssociationTypeCode":{"type":"object","properties":{"products":{"type":"array","description":"Array of objects containing product uuids and quantities with which the product is in relation","items":{"type":"object","properties":{"uuid":{"type":"string"},"quantity":{"type":"integer"}}}},"product_models":{"type":"array","description":"Array of objects containing product model codes and quantities with which the product is in relation","items":{"type":"object","properties":{"code":{"type":"string"},"quantity":{"type":"integer"}}}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"metadata":{"type":"object","description":"More information around the product (only available since the v2.0 in the Enterprise Edition)","x-immutable":true,"x-read-only":true,"x-from-version":"2.0","properties":{"workflow_status":{"description":"Status of the product regarding the user permissions","type":"string","enum":["read_only","draft_in_progress","proposal_waiting_for_approval","working_copy"]}}},"quality_scores":{"type":"object","description":"Product quality scores for each channel/locale combination (only available since the 5.0 and when the \"with_quality_scores\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"5.0"},"completenesses":{"type":"array","description":"Product completenesses for each channel/locale combination (only available since the 7.0 version, and when the \"with_completenesses\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"7.0","items":{"type":"object","properties":{"scope":{"type":"string"},"locale":{"type":"string"},"data":{"type":"integer"}}}}},"example":{"uuid":"25566245-55c3-42ce-86d9-8610ac459fa8","enabled":true,"family":"tshirt","categories":["summer_collection"],"groups":[],"parent":null,"values":{"sku":[{"data":"top","locale":null,"scope":null}],"name":[{"data":"Top","locale":"en_US","scope":null},{"data":"Débardeur","locale":"fr_FR","scope":null}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce"},{"data":"Top","locale":"en_US","scope":"tablet"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}}}],"size":[{"locale":null,"scope":null,"data":"m","linked_data":{"attribute":"size","code":"m","labels":{"en_US":"M","fr_FR":"M"}}}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"],"linked_data":{"winter_2016":{"attribute":"collection","code":"winter_2016","labels":{"en_US":"Winter 2016","fr_FR":"Hiver 2016"}}}}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["d055527c-0698-4967-8f16-8a5f23f4e5cf"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"uuid":"fc24e6c3-933c-4a93-8a81-e5c703d134d5","quantity":2},{"uuid":"a9b69002-a0b1-4ead-85c2-f8dbf59c6cfc","quantity":1}],"product_models":[{"identifier":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"completenesses":[{"scope":"ecommerce","locale":"en_US","data":10},{"scope":"ecommerce","locale":"fr_FR","data":20},{"scope":"tablet","locale":"en_US","data":30},{"scope":"tablet","locale":"fr_FR","data":40}]}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}},"patch":{"summary":"Update/create several products","operationId":"patch_products_uuid","tags":["Product [uuid]"],"x-versions":["7.0","SaaS"],"description":"This endpoint allows you to update and/or create several products at once. Learn more about Update behavior. Note that if no product exists for the given uuid, it creates it. In the Enterprise Edition, permissions based on your user groups are applied to the products you try to update. It may result in the creation of drafts if you only have edit rights through the product's categories.","x-body-by-line":"Contains several lines, each line is a product in JSON standard format","parameters":[{"name":"body","in":"body","schema":{"required":["uuid"],"x-examples":{"x-example-1":"{\"uuid\":\"fc24e6c3-933c-4a93-8a81-e5c703d134d5\",\"values\":{\"description\":[{\"scope\":\"ecommerce\",\"locale\":\"en_US\",\"data\":\"My amazing cap\"}]}}","x-example-2":"{\"uuid\":\"573dd613-0c7f-4143-83d5-63cc5e535966\",\"values\":{\"sku\":[{\"data\":\"updated_sku\",\"locale\":null,\"scope\":null}]}, \"group\":[\"promotion\"]}","x-example-3":"{\"uuid\":\"25566245-55c3-42ce-86d9-8610ac459fa8\",\"values\":{\"sku\":[{\"data\":\"new_product\",\"locale\":null,\"scope\":null}]},\"family\":\"clothes\"}"},"type":"object","properties":{"uuid":{"type":"string","description":"Product uuid"},"enabled":{"type":"boolean","description":"Whether the product is enabled","default":true},"family":{"type":"string","description":"Family code from which the product inherits its attributes and attributes requirements.","x-validation-rules":"It is equal to an existing family code. In the case of variant product, the given family should be the same as the product model family.","default":"null only in the case of a non variant product"},"categories":{"type":"array","description":"Codes of the categories in which the product is classified","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"groups":{"type":"array","description":"Codes of the groups to which the product belong","x-validation-rules":"Each string of the array is equal to an existing group code","items":{"type":"string"},"default":[]},"parent":{"type":"string","description":"Code of the parent product model when the product is a variant (only available since the 2.0). This parent can be modified since the 2.3.","x-validation-rules":"It is equal to an existing product model code only if the product is variant otherwise it's equal to null","default":"null","x-from-version":"2.0"},"values":{"type":"object","description":"Product attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value. See the `data` format section for more details."},"linked_data":{"type":"object","x-read-only":true,"description":"Object containing additional data when a related query parameter is enabled. See the `linked_data` format section for more details. (only available since the 5.0)","x-from-version":"5.0","properties":{"attribute":{"type":"string"},"code":{"type":"string"},"labels":{"type":"object"}}},"attribute_type":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"The type of the value's attribute. See type section for more details."},"reference_data_name":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"Reference entity code when the attribute type is `akeneo_reference_entity` or `akeneo_reference_entity_collection` OR Asset family code when the attribute type is `pim_catalog_asset_collection`","x-warning":"Only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types"}}}}}},"associations":{"type":"object","description":"Several associations related to groups, product models and/or other products, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the uuid of an existing product. • Each string in the array of the property `product_models` is the code of an existing product model.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of product uuids with which the product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Several quantified associations related to products and/or product models, grouped by quantified association types (only available since the 5.0)","x-validation-rules":"• The `quantifiedAssociationTypeCode` is the code of an existing association type which provides quantity information. • Each object in the array of the property `products` contains the uuid of an existing product and the quantity of it.","x-from-version":"5.0","properties":{"quantifiedAssociationTypeCode":{"type":"object","properties":{"products":{"type":"array","description":"Array of objects containing product uuids and quantities with which the product is in relation","items":{"type":"object","properties":{"uuid":{"type":"string"},"quantity":{"type":"integer"}}}},"product_models":{"type":"array","description":"Array of objects containing product model codes and quantities with which the product is in relation","items":{"type":"object","properties":{"code":{"type":"string"},"quantity":{"type":"integer"}}}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"metadata":{"type":"object","description":"More information around the product (only available since the v2.0 in the Enterprise Edition)","x-immutable":true,"x-read-only":true,"x-from-version":"2.0","properties":{"workflow_status":{"description":"Status of the product regarding the user permissions","type":"string","enum":["read_only","draft_in_progress","proposal_waiting_for_approval","working_copy"]}}},"quality_scores":{"type":"object","description":"Product quality scores for each channel/locale combination (only available since the 5.0 and when the \"with_quality_scores\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"5.0"},"completenesses":{"type":"array","description":"Product completenesses for each channel/locale combination (only available since the 7.0 version, and when the \"with_completenesses\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"7.0","items":{"type":"object","properties":{"scope":{"type":"string"},"locale":{"type":"string"},"data":{"type":"integer"}}}}},"example":{"uuid":"25566245-55c3-42ce-86d9-8610ac459fa8","enabled":true,"family":"tshirt","categories":["summer_collection"],"groups":[],"parent":null,"values":{"sku":[{"data":"top","locale":null,"scope":null}],"name":[{"data":"Top","locale":"en_US","scope":null},{"data":"Débardeur","locale":"fr_FR","scope":null}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce"},{"data":"Top","locale":"en_US","scope":"tablet"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}}}],"size":[{"locale":null,"scope":null,"data":"m","linked_data":{"attribute":"size","code":"m","labels":{"en_US":"M","fr_FR":"M"}}}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"],"linked_data":{"winter_2016":{"attribute":"collection","code":"winter_2016","labels":{"en_US":"Winter 2016","fr_FR":"Hiver 2016"}}}}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["d055527c-0698-4967-8f16-8a5f23f4e5cf"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"uuid":"fc24e6c3-933c-4a93-8a81-e5c703d134d5","quantity":2},{"uuid":"a9b69002-a0b1-4ead-85c2-f8dbf59c6cfc","quantity":1}],"product_models":[{"identifier":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"completenesses":[{"scope":"ecommerce","locale":"en_US","data":10},{"scope":"ecommerce","locale":"fr_FR","data":20},{"scope":"tablet","locale":"en_US","data":30},{"scope":"tablet","locale":"fr_FR","data":40}]}}}],"responses":{"200":{"description":"OK","x-details":"Returns a plain text response whose lines are JSON containing the status of each update or creation","x-no-entity":true,"schema":{"type":"object","properties":{"line":{"type":"integer","description":"Line number"},"uuid":{"type":"string","description":"Product uuid"},"status_code":{"type":"integer","description":"HTTP status code, see Client errors to understand the meaning of each code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"x-example-1":"{\"line\":1,\"uuid\":\"fc24e6c3-933c-4a93-8a81-e5c703d134d5\",\"status_code\":204}","x-example-2":"{\"line\":2,\"uuid\":\"573dd613-0c7f-4143-83d5-63cc5e535966\",\"status_code\":422,\"message\":\"Property \\\"group\\\" does not exist.\"}","x-example-3":"{\"line\":3,\"uuid\":\"25566245-55c3-42ce-86d9-8610ac459fa8\",\"status_code\":201}"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"413":{"description":"Request Entity Too Large","x-details":"There are too many resources to process (max 100) or the line of JSON is too long (max 1 000 000 characters)","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":413,"message":"Too many resources to process, 100 is the maximum allowed."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/vnd.akeneo.collection+json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/vnd.akeneo.collection+json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/products-uuid/{uuid}":{"get":{"summary":"Get a product","operationId":"get_products_uuid__uuid_","tags":["Product [uuid]"],"x-versions":["7.0","SaaS"],"description":"This endpoint allows you to get the information about a given product. In the Entreprise Edition, permissions based on your user groups are applied to the product you request.","parameters":[{"name":"uuid","in":"path","description":"Uuid of the resource","required":true,"type":"string"},{"name":"with_attribute_options","in":"query","description":"Return labels of attribute options in the response. See the `linked_data` format section for more details. (Only available since the 5.0 version)","default":false,"type":"boolean","required":false,"x-from-version":"5.0"},{"name":"with_asset_share_links","in":"query","description":"Return asset collection share link urls in the response. See the `linked_data` format section for more details. (Only available in the SaaS version)","default":false,"type":"boolean","required":false,"x-from-version":"SaaS"},{"name":"with_quality_scores","in":"query","description":"Return product quality scores in the response. (Only available since the 5.0 version)","default":false,"type":"boolean","required":false,"x-from-version":"5.0"},{"name":"with_completenesses","in":"query","description":"Return product completenesses in the response. (Only available since the 6.0 version)","default":false,"type":"boolean","required":false,"x-from-version":"6.0"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the product in JSON standard format","schema":{"type":"object","properties":{"uuid":{"type":"string","description":"Product uuid"},"enabled":{"type":"boolean","description":"Whether the product is enabled","default":true},"family":{"type":"string","description":"Family code from which the product inherits its attributes and attributes requirements.","x-validation-rules":"It is equal to an existing family code. In the case of variant product, the given family should be the same as the product model family.","default":"null only in the case of a non variant product"},"categories":{"type":"array","description":"Codes of the categories in which the product is classified","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"groups":{"type":"array","description":"Codes of the groups to which the product belong","x-validation-rules":"Each string of the array is equal to an existing group code","items":{"type":"string"},"default":[]},"parent":{"type":"string","description":"Code of the parent product model when the product is a variant (only available since the 2.0). This parent can be modified since the 2.3.","x-validation-rules":"It is equal to an existing product model code only if the product is variant otherwise it's equal to null","default":"null","x-from-version":"2.0"},"values":{"type":"object","description":"Product attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value. See the `data` format section for more details."},"linked_data":{"type":"object","x-read-only":true,"description":"Object containing additional data when a related query parameter is enabled. See the `linked_data` format section for more details. (only available since the 5.0)","x-from-version":"5.0","properties":{"attribute":{"type":"string"},"code":{"type":"string"},"labels":{"type":"object"}}},"attribute_type":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"The type of the value's attribute. See type section for more details."},"reference_data_name":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"Reference entity code when the attribute type is `akeneo_reference_entity` or `akeneo_reference_entity_collection` OR Asset family code when the attribute type is `pim_catalog_asset_collection`","x-warning":"Only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types"}}}}}},"associations":{"type":"object","description":"Several associations related to groups, product models and/or other products, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the uuid of an existing product. • Each string in the array of the property `product_models` is the code of an existing product model.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of product uuids with which the product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Several quantified associations related to products and/or product models, grouped by quantified association types (only available since the 5.0)","x-validation-rules":"• The `quantifiedAssociationTypeCode` is the code of an existing association type which provides quantity information. • Each object in the array of the property `products` contains the uuid of an existing product and the quantity of it.","x-from-version":"5.0","properties":{"quantifiedAssociationTypeCode":{"type":"object","properties":{"products":{"type":"array","description":"Array of objects containing product uuids and quantities with which the product is in relation","items":{"type":"object","properties":{"uuid":{"type":"string"},"quantity":{"type":"integer"}}}},"product_models":{"type":"array","description":"Array of objects containing product model codes and quantities with which the product is in relation","items":{"type":"object","properties":{"code":{"type":"string"},"quantity":{"type":"integer"}}}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"metadata":{"type":"object","description":"More information around the product (only available since the v2.0 in the Enterprise Edition)","x-immutable":true,"x-read-only":true,"x-from-version":"2.0","properties":{"workflow_status":{"description":"Status of the product regarding the user permissions","type":"string","enum":["read_only","draft_in_progress","proposal_waiting_for_approval","working_copy"]}}},"quality_scores":{"type":"object","description":"Product quality scores for each channel/locale combination (only available since the 5.0 and when the \"with_quality_scores\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"5.0"},"completenesses":{"type":"array","description":"Product completenesses for each channel/locale combination (only available since the 7.0 version, and when the \"with_completenesses\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"7.0","items":{"type":"object","properties":{"scope":{"type":"string"},"locale":{"type":"string"},"data":{"type":"integer"}}}}},"example":{"uuid":"25566245-55c3-42ce-86d9-8610ac459fa8","enabled":true,"family":"tshirt","categories":["summer_collection"],"groups":[],"parent":null,"values":{"sku":[{"data":"top","locale":null,"scope":null}],"name":[{"data":"Top","locale":"en_US","scope":null},{"data":"Débardeur","locale":"fr_FR","scope":null}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce"},{"data":"Top","locale":"en_US","scope":"tablet"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}}}],"size":[{"locale":null,"scope":null,"data":"m","linked_data":{"attribute":"size","code":"m","labels":{"en_US":"M","fr_FR":"M"}}}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"],"linked_data":{"winter_2016":{"attribute":"collection","code":"winter_2016","labels":{"en_US":"Winter 2016","fr_FR":"Hiver 2016"}}}}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["d055527c-0698-4967-8f16-8a5f23f4e5cf"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"uuid":"fc24e6c3-933c-4a93-8a81-e5c703d134d5","quantity":2},{"uuid":"a9b69002-a0b1-4ead-85c2-f8dbf59c6cfc","quantity":1}],"product_models":[{"identifier":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"completenesses":[{"scope":"ecommerce","locale":"en_US","data":10},{"scope":"ecommerce","locale":"fr_FR","data":20},{"scope":"tablet","locale":"en_US","data":30},{"scope":"tablet","locale":"fr_FR","data":40}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"patch":{"summary":"Update/create a product","operationId":"patch_products_uuid__uuid_","tags":["Product [uuid]"],"x-versions":["7.0","SaaS"],"description":"This endpoint allows you to update a given product. Learn more about Update behavior. Note that if no product exists for the given uuid, it creates it. In the Entreprise Edition, permissions based on your user groups are applied to the product you try to update. It may result in the creation of a draft if you only have edit rights through the product's categories.","parameters":[{"name":"uuid","in":"path","description":"Uuid of the resource","required":true,"type":"string"},{"name":"body","in":"body","required":true,"schema":{"type":"object","properties":{"uuid":{"type":"string","description":"Product uuid"},"enabled":{"type":"boolean","description":"Whether the product is enabled","default":true},"family":{"type":"string","description":"Family code from which the product inherits its attributes and attributes requirements.","x-validation-rules":"It is equal to an existing family code. In the case of variant product, the given family should be the same as the product model family.","default":"null only in the case of a non variant product"},"categories":{"type":"array","description":"Codes of the categories in which the product is classified","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"groups":{"type":"array","description":"Codes of the groups to which the product belong","x-validation-rules":"Each string of the array is equal to an existing group code","items":{"type":"string"},"default":[]},"parent":{"type":"string","description":"Code of the parent product model when the product is a variant (only available since the 2.0). This parent can be modified since the 2.3.","x-validation-rules":"It is equal to an existing product model code only if the product is variant otherwise it's equal to null","default":"null","x-from-version":"2.0"},"values":{"type":"object","description":"Product attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value. See the `data` format section for more details."},"linked_data":{"type":"object","x-read-only":true,"description":"Object containing additional data when a related query parameter is enabled. See the `linked_data` format section for more details. (only available since the 5.0)","x-from-version":"5.0","properties":{"attribute":{"type":"string"},"code":{"type":"string"},"labels":{"type":"object"}}},"attribute_type":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"The type of the value's attribute. See type section for more details."},"reference_data_name":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"Reference entity code when the attribute type is `akeneo_reference_entity` or `akeneo_reference_entity_collection` OR Asset family code when the attribute type is `pim_catalog_asset_collection`","x-warning":"Only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types"}}}}}},"associations":{"type":"object","description":"Several associations related to groups, product models and/or other products, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the uuid of an existing product. • Each string in the array of the property `product_models` is the code of an existing product model.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of product uuids with which the product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Several quantified associations related to products and/or product models, grouped by quantified association types (only available since the 5.0)","x-validation-rules":"• The `quantifiedAssociationTypeCode` is the code of an existing association type which provides quantity information. • Each object in the array of the property `products` contains the uuid of an existing product and the quantity of it.","x-from-version":"5.0","properties":{"quantifiedAssociationTypeCode":{"type":"object","properties":{"products":{"type":"array","description":"Array of objects containing product uuids and quantities with which the product is in relation","items":{"type":"object","properties":{"uuid":{"type":"string"},"quantity":{"type":"integer"}}}},"product_models":{"type":"array","description":"Array of objects containing product model codes and quantities with which the product is in relation","items":{"type":"object","properties":{"code":{"type":"string"},"quantity":{"type":"integer"}}}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"metadata":{"type":"object","description":"More information around the product (only available since the v2.0 in the Enterprise Edition)","x-immutable":true,"x-read-only":true,"x-from-version":"2.0","properties":{"workflow_status":{"description":"Status of the product regarding the user permissions","type":"string","enum":["read_only","draft_in_progress","proposal_waiting_for_approval","working_copy"]}}},"quality_scores":{"type":"object","description":"Product quality scores for each channel/locale combination (only available since the 5.0 and when the \"with_quality_scores\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"5.0"},"completenesses":{"type":"array","description":"Product completenesses for each channel/locale combination (only available since the 7.0 version, and when the \"with_completenesses\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"7.0","items":{"type":"object","properties":{"scope":{"type":"string"},"locale":{"type":"string"},"data":{"type":"integer"}}}}},"example":{"uuid":"25566245-55c3-42ce-86d9-8610ac459fa8","enabled":true,"family":"tshirt","categories":["summer_collection"],"groups":[],"parent":null,"values":{"sku":[{"data":"top","locale":null,"scope":null}],"name":[{"data":"Top","locale":"en_US","scope":null},{"data":"Débardeur","locale":"fr_FR","scope":null}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce"},{"data":"Top","locale":"en_US","scope":"tablet"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}}}],"size":[{"locale":null,"scope":null,"data":"m","linked_data":{"attribute":"size","code":"m","labels":{"en_US":"M","fr_FR":"M"}}}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"],"linked_data":{"winter_2016":{"attribute":"collection","code":"winter_2016","labels":{"en_US":"Winter 2016","fr_FR":"Hiver 2016"}}}}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["d055527c-0698-4967-8f16-8a5f23f4e5cf"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"uuid":"fc24e6c3-933c-4a93-8a81-e5c703d134d5","quantity":2},{"uuid":"a9b69002-a0b1-4ead-85c2-f8dbf59c6cfc","quantity":1}],"product_models":[{"identifier":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"completenesses":[{"scope":"ecommerce","locale":"en_US","data":10},{"scope":"ecommerce","locale":"fr_FR","data":20},{"scope":"tablet","locale":"en_US","data":30},{"scope":"tablet","locale":"fr_FR","data":40}]}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"204":{"description":"No content to return","x-details":"Means that the update was successful","headers":{"Location":{"description":"URI of the updated resource","type":"string"}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}},"delete":{"summary":"Delete a product","operationId":"delete_products_uuid__uuid_","tags":["Product [uuid]"],"x-versions":["7.0","SaaS"],"description":"This endpoint allows you to delete a given product. In the Enterprise Edition, permissions based on your user groups are applied to the product you try to delete.","parameters":[{"name":"uuid","in":"path","description":"Uuid of the resource","required":true,"type":"string"}],"responses":{"204":{"description":"No content to return","x-details":"Means that the deletion was successful"},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}}}}},"/api/rest/v1/products-uuid/{uuid}/proposal":{"post":{"summary":"Submit a draft for approval","operationId":"post_proposal_uuid","tags":["Product [uuid]"],"x-versions":["7.0","SaaS"],"x-ee":true,"description":"This endpoint allows you to submit a draft for approval.","parameters":[{"name":"uuid","in":"path","description":"Uuid of the resource","required":true,"type":"string"}],"responses":{"201":{"description":"Submitted","x-details":"Means that the draft submission was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/products-uuid/{uuid}/draft":{"get":{"summary":"Get a draft","operationId":"get_draft_uuid__uuid_","tags":["Product [uuid]"],"x-versions":["7.0","SaaS"],"x-ee":true,"description":"This endpoint allows you to get the information about a given draft.","parameters":[{"name":"uuid","in":"path","description":"Uuid of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the draft in JSON standard format","schema":{"type":"object","properties":{"uuid":{"type":"string","description":"Product uuid"},"enabled":{"type":"boolean","description":"Whether the product is enabled","default":true},"family":{"type":"string","description":"Family code from which the product inherits its attributes and attributes requirements.","x-validation-rules":"It is equal to an existing family code. In the case of variant product, the given family should be the same as the product model family.","default":"null only in the case of a non variant product"},"categories":{"type":"array","description":"Codes of the categories in which the product is classified","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"groups":{"type":"array","description":"Codes of the groups to which the product belong","x-validation-rules":"Each string of the array is equal to an existing group code","items":{"type":"string"},"default":[]},"parent":{"type":"string","description":"Code of the parent product model when the product is a variant (only available since the 2.0). This parent can be modified since the 2.3.","x-validation-rules":"It is equal to an existing product model code only if the product is variant otherwise it's equal to null","default":"null","x-from-version":"2.0"},"values":{"type":"object","description":"Product attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value. See the `data` format section for more details."},"linked_data":{"type":"object","x-read-only":true,"description":"Object containing additional data when a related query parameter is enabled. See the `linked_data` format section for more details. (only available since the 5.0)","x-from-version":"5.0","properties":{"attribute":{"type":"string"},"code":{"type":"string"},"labels":{"type":"object"}}},"attribute_type":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"The type of the value's attribute. See type section for more details."},"reference_data_name":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"Reference entity code when the attribute type is `akeneo_reference_entity` or `akeneo_reference_entity_collection` OR Asset family code when the attribute type is `pim_catalog_asset_collection`","x-warning":"Only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types"}}}}}},"associations":{"type":"object","description":"Several associations related to groups, product models and/or other products, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the uuid of an existing product. • Each string in the array of the property `product_models` is the code of an existing product model.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of product uuids with which the product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Several quantified associations related to products and/or product models, grouped by quantified association types (only available since the 5.0)","x-validation-rules":"• The `quantifiedAssociationTypeCode` is the code of an existing association type which provides quantity information. • Each object in the array of the property `products` contains the uuid of an existing product and the quantity of it.","x-from-version":"5.0","properties":{"quantifiedAssociationTypeCode":{"type":"object","properties":{"products":{"type":"array","description":"Array of objects containing product uuids and quantities with which the product is in relation","items":{"type":"object","properties":{"uuid":{"type":"string"},"quantity":{"type":"integer"}}}},"product_models":{"type":"array","description":"Array of objects containing product model codes and quantities with which the product is in relation","items":{"type":"object","properties":{"code":{"type":"string"},"quantity":{"type":"integer"}}}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"metadata":{"type":"object","description":"More information around the product (only available since the v2.0 in the Enterprise Edition)","x-immutable":true,"x-read-only":true,"x-from-version":"2.0","properties":{"workflow_status":{"description":"Status of the product regarding the user permissions","type":"string","enum":["read_only","draft_in_progress","proposal_waiting_for_approval","working_copy"]}}},"quality_scores":{"type":"object","description":"Product quality scores for each channel/locale combination (only available since the 5.0 and when the \"with_quality_scores\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"5.0"},"completenesses":{"type":"array","description":"Product completenesses for each channel/locale combination (only available since the 7.0 version, and when the \"with_completenesses\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"7.0","items":{"type":"object","properties":{"scope":{"type":"string"},"locale":{"type":"string"},"data":{"type":"integer"}}}}},"example":{"uuid":"25566245-55c3-42ce-86d9-8610ac459fa8","enabled":true,"family":"tshirt","categories":["summer_collection"],"groups":[],"parent":null,"values":{"sku":[{"data":"top","locale":null,"scope":null}],"name":[{"data":"Top","locale":"en_US","scope":null},{"data":"Débardeur","locale":"fr_FR","scope":null}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce"},{"data":"Top","locale":"en_US","scope":"tablet"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}}}],"size":[{"locale":null,"scope":null,"data":"m","linked_data":{"attribute":"size","code":"m","labels":{"en_US":"M","fr_FR":"M"}}}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"],"linked_data":{"winter_2016":{"attribute":"collection","code":"winter_2016","labels":{"en_US":"Winter 2016","fr_FR":"Hiver 2016"}}}}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["d055527c-0698-4967-8f16-8a5f23f4e5cf"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"uuid":"fc24e6c3-933c-4a93-8a81-e5c703d134d5","quantity":2},{"uuid":"a9b69002-a0b1-4ead-85c2-f8dbf59c6cfc","quantity":1}],"product_models":[{"identifier":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"completenesses":[{"scope":"ecommerce","locale":"en_US","data":10},{"scope":"ecommerce","locale":"fr_FR","data":20},{"scope":"tablet","locale":"en_US","data":30},{"scope":"tablet","locale":"fr_FR","data":40}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}}},"/api/rest/v1/products":{"get":{"summary":"Get list of products","operationId":"get_products","tags":["Product [identifier]"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to get a list of products. Products are paginated and they can be filtered. In the Enterprise Edition, since the 2.0, permissions based on your user groups are applied to the set of products you request.","parameters":[{"name":"search","in":"query","description":"Filter products, for more details see the Filters section","required":false,"type":"string"},{"name":"scope","in":"query","type":"string","description":"Filter product values to return scopable attributes for the given channel as well as the non localizable/non scopable attributes, for more details see the Filter product values via channel section","required":false},{"name":"locales","in":"query","type":"string","description":"Filter product values to return localizable attributes for the given locales as well as the non localizable/non scopable attributes, for more details see the Filter product values via locale section","required":false},{"name":"attributes","in":"query","type":"string","description":"Filter product values to only return those concerning the given attributes, for more details see the Filter on product values section","required":false},{"name":"pagination_type","in":"query","description":"Pagination method type, see Pagination section","required":false,"type":"string","default":"page","x-validation-rules":"One of the following values","enum":["page","search_after"]},{"name":"page","in":"query","description":"Number of the page to retrieve when using the `page` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"integer","default":1},{"name":"search_after","in":"query","description":"Cursor when using the `search_after` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"string","default":"cursor to the first page"},{"name":"limit","in":"query","description":"Number of results by page, see Pagination section","required":false,"type":"integer","minimum":1,"maximum":100,"default":10},{"name":"with_count","in":"query","description":"Return the count of items in the response. Be carefull with that, on a big catalog, it can decrease performance in a significative way","default":false,"type":"boolean","required":false},{"name":"with_attribute_options","in":"query","description":"Return labels of attribute options in the response. See the `linked_data` format section for more details. (Only available since the 5.0 version)","default":false,"type":"boolean","required":false,"x-from-version":"5.0"},{"name":"with_asset_share_links","in":"query","description":"Return asset collection share link urls in the response. See the `linked_data` format section for more details. (Only available in the SaaS version)","default":false,"type":"boolean","required":false,"x-from-version":"SaaS"},{"name":"with_quality_scores","in":"query","description":"Return product quality scores in the response. (Only available since the 5.0 version)","default":false,"type":"boolean","required":false,"x-from-version":"5.0"},{"name":"with_completenesses","in":"query","description":"Return product completenesses in the response. (Only available since the 6.0 version)","default":false,"type":"boolean","required":false,"x-from-version":"6.0"}],"responses":{"200":{"description":"Return products paginated","schema":{"title":"Products","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"previous":{"type":"object","properties":{"href":{"type":"string","description":"URI of the previous page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}},"current_page":{"type":"integer","description":"Current page number"}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["identifier"],"properties":{"uuid":{"type":"string","description":"Product UUID","x-from-version":"7.0"},"identifier":{"type":"string","description":"Product identifier, i.e. the value of the only `pim_catalog_identifier` attribute"},"enabled":{"type":"boolean","description":"Whether the product is enabled","default":true},"family":{"type":"string","description":"Family code from which the product inherits its attributes and attributes requirements.","x-validation-rules":"It is equal to an existing family code. In the case of variant product, the given family should be the same as the product model family.","default":"null only in the case of a non variant product"},"categories":{"type":"array","description":"Codes of the categories in which the product is classified","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"groups":{"type":"array","description":"Codes of the groups to which the product belong","x-validation-rules":"Each string of the array is equal to an existing group code","items":{"type":"string"},"default":[]},"parent":{"type":"string","description":"Code of the parent product model when the product is a variant (only available since the 2.0). This parent can be modified since the 2.3.","x-validation-rules":"It is equal to an existing product model code only if the product is variant otherwise it's equal to null","default":"null","x-from-version":"2.0"},"values":{"type":"object","description":"Product attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value. See the `data` format section for more details."},"linked_data":{"type":"object","x-read-only":true,"description":"Object containing additional data when a related query parameter is enabled. See the `linked_data` format section for more details. (only available since the 5.0)","x-from-version":"5.0","properties":{"attribute":{"type":"string"},"code":{"type":"string"},"labels":{"type":"object"}}},"attribute_type":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"The type of the value's attribute. See type section for more details."},"reference_data_name":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"Reference entity code when the attribute type is `akeneo_reference_entity` or `akeneo_reference_entity_collection` OR Asset family code when the attribute type is `pim_catalog_asset_collection`","x-warning":"Only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types"}}}}}},"associations":{"type":"object","description":"Several associations related to groups, product models and/or other products, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the identifier of an existing product. • Each string in the array of the property `product_models` is the code of an existing product model.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of product identifiers with which the product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Several quantified associations related to products and/or product models, grouped by quantified association types (only available since the 5.0)","x-validation-rules":"• The `quantifiedAssociationTypeCode` is the code of an existing association type which provides quantity information. • Each object in the array of the property `products` contains the identifier of an existing product and the quantity of it.","x-from-version":"5.0","properties":{"quantifiedAssociationTypeCode":{"type":"object","properties":{"products":{"type":"array","description":"Array of objects containing product identifiers and quantities with which the product is in relation","items":{"type":"object","properties":{"identifier":{"type":"string"},"quantity":{"type":"integer"}}}},"product_models":{"type":"array","description":"Array of objects containing product model codes and quantities with which the product is in relation","items":{"type":"object","properties":{"code":{"type":"string"},"quantity":{"type":"integer"}}}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"metadata":{"type":"object","description":"More information around the product (only available since the v2.0 in the Enterprise Edition)","x-immutable":true,"x-read-only":true,"x-from-version":"2.0","properties":{"workflow_status":{"description":"Status of the product regarding the user permissions","type":"string","enum":["read_only","draft_in_progress","proposal_waiting_for_approval","working_copy"]}}},"quality_scores":{"type":"object","description":"Product quality scores for each channel/locale combination (only available since the 5.0 and when the \"with_quality_scores\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"5.0"},"completenesses":{"type":"array","description":"Product completenesses for each channel/locale combination (only available since the 7.0 version, and when the \"with_completenesses\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"7.0","items":{"type":"object","properties":{"scope":{"type":"string"},"locale":{"type":"string"},"data":{"type":"integer"}}}}},"example":{"identifier":"top","enabled":true,"family":"tshirt","categories":["summer_collection"],"groups":[],"parent":null,"values":{"name":[{"data":"Top","locale":"en_US","scope":null,"attribute_type":"pim_catalog_text"},{"data":"Débardeur","locale":"fr_FR","scope":null,"attribute_type":"pim_catalog_text"}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce","attribute_type":"pim_catalog_textarea"},{"data":"Top","locale":"en_US","scope":"tablet","attribute_type":"pim_catalog_textarea"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce","attribute_type":"pim_catalog_textarea"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet","attribute_type":"pim_catalog_textarea"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}],"attribute_type":"pim_catalog_price_collection"}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}},"attribute_type":"pim_catalog_simpleselect"}],"size":[{"locale":null,"scope":null,"data":"m","linked_data":{"attribute":"size","code":"m","labels":{"en_US":"M","fr_FR":"M"}},"attribute_type":"pim_catalog_simpleselect"}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"],"linked_data":{"winter_2016":{"attribute":"collection","code":"winter_2016","labels":{"en_US":"Winter 2016","fr_FR":"Hiver 2016"}}},"attribute_type":"pim_catalog_multiselect"}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglass"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"cap","quantity":2},{"identifier":"shoes","quantity":1}],"product_models":[{"identifier":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"completenesses":[{"scope":"ecommerce","locale":"en_US","data":10},{"scope":"ecommerce","locale":"fr_FR","data":20},{"scope":"tablet","locale":"en_US","data":30},{"scope":"tablet","locale":"fr_FR","data":40}]}}]}}}}}}]},"x-examples-per-version":[{"x-version":"1.7","x-example":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=3&limit=3"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=1&limit=3"},"previous":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=2&limit=3"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=4&limit=3"}},"current_page":3,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/top"}},"identifier":"top","family":"tshirt","groups":[],"categories":["summer_collection"],"enabled":true,"values":{"name":[{"data":"Top","locale":"en_US","scope":null},{"data":"Débardeur","locale":"fr_FR","scope":null}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce"},{"data":"Top","locale":"en_US","scope":"tablet"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black"}],"size":[{"locale":null,"scope":null,"data":"m"}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"]}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglasses"],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"cap","quantity":2},{"identifier":"shoes","quantity":1}]}}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/cap"}},"identifier":"cap","family":"caps","groups":[],"categories":["summer_collection"],"enabled":true,"values":{"name":[{"data":"Cap","locale":"en_US","scope":null},{"data":"Casquette","locale":"fr_FR","scope":null}],"description":[{"data":"Cap unisex","locale":"en_US","scope":"ecommerce"},{"data":"Cap unisex","locale":"en_US","scope":"tablet"},{"data":"Casquette unisexe","locale":"fr_FR","scope":"ecommerce"},{"data":"Casquette unisexe","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"20","currency":"EUR"},{"amount":"20","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black"}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglasses"],"groups":[]}},"quantified_associations":{}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/sweat"}},"identifier":"sweat","family":null,"groups":[],"categories":["winter_collection"],"enabled":true,"values":{},"created":"2016-06-23T11:24:44+02:00","updated":"2016-06-23T11:24:44+02:00","associations":{},"quantified_associations":{}}]}}},{"x-version":"2.0","x-example":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=3&limit=3"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=1&limit=3"},"previous":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=2&limit=3"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=4&limit=3"}},"current_page":3,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/top"}},"identifier":"top","family":"tshirt","groups":[],"parent":null,"categories":["summer_collection"],"enabled":true,"values":{"name":[{"data":"Top","locale":"en_US","scope":null},{"data":"Débardeur","locale":"fr_FR","scope":null}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce"},{"data":"Top","locale":"en_US","scope":"tablet"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black"}],"size":[{"locale":null,"scope":null,"data":"m"}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"]}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglasses"],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"cap","quantity":2},{"identifier":"shoes","quantity":1}]}}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/cap"}},"identifier":"cap","family":"caps","groups":[],"parent":null,"categories":["summer_collection"],"enabled":true,"values":{"name":[{"data":"Cap","locale":"en_US","scope":null},{"data":"Casquette","locale":"fr_FR","scope":null}],"description":[{"data":"Cap unisex","locale":"en_US","scope":"ecommerce"},{"data":"Cap unisex","locale":"en_US","scope":"tablet"},{"data":"Casquette unisexe","locale":"fr_FR","scope":"ecommerce"},{"data":"Casquette unisexe","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"20","currency":"EUR"},{"amount":"20","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black"}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglasses"],"groups":[]}},"quantified_associations":{}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/sweat"}},"identifier":"sweat","family":null,"groups":[],"parent":null,"categories":["winter_collection"],"enabled":true,"values":{},"created":"2016-06-23T11:24:44+02:00","updated":"2016-06-23T11:24:44+02:00","associations":{},"quantified_associations":{}}]}}},{"x-version":"2.1","x-example":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=3&limit=3"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=1&limit=3"},"previous":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=2&limit=3"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=4&limit=3"}},"current_page":3,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/top"}},"identifier":"top","family":"tshirt","groups":[],"parent":null,"categories":["summer_collection"],"enabled":true,"values":{"name":[{"data":"Top","locale":"en_US","scope":null},{"data":"Débardeur","locale":"fr_FR","scope":null}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce"},{"data":"Top","locale":"en_US","scope":"tablet"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black"}],"size":[{"locale":null,"scope":null,"data":"m"}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"]}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglasses"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"cap","quantity":2},{"identifier":"shoes","quantity":1}],"product_models":[{"identifier":"model-biker-jacket-leather","quantity":2}]}}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/cap"}},"identifier":"cap","family":"caps","groups":[],"parent":null,"categories":["summer_collection"],"enabled":true,"values":{"name":[{"data":"Cap","locale":"en_US","scope":null},{"data":"Casquette","locale":"fr_FR","scope":null}],"description":[{"data":"Cap unisex","locale":"en_US","scope":"ecommerce"},{"data":"Cap unisex","locale":"en_US","scope":"tablet"},{"data":"Casquette unisexe","locale":"fr_FR","scope":"ecommerce"},{"data":"Casquette unisexe","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"20","currency":"EUR"},{"amount":"20","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black"}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglasses"],"product_models":[],"groups":[]}},"quantified_associations":{}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/sweat"}},"identifier":"sweat","family":null,"groups":[],"parent":null,"categories":["winter_collection"],"enabled":true,"values":{},"created":"2016-06-23T11:24:44+02:00","updated":"2016-06-23T11:24:44+02:00","associations":{},"quantified_associations":{}}]}}},{"x-version":"5.0","x-example":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=3&limit=3&with_quality_scores=true&with_attribute_options=true"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=1&limit=3&with_quality_scores=true&with_attribute_options=true"},"previous":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=2&limit=3&with_quality_scores=true&with_attribute_options=true"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=4&limit=3&with_quality_scores=true&with_attribute_options=true"}},"current_page":3,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/top"}},"identifier":"top","family":"tshirt","groups":[],"parent":null,"categories":["summer_collection"],"enabled":true,"values":{"name":[{"data":"Top","locale":"en_US","scope":null},{"data":"Débardeur","locale":"fr_FR","scope":null}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce"},{"data":"Top","locale":"en_US","scope":"tablet"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}}}],"size":[{"locale":null,"scope":null,"data":"m","linked_data":{"attribute":"size","code":"m","labels":{"en_US":"M","fr_FR":"M"}}}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"],"linked_data":{"winter_2016":{"attribute":"collection","code":"winter_2016","labels":{"en_US":"Winter 2016","fr_FR":"Hiver 2016"}}}}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglasses"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"cap","quantity":2},{"identifier":"shoes","quantity":1}],"product_models":[{"identifier":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}]},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/cap"}},"identifier":"cap","family":"caps","groups":[],"parent":null,"categories":["summer_collection"],"enabled":true,"values":{"name":[{"data":"Cap","locale":"en_US","scope":null},{"data":"Casquette","locale":"fr_FR","scope":null}],"description":[{"data":"Cap unisex","locale":"en_US","scope":"ecommerce"},{"data":"Cap unisex","locale":"en_US","scope":"tablet"},{"data":"Casquette unisexe","locale":"fr_FR","scope":"ecommerce"},{"data":"Casquette unisexe","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"20","currency":"EUR"},{"amount":"20","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}}}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglasses"],"product_models":[],"groups":[]}},"quantified_associations":{},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}]},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/sweat"}},"identifier":"sweat","family":null,"groups":[],"parent":null,"categories":["winter_collection"],"enabled":true,"values":{},"created":"2016-06-23T11:24:44+02:00","updated":"2016-06-23T11:24:44+02:00","associations":{},"quantified_associations":{},"quality_scores":{}}]}}},{"x-version":"SaaS","x-example":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=3&limit=3&with_quality_scores=true&with_completenesses=true&with_attribute_options=true"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=1&limit=3&with_quality_scores=true&with_completenesses=true&with_attribute_options=true"},"previous":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=2&limit=3&with_quality_scores=true&with_completenesses=true&with_attribute_options=true"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=4&limit=3&with_quality_scores=true&with_completenesses=true&with_attribute_options=true"}},"current_page":3,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/top"}},"uuid":"aaf518b2-f91e-40f1-a53a-78ce5e81a6f9","identifier":"top","family":"tshirt","groups":[],"parent":null,"categories":["summer_collection"],"enabled":true,"values":{"name":[{"data":"Top","locale":"en_US","scope":null,"attribute_type":"pim_catalog_text"},{"data":"Débardeur","locale":"fr_FR","scope":null,"attribute_type":"pim_catalog_text"}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce","attribute_type":"pim_catalog_textarea"},{"data":"Top","locale":"en_US","scope":"tablet","attribute_type":"pim_catalog_textarea"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce","attribute_type":"pim_catalog_textarea"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet","attribute_type":"pim_catalog_textarea"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}],"attribute_type":"pim_catalog_price_collection"}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}},"attribute_type":"pim_catalog_simpleselect"}],"size":[{"locale":null,"scope":null,"data":"m","linked_data":{"attribute":"size","code":"m","labels":{"en_US":"M","fr_FR":"M"}},"attribute_type":"pim_catalog_simpleselect"}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"],"linked_data":{"winter_2016":{"attribute":"collection","code":"winter_2016","labels":{"en_US":"Winter 2016","fr_FR":"Hiver 2016"}}},"attribute_type":"pim_catalog_multiselect"}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglasses"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"cap","quantity":2},{"identifier":"shoes","quantity":1}],"product_models":[{"identifier":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"completenesses":[{"scope":"ecommerce","locale":"en_US","data":20},{"scope":"ecommerce","locale":"fr_FR","data":30},{"scope":"tablet","locale":"en_US","data":55},{"scope":"tablet","locale":"fr_FR","data":70}]},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/cap"}},"uuid":"aec6780b-c813-4bd7-8e24-1a8574471576","identifier":"cap","family":"caps","groups":[],"parent":null,"categories":["summer_collection"],"enabled":true,"values":{"name":[{"data":"Cap","locale":"en_US","scope":null},{"data":"Casquette","locale":"fr_FR","scope":null}],"description":[{"data":"Cap unisex","locale":"en_US","scope":"ecommerce"},{"data":"Cap unisex","locale":"en_US","scope":"tablet"},{"data":"Casquette unisexe","locale":"fr_FR","scope":"ecommerce"},{"data":"Casquette unisexe","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"20","currency":"EUR"},{"amount":"20","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}}}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglasses"],"product_models":[],"groups":[]}},"quantified_associations":{},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"completenesses":[{"scope":"ecommerce","locale":"en_US","data":20},{"scope":"ecommerce","locale":"fr_FR","data":30},{"scope":"tablet","locale":"en_US","data":55},{"scope":"tablet","locale":"fr_FR","data":70}]},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/sweat"}},"uuid":"93f14b03-5ed3-4f23-87c6-ae3806041b6a","identifier":"sweat","family":null,"groups":[],"parent":null,"categories":["winter_collection"],"enabled":true,"values":{},"created":"2016-06-23T11:24:44+02:00","updated":"2016-06-23T11:24:44+02:00","associations":{},"quantified_associations":{},"quality_scores":{},"completenesses":[]}]}}}]},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}},"post":{"summary":"Create a new product","operationId":"post_products","tags":["Product [identifier]"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to create a new product. In the Enterprise Edition, since the v2.0, permissions based on your user groups are applied to the product you try to create.","parameters":[{"name":"body","in":"body","schema":{"type":"object","required":["identifier"],"properties":{"uuid":{"type":"string","description":"Product UUID","x-from-version":"7.0"},"identifier":{"type":"string","description":"Product identifier, i.e. the value of the only `pim_catalog_identifier` attribute"},"enabled":{"type":"boolean","description":"Whether the product is enabled","default":true},"family":{"type":"string","description":"Family code from which the product inherits its attributes and attributes requirements.","x-validation-rules":"It is equal to an existing family code. In the case of variant product, the given family should be the same as the product model family.","default":"null only in the case of a non variant product"},"categories":{"type":"array","description":"Codes of the categories in which the product is classified","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"groups":{"type":"array","description":"Codes of the groups to which the product belong","x-validation-rules":"Each string of the array is equal to an existing group code","items":{"type":"string"},"default":[]},"parent":{"type":"string","description":"Code of the parent product model when the product is a variant (only available since the 2.0). This parent can be modified since the 2.3.","x-validation-rules":"It is equal to an existing product model code only if the product is variant otherwise it's equal to null","default":"null","x-from-version":"2.0"},"values":{"type":"object","description":"Product attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value. See the `data` format section for more details."},"linked_data":{"type":"object","x-read-only":true,"description":"Object containing additional data when a related query parameter is enabled. See the `linked_data` format section for more details. (only available since the 5.0)","x-from-version":"5.0","properties":{"attribute":{"type":"string"},"code":{"type":"string"},"labels":{"type":"object"}}},"attribute_type":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"The type of the value's attribute. See type section for more details."},"reference_data_name":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"Reference entity code when the attribute type is `akeneo_reference_entity` or `akeneo_reference_entity_collection` OR Asset family code when the attribute type is `pim_catalog_asset_collection`","x-warning":"Only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types"}}}}}},"associations":{"type":"object","description":"Several associations related to groups, product models and/or other products, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the identifier of an existing product. • Each string in the array of the property `product_models` is the code of an existing product model.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of product identifiers with which the product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Several quantified associations related to products and/or product models, grouped by quantified association types (only available since the 5.0)","x-validation-rules":"• The `quantifiedAssociationTypeCode` is the code of an existing association type which provides quantity information. • Each object in the array of the property `products` contains the identifier of an existing product and the quantity of it.","x-from-version":"5.0","properties":{"quantifiedAssociationTypeCode":{"type":"object","properties":{"products":{"type":"array","description":"Array of objects containing product identifiers and quantities with which the product is in relation","items":{"type":"object","properties":{"identifier":{"type":"string"},"quantity":{"type":"integer"}}}},"product_models":{"type":"array","description":"Array of objects containing product model codes and quantities with which the product is in relation","items":{"type":"object","properties":{"code":{"type":"string"},"quantity":{"type":"integer"}}}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"metadata":{"type":"object","description":"More information around the product (only available since the v2.0 in the Enterprise Edition)","x-immutable":true,"x-read-only":true,"x-from-version":"2.0","properties":{"workflow_status":{"description":"Status of the product regarding the user permissions","type":"string","enum":["read_only","draft_in_progress","proposal_waiting_for_approval","working_copy"]}}},"quality_scores":{"type":"object","description":"Product quality scores for each channel/locale combination (only available since the 5.0 and when the \"with_quality_scores\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"5.0"},"completenesses":{"type":"array","description":"Product completenesses for each channel/locale combination (only available since the 7.0 version, and when the \"with_completenesses\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"7.0","items":{"type":"object","properties":{"scope":{"type":"string"},"locale":{"type":"string"},"data":{"type":"integer"}}}}},"example":{"identifier":"top","enabled":true,"family":"tshirt","categories":["summer_collection"],"groups":[],"parent":null,"values":{"name":[{"data":"Top","locale":"en_US","scope":null,"attribute_type":"pim_catalog_text"},{"data":"Débardeur","locale":"fr_FR","scope":null,"attribute_type":"pim_catalog_text"}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce","attribute_type":"pim_catalog_textarea"},{"data":"Top","locale":"en_US","scope":"tablet","attribute_type":"pim_catalog_textarea"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce","attribute_type":"pim_catalog_textarea"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet","attribute_type":"pim_catalog_textarea"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}],"attribute_type":"pim_catalog_price_collection"}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}},"attribute_type":"pim_catalog_simpleselect"}],"size":[{"locale":null,"scope":null,"data":"m","linked_data":{"attribute":"size","code":"m","labels":{"en_US":"M","fr_FR":"M"}},"attribute_type":"pim_catalog_simpleselect"}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"],"linked_data":{"winter_2016":{"attribute":"collection","code":"winter_2016","labels":{"en_US":"Winter 2016","fr_FR":"Hiver 2016"}}},"attribute_type":"pim_catalog_multiselect"}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglass"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"cap","quantity":2},{"identifier":"shoes","quantity":1}],"product_models":[{"identifier":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"completenesses":[{"scope":"ecommerce","locale":"en_US","data":10},{"scope":"ecommerce","locale":"fr_FR","data":20},{"scope":"tablet","locale":"en_US","data":30},{"scope":"tablet","locale":"fr_FR","data":40}]}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}},"patch":{"summary":"Update/create several products","operationId":"patch_products","tags":["Product [identifier]"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to update and/or create several products at once. Learn more about Update behavior. Note that if no product exists for the given identifier, it creates it. In the Enterprise Edition, since the v2.0, permissions based on your user groups are applied to the products you try to update. It may result in the creation of drafts if you only have edit rights through the product's categories.","x-body-by-line":"Contains several lines, each line is a product in JSON standard format","parameters":[{"name":"body","in":"body","schema":{"x-examples":{"x-example-1":"{\"identifier\":\"cap\",\"values\":{\"description\":[{\"scope\":\"ecommerce\",\"locale\":\"en_US\",\"data\":\"My amazing cap\"}]}}","x-example-2":"{\"identifier\":\"mug\",\"group\":[\"promotion\"]}","x-example-3":"{\"identifier\":\"tshirt\",\"family\":\"clothes\"}"},"type":"object","required":["identifier"],"properties":{"uuid":{"type":"string","description":"Product UUID","x-from-version":"7.0"},"identifier":{"type":"string","description":"Product identifier, i.e. the value of the only `pim_catalog_identifier` attribute"},"enabled":{"type":"boolean","description":"Whether the product is enabled","default":true},"family":{"type":"string","description":"Family code from which the product inherits its attributes and attributes requirements.","x-validation-rules":"It is equal to an existing family code. In the case of variant product, the given family should be the same as the product model family.","default":"null only in the case of a non variant product"},"categories":{"type":"array","description":"Codes of the categories in which the product is classified","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"groups":{"type":"array","description":"Codes of the groups to which the product belong","x-validation-rules":"Each string of the array is equal to an existing group code","items":{"type":"string"},"default":[]},"parent":{"type":"string","description":"Code of the parent product model when the product is a variant (only available since the 2.0). This parent can be modified since the 2.3.","x-validation-rules":"It is equal to an existing product model code only if the product is variant otherwise it's equal to null","default":"null","x-from-version":"2.0"},"values":{"type":"object","description":"Product attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value. See the `data` format section for more details."},"linked_data":{"type":"object","x-read-only":true,"description":"Object containing additional data when a related query parameter is enabled. See the `linked_data` format section for more details. (only available since the 5.0)","x-from-version":"5.0","properties":{"attribute":{"type":"string"},"code":{"type":"string"},"labels":{"type":"object"}}},"attribute_type":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"The type of the value's attribute. See type section for more details."},"reference_data_name":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"Reference entity code when the attribute type is `akeneo_reference_entity` or `akeneo_reference_entity_collection` OR Asset family code when the attribute type is `pim_catalog_asset_collection`","x-warning":"Only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types"}}}}}},"associations":{"type":"object","description":"Several associations related to groups, product models and/or other products, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the identifier of an existing product. • Each string in the array of the property `product_models` is the code of an existing product model.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of product identifiers with which the product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Several quantified associations related to products and/or product models, grouped by quantified association types (only available since the 5.0)","x-validation-rules":"• The `quantifiedAssociationTypeCode` is the code of an existing association type which provides quantity information. • Each object in the array of the property `products` contains the identifier of an existing product and the quantity of it.","x-from-version":"5.0","properties":{"quantifiedAssociationTypeCode":{"type":"object","properties":{"products":{"type":"array","description":"Array of objects containing product identifiers and quantities with which the product is in relation","items":{"type":"object","properties":{"identifier":{"type":"string"},"quantity":{"type":"integer"}}}},"product_models":{"type":"array","description":"Array of objects containing product model codes and quantities with which the product is in relation","items":{"type":"object","properties":{"code":{"type":"string"},"quantity":{"type":"integer"}}}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"metadata":{"type":"object","description":"More information around the product (only available since the v2.0 in the Enterprise Edition)","x-immutable":true,"x-read-only":true,"x-from-version":"2.0","properties":{"workflow_status":{"description":"Status of the product regarding the user permissions","type":"string","enum":["read_only","draft_in_progress","proposal_waiting_for_approval","working_copy"]}}},"quality_scores":{"type":"object","description":"Product quality scores for each channel/locale combination (only available since the 5.0 and when the \"with_quality_scores\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"5.0"},"completenesses":{"type":"array","description":"Product completenesses for each channel/locale combination (only available since the 7.0 version, and when the \"with_completenesses\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"7.0","items":{"type":"object","properties":{"scope":{"type":"string"},"locale":{"type":"string"},"data":{"type":"integer"}}}}},"example":{"identifier":"top","enabled":true,"family":"tshirt","categories":["summer_collection"],"groups":[],"parent":null,"values":{"name":[{"data":"Top","locale":"en_US","scope":null,"attribute_type":"pim_catalog_text"},{"data":"Débardeur","locale":"fr_FR","scope":null,"attribute_type":"pim_catalog_text"}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce","attribute_type":"pim_catalog_textarea"},{"data":"Top","locale":"en_US","scope":"tablet","attribute_type":"pim_catalog_textarea"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce","attribute_type":"pim_catalog_textarea"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet","attribute_type":"pim_catalog_textarea"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}],"attribute_type":"pim_catalog_price_collection"}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}},"attribute_type":"pim_catalog_simpleselect"}],"size":[{"locale":null,"scope":null,"data":"m","linked_data":{"attribute":"size","code":"m","labels":{"en_US":"M","fr_FR":"M"}},"attribute_type":"pim_catalog_simpleselect"}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"],"linked_data":{"winter_2016":{"attribute":"collection","code":"winter_2016","labels":{"en_US":"Winter 2016","fr_FR":"Hiver 2016"}}},"attribute_type":"pim_catalog_multiselect"}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglass"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"cap","quantity":2},{"identifier":"shoes","quantity":1}],"product_models":[{"identifier":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"completenesses":[{"scope":"ecommerce","locale":"en_US","data":10},{"scope":"ecommerce","locale":"fr_FR","data":20},{"scope":"tablet","locale":"en_US","data":30},{"scope":"tablet","locale":"fr_FR","data":40}]}}}],"responses":{"200":{"description":"OK","x-details":"Returns a plain text response whose lines are JSON containing the status of each update or creation","x-no-entity":true,"schema":{"type":"object","properties":{"line":{"type":"integer","description":"Line number"},"identifier":{"type":"string","description":"Resource identifier, only filled when the resource is a product"},"code":{"type":"string","description":"Resource code, only filled when the resource is not a product"},"status_code":{"type":"integer","description":"HTTP status code, see Client errors to understand the meaning of each code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"x-example-1":"{\"line\":1,\"identifier\":\"cap\",\"status_code\":204}","x-example-2":"{\"line\":2,\"identifier\":\"mug\",\"status_code\":422,\"message\":\"Property \\\"group\\\" does not exist.\"}","x-example-3":"{\"line\":3,\"identifier\":\"tshirt\",\"status_code\":201}"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"413":{"description":"Request Entity Too Large","x-details":"There are too many resources to process (max 100) or the line of JSON is too long (max 1 000 000 characters)","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":413,"message":"Too many resources to process, 100 is the maximum allowed."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/vnd.akeneo.collection+json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/vnd.akeneo.collection+json’ is allowed."}}}}},"/api/rest/v1/products/{code}":{"get":{"summary":"Get a product","operationId":"get_products__code_","tags":["Product [identifier]"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to get the information about a given product. In the Entreprise Edition, since the v2.0, permissions based on your user groups are applied to the product you request.","parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"},{"name":"with_attribute_options","in":"query","description":"Return labels of attribute options in the response. See the `linked_data` format section for more details. (Only available since the 5.0 version)","default":false,"type":"boolean","required":false,"x-from-version":"5.0"},{"name":"with_asset_share_links","in":"query","description":"Return asset collection share link urls in the response. See the `linked_data` format section for more details. (Only available in the SaaS version)","default":false,"type":"boolean","required":false,"x-from-version":"SaaS"},{"name":"with_quality_scores","in":"query","description":"Return product quality scores in the response. (Only available since the 5.0 version)","default":false,"type":"boolean","required":false,"x-from-version":"5.0"},{"name":"with_completenesses","in":"query","description":"Return product completenesses in the response. (Only available since the 6.0 version)","default":false,"type":"boolean","required":false,"x-from-version":"6.0"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the product in JSON standard format","schema":{"type":"object","required":["identifier"],"properties":{"uuid":{"type":"string","description":"Product UUID","x-from-version":"7.0"},"identifier":{"type":"string","description":"Product identifier, i.e. the value of the only `pim_catalog_identifier` attribute"},"enabled":{"type":"boolean","description":"Whether the product is enabled","default":true},"family":{"type":"string","description":"Family code from which the product inherits its attributes and attributes requirements.","x-validation-rules":"It is equal to an existing family code. In the case of variant product, the given family should be the same as the product model family.","default":"null only in the case of a non variant product"},"categories":{"type":"array","description":"Codes of the categories in which the product is classified","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"groups":{"type":"array","description":"Codes of the groups to which the product belong","x-validation-rules":"Each string of the array is equal to an existing group code","items":{"type":"string"},"default":[]},"parent":{"type":"string","description":"Code of the parent product model when the product is a variant (only available since the 2.0). This parent can be modified since the 2.3.","x-validation-rules":"It is equal to an existing product model code only if the product is variant otherwise it's equal to null","default":"null","x-from-version":"2.0"},"values":{"type":"object","description":"Product attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value. See the `data` format section for more details."},"linked_data":{"type":"object","x-read-only":true,"description":"Object containing additional data when a related query parameter is enabled. See the `linked_data` format section for more details. (only available since the 5.0)","x-from-version":"5.0","properties":{"attribute":{"type":"string"},"code":{"type":"string"},"labels":{"type":"object"}}},"attribute_type":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"The type of the value's attribute. See type section for more details."},"reference_data_name":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"Reference entity code when the attribute type is `akeneo_reference_entity` or `akeneo_reference_entity_collection` OR Asset family code when the attribute type is `pim_catalog_asset_collection`","x-warning":"Only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types"}}}}}},"associations":{"type":"object","description":"Several associations related to groups, product models and/or other products, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the identifier of an existing product. • Each string in the array of the property `product_models` is the code of an existing product model.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of product identifiers with which the product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Several quantified associations related to products and/or product models, grouped by quantified association types (only available since the 5.0)","x-validation-rules":"• The `quantifiedAssociationTypeCode` is the code of an existing association type which provides quantity information. • Each object in the array of the property `products` contains the identifier of an existing product and the quantity of it.","x-from-version":"5.0","properties":{"quantifiedAssociationTypeCode":{"type":"object","properties":{"products":{"type":"array","description":"Array of objects containing product identifiers and quantities with which the product is in relation","items":{"type":"object","properties":{"identifier":{"type":"string"},"quantity":{"type":"integer"}}}},"product_models":{"type":"array","description":"Array of objects containing product model codes and quantities with which the product is in relation","items":{"type":"object","properties":{"code":{"type":"string"},"quantity":{"type":"integer"}}}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"metadata":{"type":"object","description":"More information around the product (only available since the v2.0 in the Enterprise Edition)","x-immutable":true,"x-read-only":true,"x-from-version":"2.0","properties":{"workflow_status":{"description":"Status of the product regarding the user permissions","type":"string","enum":["read_only","draft_in_progress","proposal_waiting_for_approval","working_copy"]}}},"quality_scores":{"type":"object","description":"Product quality scores for each channel/locale combination (only available since the 5.0 and when the \"with_quality_scores\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"5.0"},"completenesses":{"type":"array","description":"Product completenesses for each channel/locale combination (only available since the 7.0 version, and when the \"with_completenesses\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"7.0","items":{"type":"object","properties":{"scope":{"type":"string"},"locale":{"type":"string"},"data":{"type":"integer"}}}}},"example":{"identifier":"top","enabled":true,"family":"tshirt","categories":["summer_collection"],"groups":[],"parent":null,"values":{"name":[{"data":"Top","locale":"en_US","scope":null,"attribute_type":"pim_catalog_text"},{"data":"Débardeur","locale":"fr_FR","scope":null,"attribute_type":"pim_catalog_text"}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce","attribute_type":"pim_catalog_textarea"},{"data":"Top","locale":"en_US","scope":"tablet","attribute_type":"pim_catalog_textarea"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce","attribute_type":"pim_catalog_textarea"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet","attribute_type":"pim_catalog_textarea"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}],"attribute_type":"pim_catalog_price_collection"}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}},"attribute_type":"pim_catalog_simpleselect"}],"size":[{"locale":null,"scope":null,"data":"m","linked_data":{"attribute":"size","code":"m","labels":{"en_US":"M","fr_FR":"M"}},"attribute_type":"pim_catalog_simpleselect"}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"],"linked_data":{"winter_2016":{"attribute":"collection","code":"winter_2016","labels":{"en_US":"Winter 2016","fr_FR":"Hiver 2016"}}},"attribute_type":"pim_catalog_multiselect"}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglass"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"cap","quantity":2},{"identifier":"shoes","quantity":1}],"product_models":[{"identifier":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"completenesses":[{"scope":"ecommerce","locale":"en_US","data":10},{"scope":"ecommerce","locale":"fr_FR","data":20},{"scope":"tablet","locale":"en_US","data":30},{"scope":"tablet","locale":"fr_FR","data":40}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"patch":{"summary":"Update/create a product","operationId":"patch_products__code_","tags":["Product [identifier]"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to update a given product. Learn more about Update behavior. Note that if no product exists for the given identifier, it creates it. In the Entreprise Edition, since the v2.0, permissions based on your user groups are applied to the product you try to update. It may result in the creation of a draft if you only have edit rights through the product's categories.","parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"},{"name":"body","in":"body","required":true,"schema":{"type":"object","required":["identifier"],"properties":{"uuid":{"type":"string","description":"Product UUID","x-from-version":"7.0"},"identifier":{"type":"string","description":"Product identifier, i.e. the value of the only `pim_catalog_identifier` attribute"},"enabled":{"type":"boolean","description":"Whether the product is enabled","default":true},"family":{"type":"string","description":"Family code from which the product inherits its attributes and attributes requirements.","x-validation-rules":"It is equal to an existing family code. In the case of variant product, the given family should be the same as the product model family.","default":"null only in the case of a non variant product"},"categories":{"type":"array","description":"Codes of the categories in which the product is classified","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"groups":{"type":"array","description":"Codes of the groups to which the product belong","x-validation-rules":"Each string of the array is equal to an existing group code","items":{"type":"string"},"default":[]},"parent":{"type":"string","description":"Code of the parent product model when the product is a variant (only available since the 2.0). This parent can be modified since the 2.3.","x-validation-rules":"It is equal to an existing product model code only if the product is variant otherwise it's equal to null","default":"null","x-from-version":"2.0"},"values":{"type":"object","description":"Product attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value. See the `data` format section for more details."},"linked_data":{"type":"object","x-read-only":true,"description":"Object containing additional data when a related query parameter is enabled. See the `linked_data` format section for more details. (only available since the 5.0)","x-from-version":"5.0","properties":{"attribute":{"type":"string"},"code":{"type":"string"},"labels":{"type":"object"}}},"attribute_type":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"The type of the value's attribute. See type section for more details."},"reference_data_name":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"Reference entity code when the attribute type is `akeneo_reference_entity` or `akeneo_reference_entity_collection` OR Asset family code when the attribute type is `pim_catalog_asset_collection`","x-warning":"Only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types"}}}}}},"associations":{"type":"object","description":"Several associations related to groups, product models and/or other products, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the identifier of an existing product. • Each string in the array of the property `product_models` is the code of an existing product model.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of product identifiers with which the product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Several quantified associations related to products and/or product models, grouped by quantified association types (only available since the 5.0)","x-validation-rules":"• The `quantifiedAssociationTypeCode` is the code of an existing association type which provides quantity information. • Each object in the array of the property `products` contains the identifier of an existing product and the quantity of it.","x-from-version":"5.0","properties":{"quantifiedAssociationTypeCode":{"type":"object","properties":{"products":{"type":"array","description":"Array of objects containing product identifiers and quantities with which the product is in relation","items":{"type":"object","properties":{"identifier":{"type":"string"},"quantity":{"type":"integer"}}}},"product_models":{"type":"array","description":"Array of objects containing product model codes and quantities with which the product is in relation","items":{"type":"object","properties":{"code":{"type":"string"},"quantity":{"type":"integer"}}}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"metadata":{"type":"object","description":"More information around the product (only available since the v2.0 in the Enterprise Edition)","x-immutable":true,"x-read-only":true,"x-from-version":"2.0","properties":{"workflow_status":{"description":"Status of the product regarding the user permissions","type":"string","enum":["read_only","draft_in_progress","proposal_waiting_for_approval","working_copy"]}}},"quality_scores":{"type":"object","description":"Product quality scores for each channel/locale combination (only available since the 5.0 and when the \"with_quality_scores\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"5.0"},"completenesses":{"type":"array","description":"Product completenesses for each channel/locale combination (only available since the 7.0 version, and when the \"with_completenesses\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"7.0","items":{"type":"object","properties":{"scope":{"type":"string"},"locale":{"type":"string"},"data":{"type":"integer"}}}}},"example":{"identifier":"top","enabled":true,"family":"tshirt","categories":["summer_collection"],"groups":[],"parent":null,"values":{"name":[{"data":"Top","locale":"en_US","scope":null,"attribute_type":"pim_catalog_text"},{"data":"Débardeur","locale":"fr_FR","scope":null,"attribute_type":"pim_catalog_text"}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce","attribute_type":"pim_catalog_textarea"},{"data":"Top","locale":"en_US","scope":"tablet","attribute_type":"pim_catalog_textarea"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce","attribute_type":"pim_catalog_textarea"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet","attribute_type":"pim_catalog_textarea"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}],"attribute_type":"pim_catalog_price_collection"}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}},"attribute_type":"pim_catalog_simpleselect"}],"size":[{"locale":null,"scope":null,"data":"m","linked_data":{"attribute":"size","code":"m","labels":{"en_US":"M","fr_FR":"M"}},"attribute_type":"pim_catalog_simpleselect"}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"],"linked_data":{"winter_2016":{"attribute":"collection","code":"winter_2016","labels":{"en_US":"Winter 2016","fr_FR":"Hiver 2016"}}},"attribute_type":"pim_catalog_multiselect"}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglass"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"cap","quantity":2},{"identifier":"shoes","quantity":1}],"product_models":[{"identifier":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"completenesses":[{"scope":"ecommerce","locale":"en_US","data":10},{"scope":"ecommerce","locale":"fr_FR","data":20},{"scope":"tablet","locale":"en_US","data":30},{"scope":"tablet","locale":"fr_FR","data":40}]}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"204":{"description":"No content to return","x-details":"Means that the update was successful","headers":{"Location":{"description":"URI of the updated resource","type":"string"}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}},"delete":{"summary":"Delete a product","operationId":"delete_products__code_","tags":["Product [identifier]"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to delete a given product. In the Enterprise Edition, since the 2.0, permissions based on your user groups are applied to the product you try to delete.","parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"204":{"description":"No content to return","x-details":"Means that the deletion was successful"},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}}}}},"/api/rest/v1/products/{code}/proposal":{"post":{"summary":"Submit a draft for approval","operationId":"post_proposal","tags":["Product [identifier]"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"description":"This endpoint allows you to submit a draft for approval.","parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"201":{"description":"Submitted","x-details":"Means that the draft submission was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/products/{code}/draft":{"get":{"summary":"Get a draft","operationId":"get_draft__code_","tags":["Product [identifier]"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"description":"This endpoint allows you to get the information about a given draft.","parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the draft in JSON standard format","schema":{"type":"object","required":["identifier"],"properties":{"uuid":{"type":"string","description":"Product UUID","x-from-version":"7.0"},"identifier":{"type":"string","description":"Product identifier, i.e. the value of the only `pim_catalog_identifier` attribute"},"enabled":{"type":"boolean","description":"Whether the product is enabled","default":true},"family":{"type":"string","description":"Family code from which the product inherits its attributes and attributes requirements.","x-validation-rules":"It is equal to an existing family code. In the case of variant product, the given family should be the same as the product model family.","default":"null only in the case of a non variant product"},"categories":{"type":"array","description":"Codes of the categories in which the product is classified","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"groups":{"type":"array","description":"Codes of the groups to which the product belong","x-validation-rules":"Each string of the array is equal to an existing group code","items":{"type":"string"},"default":[]},"parent":{"type":"string","description":"Code of the parent product model when the product is a variant (only available since the 2.0). This parent can be modified since the 2.3.","x-validation-rules":"It is equal to an existing product model code only if the product is variant otherwise it's equal to null","default":"null","x-from-version":"2.0"},"values":{"type":"object","description":"Product attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value. See the `data` format section for more details."},"linked_data":{"type":"object","x-read-only":true,"description":"Object containing additional data when a related query parameter is enabled. See the `linked_data` format section for more details. (only available since the 5.0)","x-from-version":"5.0","properties":{"attribute":{"type":"string"},"code":{"type":"string"},"labels":{"type":"object"}}},"attribute_type":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"The type of the value's attribute. See type section for more details."},"reference_data_name":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"Reference entity code when the attribute type is `akeneo_reference_entity` or `akeneo_reference_entity_collection` OR Asset family code when the attribute type is `pim_catalog_asset_collection`","x-warning":"Only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types"}}}}}},"associations":{"type":"object","description":"Several associations related to groups, product models and/or other products, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the identifier of an existing product. • Each string in the array of the property `product_models` is the code of an existing product model.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of product identifiers with which the product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Several quantified associations related to products and/or product models, grouped by quantified association types (only available since the 5.0)","x-validation-rules":"• The `quantifiedAssociationTypeCode` is the code of an existing association type which provides quantity information. • Each object in the array of the property `products` contains the identifier of an existing product and the quantity of it.","x-from-version":"5.0","properties":{"quantifiedAssociationTypeCode":{"type":"object","properties":{"products":{"type":"array","description":"Array of objects containing product identifiers and quantities with which the product is in relation","items":{"type":"object","properties":{"identifier":{"type":"string"},"quantity":{"type":"integer"}}}},"product_models":{"type":"array","description":"Array of objects containing product model codes and quantities with which the product is in relation","items":{"type":"object","properties":{"code":{"type":"string"},"quantity":{"type":"integer"}}}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"metadata":{"type":"object","description":"More information around the product (only available since the v2.0 in the Enterprise Edition)","x-immutable":true,"x-read-only":true,"x-from-version":"2.0","properties":{"workflow_status":{"description":"Status of the product regarding the user permissions","type":"string","enum":["read_only","draft_in_progress","proposal_waiting_for_approval","working_copy"]}}},"quality_scores":{"type":"object","description":"Product quality scores for each channel/locale combination (only available since the 5.0 and when the \"with_quality_scores\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"5.0"},"completenesses":{"type":"array","description":"Product completenesses for each channel/locale combination (only available since the 7.0 version, and when the \"with_completenesses\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"7.0","items":{"type":"object","properties":{"scope":{"type":"string"},"locale":{"type":"string"},"data":{"type":"integer"}}}}},"example":{"identifier":"top","enabled":true,"family":"tshirt","categories":["summer_collection"],"groups":[],"parent":null,"values":{"name":[{"data":"Top","locale":"en_US","scope":null,"attribute_type":"pim_catalog_text"},{"data":"Débardeur","locale":"fr_FR","scope":null,"attribute_type":"pim_catalog_text"}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce","attribute_type":"pim_catalog_textarea"},{"data":"Top","locale":"en_US","scope":"tablet","attribute_type":"pim_catalog_textarea"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce","attribute_type":"pim_catalog_textarea"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet","attribute_type":"pim_catalog_textarea"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}],"attribute_type":"pim_catalog_price_collection"}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}},"attribute_type":"pim_catalog_simpleselect"}],"size":[{"locale":null,"scope":null,"data":"m","linked_data":{"attribute":"size","code":"m","labels":{"en_US":"M","fr_FR":"M"}},"attribute_type":"pim_catalog_simpleselect"}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"],"linked_data":{"winter_2016":{"attribute":"collection","code":"winter_2016","labels":{"en_US":"Winter 2016","fr_FR":"Hiver 2016"}}},"attribute_type":"pim_catalog_multiselect"}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglass"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"cap","quantity":2},{"identifier":"shoes","quantity":1}],"product_models":[{"identifier":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"completenesses":[{"scope":"ecommerce","locale":"en_US","data":10},{"scope":"ecommerce","locale":"fr_FR","data":20},{"scope":"tablet","locale":"en_US","data":30},{"scope":"tablet","locale":"fr_FR","data":40}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}}},"/api/rest/v1/product-models":{"get":{"summary":"Get list of product models","operationId":"get_product_models","tags":["Product model"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to get a list of product models. Product models are paginated. In the Enterprise Edition, since the 2.0, permissions based on your user groups are applied to the set of products you request.","parameters":[{"name":"search","in":"query","description":"Filter product models, for more details see the Filters section","required":false,"type":"string"},{"name":"scope","in":"query","type":"string","description":"Filter product values to return scopable attributes for the given channel as well as the non localizable/non scopable attributes, for more details see the Filter product values via channel section","required":false},{"name":"locales","in":"query","type":"string","description":"Filter product values to return localizable attributes for the given locales as well as the non localizable/non scopable attributes, for more details see the Filter product values via locale section","required":false},{"name":"attributes","in":"query","type":"string","description":"Filter product values to only return those concerning the given attributes, for more details see the Filter on product values section and the Filter on product model properties section","required":false},{"name":"pagination_type","in":"query","description":"Pagination method type, see Pagination section","required":false,"type":"string","default":"page","x-validation-rules":"One of the following values","enum":["page","search_after"]},{"name":"page","in":"query","description":"Number of the page to retrieve when using the `page` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"integer","default":1},{"name":"search_after","in":"query","description":"Cursor when using the `search_after` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"string","default":"cursor to the first page"},{"name":"limit","in":"query","description":"Number of results by page, see Pagination section","required":false,"type":"integer","minimum":1,"maximum":100,"default":10},{"name":"with_count","in":"query","description":"Return the count of items in the response. Be carefull with that, on a big catalog, it can decrease performance in a significative way","default":false,"type":"boolean","required":false},{"name":"with_attribute_options","in":"query","description":"Return labels of attribute options in the response. (Only available on SaaS platforms)","default":false,"type":"boolean","required":false,"x-from-version":"SaaS"},{"name":"with_asset_share_links","in":"query","description":"Return asset collection share link urls in the response. See the `linked_data` format section for more details. (Only available in the SaaS version)","default":false,"type":"boolean","required":false,"x-from-version":"SaaS"},{"name":"with_quality_scores","in":"query","description":"Return product model quality scores in the response. (Only available since the 6.0 version)","type":"boolean","required":false,"x-from-version":"6.0"}],"responses":{"200":{"description":"Return product models paginated","schema":{"title":"Product Models","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"previous":{"type":"object","properties":{"href":{"type":"string","description":"URI of the previous page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}},"current_page":{"type":"integer","description":"Current page number"}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code","family_variant"],"properties":{"code":{"type":"string","description":"Product model code","x-immutable":true},"family":{"type":"string","description":"Family code from which the product inherits its attributes and attributes requirements (since the 3.2)","x-validation-rules":"It is equal to an existing family code","x-immutable":true,"x-from-version":"3.2"},"family_variant":{"type":"string","description":"Family variant code from which the product model inherits its attributes and variant attributes","x-validation-rules":"It is equal to an existing family variant code that belong to the family given in the `family` field","x-immutable":true},"parent":{"type":"string","description":"Code of the parent product model. This parent can be modified since the 2.3.","x-validation-rules":"• It is equal to an existing product model code • This product model has the same family variant as the one given in the `family_variant field`","default":"null","x-from-version":"2.3"},"categories":{"type":"array","description":"Codes of the categories in which the product model is categorized","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"values":{"type":"object","description":"Product model attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value"},"linked_data":{"type":"object","x-read-only":true,"description":"Object containing additional data when a related query parameter is enabled. See the `linked_data` format section for more details. (only available since the 5.0)","x-from-version":"SaaS","properties":{"attribute":{"type":"string"},"code":{"type":"string"},"labels":{"type":"object"}}}}}}}},"associations":{"type":"object","description":"Several associations related to groups, product and/or other product models, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the identifier of an existing product. • Each string in the array of the property `product_models` is the code of an existing product model.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of product identifiers with which the product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Several quantified associations related to products and/or product models, grouped by quantified association types (only available since the 5.0)","x-validation-rules":"• The `quantifiedAssociationTypeCode` is the code of an existing association type which provides quantity information. • Each object in the array of the property `products` contains the identifier of an existing product and the quantity of it. • Each object in the array of the property `product_models` contains the code of an existing product model and the quantity of it.","x-from-version":"5.0","properties":{"quantifiedAssociationTypeCode":{"type":"object","properties":{"products":{"type":"array","description":"Array of objects containing product identifiers and quantities with which the product model is in relation","items":{"type":"object","properties":{"identifier":{"type":"string"},"quantity":{"type":"integer"}}}},"product_models":{"type":"array","description":"Array of objects containing product model codes and quantities with which the product model is in relation","items":{"type":"object","properties":{"code":{"type":"string"},"quantity":{"type":"integer"}}}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"metadata":{"type":"object","description":"More information around the product model (only available since the v2.3 in the Enterprise Edition)","x-immutable":true,"x-read-only":true,"x-from-version":"2.3","properties":{"workflow_status":{"description":"Status of the product model regarding the user permissions","type":"string","enum":["read_only","draft_in_progress","proposal_waiting_for_approval","working_copy"]}}},"quality_scores":{"type":"object","description":"Product model quality scores for each channel/locale combination (only available since the 7.0 version and when the \"with_quality_scores\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"7.0"}},"example":{"code":"model-biker-jacket-leather","family":"clothing","family_variant":"clothing_material_size","parent":"model-biker-jacket","categories":["summer_collection"],"values":{"color":[{"locale":null,"scope":null,"data":"antique_white"}],"material":[{"locale":null,"scope":null,"data":"leather"}],"variation_name":[{"locale":"en_US","scope":null,"data":"Biker jacket leather"}],"name":[{"locale":"en_US","scope":null,"data":"Biker jacket"}],"collection":[{"locale":null,"scope":null,"data":["summer_2017"]}],"description":[{"locale":"en_US","scope":"ecommerce","data":"Biker jacket"}]},"associations":{"PACK":{"products":["sunglass"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"top","quantity":2},{"identifier":"cap","quantity":1}],"product_models":[{"code":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"created":"2017-10-02T15:03:55+02:00","updated":"2017-10-02T15:03:55+02:00"}}]}}}}}}]},"examples":{"_links":{"self":{"href":"http://demo.akeneo.com/api/rest/v1/product-models?pagination_type=search_after&limit=3&search_after=qg%3D%3D"},"first":{"href":"http://demo.akeneo.com/api/rest/v1/product-models?pagination_type=search_after&limit=3"},"next":{"href":"http://demo.akeneo.com/api/rest/v1/product-models?pagination_type=search_after&limit=3&search_after=rw%3D%3D"}},"_embedded":{"items":[{"_links":{"self":{"href":"http://demo.akeneo.com/api/rest/v1/product-models/amarisshoe"}},"code":"amarisshoe","family":"shoes","family_variant":"shoes_VariantA1","parent":null,"categories":["clothing","shoes"],"values":{"price":[{"locale":null,"scope":null,"data":[{"amount":"50.00","currency":"EUR"}]}],"description":[{"locale":"en_US","scope":"ecommerce","data":"I like shoes!"}]},"associations":{"PACK":{"products":["sunglasses"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"cap","quantity":2},{"identifier":"shoes","quantity":1}],"product_models":[{"identifier":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"created":"2017-10-04T18:04:10+02:00","updated":"2017-10-04T18:04:10+02:00"},{"_links":{"self":{"href":"http://demo.akeneo.com/api/rest/v1/product-models/Abiloitshirt"}},"code":"Abiloitshirt","family":"clothing","family_variant":"clothing_VariantA1","parent":null,"categories":["clothing","tshirt"],"values":{"price":[{"locale":null,"scope":null,"data":[{"amount":"50.00","currency":"EUR"}]}],"description":[{"locale":"en_US","scope":"ecommerce","data":"I like tshirt!"}]},"associations":{"PACK":{"products":["sunglasses"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"cap","quantity":2}],"product_models":[]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"created":"2017-10-04T18:04:10+02:00","updated":"2017-10-04T18:04:10+02:00"},{"_links":{"self":{"href":"http://demo.akeneo.com/api/rest/v1/product-models/Astertrousers"}},"code":"Astertrousers","family":"clothing","family_variant":"clothing_VariantA1","parent":null,"categories":["clothing","trousers"],"values":{"price":[{"locale":null,"scope":null,"data":[{"amount":"50.00","currency":"EUR"}]}],"description":[{"locale":"en_US","scope":"ecommerce","data":"I like trousers!"}]},"associations":{"PACK":{"products":["sunglasses"],"product_models":[],"groups":[]}},"quantified_associations":{},"created":"2017-10-04T18:04:10+02:00","updated":"2017-10-04T18:04:10+02:00"}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}},"post":{"summary":"Create a new product model","operationId":"post_product_models","tags":["Product model"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to create a new product model. In the Enterprise Edition, since the v2.3, permissions based on your user groups are applied to the product model you try to create.","parameters":[{"name":"body","in":"body","schema":{"type":"object","required":["code","family_variant"],"properties":{"code":{"type":"string","description":"Product model code","x-immutable":true},"family":{"type":"string","description":"Family code from which the product inherits its attributes and attributes requirements (since the 3.2)","x-validation-rules":"It is equal to an existing family code","x-immutable":true,"x-from-version":"3.2"},"family_variant":{"type":"string","description":"Family variant code from which the product model inherits its attributes and variant attributes","x-validation-rules":"It is equal to an existing family variant code that belong to the family given in the `family` field","x-immutable":true},"parent":{"type":"string","description":"Code of the parent product model. This parent can be modified since the 2.3.","x-validation-rules":"• It is equal to an existing product model code • This product model has the same family variant as the one given in the `family_variant field`","default":"null","x-from-version":"2.3"},"categories":{"type":"array","description":"Codes of the categories in which the product model is categorized","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"values":{"type":"object","description":"Product model attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value"},"linked_data":{"type":"object","x-read-only":true,"description":"Object containing additional data when a related query parameter is enabled. See the `linked_data` format section for more details. (only available since the 5.0)","x-from-version":"SaaS","properties":{"attribute":{"type":"string"},"code":{"type":"string"},"labels":{"type":"object"}}}}}}}},"associations":{"type":"object","description":"Several associations related to groups, product and/or other product models, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the identifier of an existing product. • Each string in the array of the property `product_models` is the code of an existing product model.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of product identifiers with which the product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Several quantified associations related to products and/or product models, grouped by quantified association types (only available since the 5.0)","x-validation-rules":"• The `quantifiedAssociationTypeCode` is the code of an existing association type which provides quantity information. • Each object in the array of the property `products` contains the identifier of an existing product and the quantity of it. • Each object in the array of the property `product_models` contains the code of an existing product model and the quantity of it.","x-from-version":"5.0","properties":{"quantifiedAssociationTypeCode":{"type":"object","properties":{"products":{"type":"array","description":"Array of objects containing product identifiers and quantities with which the product model is in relation","items":{"type":"object","properties":{"identifier":{"type":"string"},"quantity":{"type":"integer"}}}},"product_models":{"type":"array","description":"Array of objects containing product model codes and quantities with which the product model is in relation","items":{"type":"object","properties":{"code":{"type":"string"},"quantity":{"type":"integer"}}}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"metadata":{"type":"object","description":"More information around the product model (only available since the v2.3 in the Enterprise Edition)","x-immutable":true,"x-read-only":true,"x-from-version":"2.3","properties":{"workflow_status":{"description":"Status of the product model regarding the user permissions","type":"string","enum":["read_only","draft_in_progress","proposal_waiting_for_approval","working_copy"]}}},"quality_scores":{"type":"object","description":"Product model quality scores for each channel/locale combination (only available since the 7.0 version and when the \"with_quality_scores\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"7.0"}},"example":{"code":"model-biker-jacket-leather","family":"clothing","family_variant":"clothing_material_size","parent":"model-biker-jacket","categories":["summer_collection"],"values":{"color":[{"locale":null,"scope":null,"data":"antique_white"}],"material":[{"locale":null,"scope":null,"data":"leather"}],"variation_name":[{"locale":"en_US","scope":null,"data":"Biker jacket leather"}],"name":[{"locale":"en_US","scope":null,"data":"Biker jacket"}],"collection":[{"locale":null,"scope":null,"data":["summer_2017"]}],"description":[{"locale":"en_US","scope":"ecommerce","data":"Biker jacket"}]},"associations":{"PACK":{"products":["sunglass"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"top","quantity":2},{"identifier":"cap","quantity":1}],"product_models":[{"code":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"created":"2017-10-02T15:03:55+02:00","updated":"2017-10-02T15:03:55+02:00"}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}},"patch":{"summary":"Update/create several product models","operationId":"patch_product_models","tags":["Product model"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to update and/or create several product models at once. Learn more about Update behavior. Note that if no product models exists for the given code, it creates it. In the Enterprise Edition, since the v2.3, permissions based on your user groups are applied to the product models you try to update. It may result in the creation of drafts if you only have edit rights through the product model's categories.","x-body-by-line":"Contains several lines, each line is a product model in JSON standard format","parameters":[{"name":"body","in":"body","schema":{"x-examples":{"x-example-1":"{\"code\": \"sub_sweat_option_a\", \"parent\": \"sweat\", \"values\": {\"a_simple_select\": [{\"locale\": null, \"scope\": null, \"data\": \"optionA\"}]}}","x-example-2":"{\"code\": \"sub_sweat_option_b\", \"parent\": \"sweat\", \"values\": {\"a_simple_select\": [{\"locale\": null, \"scope\": null, \"data\": \"optionA\"}]}}","x-example-3":"{\"code\":\"tshirt\", \"parent\": \"root_tshirt\", \"family_variant\":\"clothesvariant\",\"values\":{\"description\":[{\"scope\":\"ecommerce\",\"locale\":\"en_US\",\"data\":\"My amazing tshirt\"}]}}"},"type":"object","required":["code","family_variant"],"properties":{"code":{"type":"string","description":"Product model code","x-immutable":true},"family":{"type":"string","description":"Family code from which the product inherits its attributes and attributes requirements (since the 3.2)","x-validation-rules":"It is equal to an existing family code","x-immutable":true,"x-from-version":"3.2"},"family_variant":{"type":"string","description":"Family variant code from which the product model inherits its attributes and variant attributes","x-validation-rules":"It is equal to an existing family variant code that belong to the family given in the `family` field","x-immutable":true},"parent":{"type":"string","description":"Code of the parent product model. This parent can be modified since the 2.3.","x-validation-rules":"• It is equal to an existing product model code • This product model has the same family variant as the one given in the `family_variant field`","default":"null","x-from-version":"2.3"},"categories":{"type":"array","description":"Codes of the categories in which the product model is categorized","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"values":{"type":"object","description":"Product model attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value"},"linked_data":{"type":"object","x-read-only":true,"description":"Object containing additional data when a related query parameter is enabled. See the `linked_data` format section for more details. (only available since the 5.0)","x-from-version":"SaaS","properties":{"attribute":{"type":"string"},"code":{"type":"string"},"labels":{"type":"object"}}}}}}}},"associations":{"type":"object","description":"Several associations related to groups, product and/or other product models, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the identifier of an existing product. • Each string in the array of the property `product_models` is the code of an existing product model.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of product identifiers with which the product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Several quantified associations related to products and/or product models, grouped by quantified association types (only available since the 5.0)","x-validation-rules":"• The `quantifiedAssociationTypeCode` is the code of an existing association type which provides quantity information. • Each object in the array of the property `products` contains the identifier of an existing product and the quantity of it. • Each object in the array of the property `product_models` contains the code of an existing product model and the quantity of it.","x-from-version":"5.0","properties":{"quantifiedAssociationTypeCode":{"type":"object","properties":{"products":{"type":"array","description":"Array of objects containing product identifiers and quantities with which the product model is in relation","items":{"type":"object","properties":{"identifier":{"type":"string"},"quantity":{"type":"integer"}}}},"product_models":{"type":"array","description":"Array of objects containing product model codes and quantities with which the product model is in relation","items":{"type":"object","properties":{"code":{"type":"string"},"quantity":{"type":"integer"}}}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"metadata":{"type":"object","description":"More information around the product model (only available since the v2.3 in the Enterprise Edition)","x-immutable":true,"x-read-only":true,"x-from-version":"2.3","properties":{"workflow_status":{"description":"Status of the product model regarding the user permissions","type":"string","enum":["read_only","draft_in_progress","proposal_waiting_for_approval","working_copy"]}}},"quality_scores":{"type":"object","description":"Product model quality scores for each channel/locale combination (only available since the 7.0 version and when the \"with_quality_scores\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"7.0"}},"example":{"code":"model-biker-jacket-leather","family":"clothing","family_variant":"clothing_material_size","parent":"model-biker-jacket","categories":["summer_collection"],"values":{"color":[{"locale":null,"scope":null,"data":"antique_white"}],"material":[{"locale":null,"scope":null,"data":"leather"}],"variation_name":[{"locale":"en_US","scope":null,"data":"Biker jacket leather"}],"name":[{"locale":"en_US","scope":null,"data":"Biker jacket"}],"collection":[{"locale":null,"scope":null,"data":["summer_2017"]}],"description":[{"locale":"en_US","scope":"ecommerce","data":"Biker jacket"}]},"associations":{"PACK":{"products":["sunglass"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"top","quantity":2},{"identifier":"cap","quantity":1}],"product_models":[{"code":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"created":"2017-10-02T15:03:55+02:00","updated":"2017-10-02T15:03:55+02:00"}}}],"responses":{"200":{"description":"OK","x-details":"Returns a plain text response whose lines are JSON containing the status of each update or creation","x-no-entity":true,"schema":{"type":"object","properties":{"line":{"type":"integer","description":"Line number"},"identifier":{"type":"string","description":"Resource identifier, only filled when the resource is a product"},"code":{"type":"string","description":"Resource code, only filled when the resource is not a product"},"status_code":{"type":"integer","description":"HTTP status code, see Client errors to understand the meaning of each code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"x-example-1":"{\"line\":1,\"code\":\"sub_sweat_option_a\",\"status_code\":204}","x-example-2":"{\"line\":2,\"code\":\"sub_sweat_option_b\",\"status_code\":422,\"message\":\"Validation failed.\",\"errors\":[{\"property\":\"attribute\",\"message\":\"Cannot set value \\\"Option A\\\" for the attribute axis \\\"a_simple_select\\\", as another sibling entity already has this value\"}]}","x-example-3":"{\"line\":3,\"code\":\"tshirt\",\"status_code\":201}"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"413":{"description":"Request Entity Too Large","x-details":"There are too many resources to process (max 100) or the line of JSON is too long (max 1 000 000 characters)","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":413,"message":"Too many resources to process, 100 is the maximum allowed."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/vnd.akeneo.collection+json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/vnd.akeneo.collection+json’ is allowed."}}}}},"/api/rest/v1/product-models/{code}":{"get":{"summary":"Get a product model","operationId":"get_product_models__code_","tags":["Product model"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to get the information about a given product model. In the Entreprise Edition, since the v2.0, permissions based on your user groups are applied to the product model you request.","parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"},{"name":"with_asset_share_links","in":"query","description":"Return asset collection share link urls in the response. See the `linked_data` format section for more details. (Only available in the SaaS version)","default":false,"type":"boolean","required":false,"x-from-version":"SaaS"},{"name":"with_quality_scores","in":"query","description":"Return product model quality scores in the response. (Only available since the 6.0 version)","type":"boolean","required":false,"x-from-version":"6.0"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the product model in JSON standard format.","schema":{"type":"object","required":["code","family_variant"],"properties":{"code":{"type":"string","description":"Product model code","x-immutable":true},"family":{"type":"string","description":"Family code from which the product inherits its attributes and attributes requirements (since the 3.2)","x-validation-rules":"It is equal to an existing family code","x-immutable":true,"x-from-version":"3.2"},"family_variant":{"type":"string","description":"Family variant code from which the product model inherits its attributes and variant attributes","x-validation-rules":"It is equal to an existing family variant code that belong to the family given in the `family` field","x-immutable":true},"parent":{"type":"string","description":"Code of the parent product model. This parent can be modified since the 2.3.","x-validation-rules":"• It is equal to an existing product model code • This product model has the same family variant as the one given in the `family_variant field`","default":"null","x-from-version":"2.3"},"categories":{"type":"array","description":"Codes of the categories in which the product model is categorized","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"values":{"type":"object","description":"Product model attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value"},"linked_data":{"type":"object","x-read-only":true,"description":"Object containing additional data when a related query parameter is enabled. See the `linked_data` format section for more details. (only available since the 5.0)","x-from-version":"SaaS","properties":{"attribute":{"type":"string"},"code":{"type":"string"},"labels":{"type":"object"}}}}}}}},"associations":{"type":"object","description":"Several associations related to groups, product and/or other product models, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the identifier of an existing product. • Each string in the array of the property `product_models` is the code of an existing product model.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of product identifiers with which the product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Several quantified associations related to products and/or product models, grouped by quantified association types (only available since the 5.0)","x-validation-rules":"• The `quantifiedAssociationTypeCode` is the code of an existing association type which provides quantity information. • Each object in the array of the property `products` contains the identifier of an existing product and the quantity of it. • Each object in the array of the property `product_models` contains the code of an existing product model and the quantity of it.","x-from-version":"5.0","properties":{"quantifiedAssociationTypeCode":{"type":"object","properties":{"products":{"type":"array","description":"Array of objects containing product identifiers and quantities with which the product model is in relation","items":{"type":"object","properties":{"identifier":{"type":"string"},"quantity":{"type":"integer"}}}},"product_models":{"type":"array","description":"Array of objects containing product model codes and quantities with which the product model is in relation","items":{"type":"object","properties":{"code":{"type":"string"},"quantity":{"type":"integer"}}}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"metadata":{"type":"object","description":"More information around the product model (only available since the v2.3 in the Enterprise Edition)","x-immutable":true,"x-read-only":true,"x-from-version":"2.3","properties":{"workflow_status":{"description":"Status of the product model regarding the user permissions","type":"string","enum":["read_only","draft_in_progress","proposal_waiting_for_approval","working_copy"]}}},"quality_scores":{"type":"object","description":"Product model quality scores for each channel/locale combination (only available since the 7.0 version and when the \"with_quality_scores\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"7.0"}},"example":{"code":"model-biker-jacket-leather","family":"clothing","family_variant":"clothing_material_size","parent":"model-biker-jacket","categories":["summer_collection"],"values":{"color":[{"locale":null,"scope":null,"data":"antique_white"}],"material":[{"locale":null,"scope":null,"data":"leather"}],"variation_name":[{"locale":"en_US","scope":null,"data":"Biker jacket leather"}],"name":[{"locale":"en_US","scope":null,"data":"Biker jacket"}],"collection":[{"locale":null,"scope":null,"data":["summer_2017"]}],"description":[{"locale":"en_US","scope":"ecommerce","data":"Biker jacket"}]},"associations":{"PACK":{"products":["sunglass"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"top","quantity":2},{"identifier":"cap","quantity":1}],"product_models":[{"code":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"created":"2017-10-02T15:03:55+02:00","updated":"2017-10-02T15:03:55+02:00"}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"patch":{"summary":"Update/create a product model","operationId":"patch_product_models__code_","tags":["Product model"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to update a given product model. Learn more about Update behavior. Note that if no product model exists for the given code, it creates it. In the Enterprise Edition PIM since the 2.3, permissions based on your user groups are applied to the product model you try to update. It may result in the creation of a draft if you only have edit rights through the product model's categories.","parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"},{"name":"body","in":"body","required":true,"schema":{"type":"object","required":["code","family_variant"],"properties":{"code":{"type":"string","description":"Product model code","x-immutable":true},"family":{"type":"string","description":"Family code from which the product inherits its attributes and attributes requirements (since the 3.2)","x-validation-rules":"It is equal to an existing family code","x-immutable":true,"x-from-version":"3.2"},"family_variant":{"type":"string","description":"Family variant code from which the product model inherits its attributes and variant attributes","x-validation-rules":"It is equal to an existing family variant code that belong to the family given in the `family` field","x-immutable":true},"parent":{"type":"string","description":"Code of the parent product model. This parent can be modified since the 2.3.","x-validation-rules":"• It is equal to an existing product model code • This product model has the same family variant as the one given in the `family_variant field`","default":"null","x-from-version":"2.3"},"categories":{"type":"array","description":"Codes of the categories in which the product model is categorized","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"values":{"type":"object","description":"Product model attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value"},"linked_data":{"type":"object","x-read-only":true,"description":"Object containing additional data when a related query parameter is enabled. See the `linked_data` format section for more details. (only available since the 5.0)","x-from-version":"SaaS","properties":{"attribute":{"type":"string"},"code":{"type":"string"},"labels":{"type":"object"}}}}}}}},"associations":{"type":"object","description":"Several associations related to groups, product and/or other product models, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the identifier of an existing product. • Each string in the array of the property `product_models` is the code of an existing product model.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of product identifiers with which the product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Several quantified associations related to products and/or product models, grouped by quantified association types (only available since the 5.0)","x-validation-rules":"• The `quantifiedAssociationTypeCode` is the code of an existing association type which provides quantity information. • Each object in the array of the property `products` contains the identifier of an existing product and the quantity of it. • Each object in the array of the property `product_models` contains the code of an existing product model and the quantity of it.","x-from-version":"5.0","properties":{"quantifiedAssociationTypeCode":{"type":"object","properties":{"products":{"type":"array","description":"Array of objects containing product identifiers and quantities with which the product model is in relation","items":{"type":"object","properties":{"identifier":{"type":"string"},"quantity":{"type":"integer"}}}},"product_models":{"type":"array","description":"Array of objects containing product model codes and quantities with which the product model is in relation","items":{"type":"object","properties":{"code":{"type":"string"},"quantity":{"type":"integer"}}}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"metadata":{"type":"object","description":"More information around the product model (only available since the v2.3 in the Enterprise Edition)","x-immutable":true,"x-read-only":true,"x-from-version":"2.3","properties":{"workflow_status":{"description":"Status of the product model regarding the user permissions","type":"string","enum":["read_only","draft_in_progress","proposal_waiting_for_approval","working_copy"]}}},"quality_scores":{"type":"object","description":"Product model quality scores for each channel/locale combination (only available since the 7.0 version and when the \"with_quality_scores\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"7.0"}},"example":{"code":"model-biker-jacket-leather","family":"clothing","family_variant":"clothing_material_size","parent":"model-biker-jacket","categories":["summer_collection"],"values":{"color":[{"locale":null,"scope":null,"data":"antique_white"}],"material":[{"locale":null,"scope":null,"data":"leather"}],"variation_name":[{"locale":"en_US","scope":null,"data":"Biker jacket leather"}],"name":[{"locale":"en_US","scope":null,"data":"Biker jacket"}],"collection":[{"locale":null,"scope":null,"data":["summer_2017"]}],"description":[{"locale":"en_US","scope":"ecommerce","data":"Biker jacket"}]},"associations":{"PACK":{"products":["sunglass"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"top","quantity":2},{"identifier":"cap","quantity":1}],"product_models":[{"code":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"created":"2017-10-02T15:03:55+02:00","updated":"2017-10-02T15:03:55+02:00"}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"204":{"description":"No content to return","x-details":"Means that the update was successful","headers":{"Location":{"description":"URI of the updated resource","type":"string"}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}},"delete":{"summary":"Delete a product model","operationId":"delete_product_models__code_","tags":["Product model"],"x-versions":["6.0","7.0","SaaS"],"description":"This endpoint allows you to delete a given product model. All its children, product models and variant products, will be also deleted. In the Enterprise Edition, the permissions based on your connection user group are applied to the product model you try to delete.","parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"204":{"description":"No content to return","x-details":"Means that the deletion was successful"},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}}}}},"/api/rest/v1/product-models/{code}/proposal":{"post":{"summary":"Submit a draft for approval","operationId":"post_product_model_proposal","tags":["Product model"],"x-versions":["2.3","3.x","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"description":"This endpoint allows you to submit a product model draft for approval.","parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"201":{"description":"Submitted","x-details":"Means that the draft submission was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/product-models/{code}/draft":{"get":{"summary":"Get a draft","operationId":"get_product_model_draft__code_","tags":["Product model"],"x-versions":["2.3","3.x","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"description":"This endpoint allows you to get the information about a given product model draft.","parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the draft in JSON standard format","schema":{"type":"object","required":["code","family_variant"],"properties":{"code":{"type":"string","description":"Product model code","x-immutable":true},"family":{"type":"string","description":"Family code from which the product inherits its attributes and attributes requirements (since the 3.2)","x-validation-rules":"It is equal to an existing family code","x-immutable":true,"x-from-version":"3.2"},"family_variant":{"type":"string","description":"Family variant code from which the product model inherits its attributes and variant attributes","x-validation-rules":"It is equal to an existing family variant code that belong to the family given in the `family` field","x-immutable":true},"parent":{"type":"string","description":"Code of the parent product model. This parent can be modified since the 2.3.","x-validation-rules":"• It is equal to an existing product model code • This product model has the same family variant as the one given in the `family_variant field`","default":"null","x-from-version":"2.3"},"categories":{"type":"array","description":"Codes of the categories in which the product model is categorized","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"values":{"type":"object","description":"Product model attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value"},"linked_data":{"type":"object","x-read-only":true,"description":"Object containing additional data when a related query parameter is enabled. See the `linked_data` format section for more details. (only available since the 5.0)","x-from-version":"SaaS","properties":{"attribute":{"type":"string"},"code":{"type":"string"},"labels":{"type":"object"}}}}}}}},"associations":{"type":"object","description":"Several associations related to groups, product and/or other product models, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the identifier of an existing product. • Each string in the array of the property `product_models` is the code of an existing product model.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of product identifiers with which the product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Several quantified associations related to products and/or product models, grouped by quantified association types (only available since the 5.0)","x-validation-rules":"• The `quantifiedAssociationTypeCode` is the code of an existing association type which provides quantity information. • Each object in the array of the property `products` contains the identifier of an existing product and the quantity of it. • Each object in the array of the property `product_models` contains the code of an existing product model and the quantity of it.","x-from-version":"5.0","properties":{"quantifiedAssociationTypeCode":{"type":"object","properties":{"products":{"type":"array","description":"Array of objects containing product identifiers and quantities with which the product model is in relation","items":{"type":"object","properties":{"identifier":{"type":"string"},"quantity":{"type":"integer"}}}},"product_models":{"type":"array","description":"Array of objects containing product model codes and quantities with which the product model is in relation","items":{"type":"object","properties":{"code":{"type":"string"},"quantity":{"type":"integer"}}}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"metadata":{"type":"object","description":"More information around the product model (only available since the v2.3 in the Enterprise Edition)","x-immutable":true,"x-read-only":true,"x-from-version":"2.3","properties":{"workflow_status":{"description":"Status of the product model regarding the user permissions","type":"string","enum":["read_only","draft_in_progress","proposal_waiting_for_approval","working_copy"]}}},"quality_scores":{"type":"object","description":"Product model quality scores for each channel/locale combination (only available since the 7.0 version and when the \"with_quality_scores\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"7.0"}},"example":{"code":"model-biker-jacket-leather","family":"clothing","family_variant":"clothing_material_size","parent":"model-biker-jacket","categories":["summer_collection"],"values":{"color":[{"locale":null,"scope":null,"data":"antique_white"}],"material":[{"locale":null,"scope":null,"data":"leather"}],"variation_name":[{"locale":"en_US","scope":null,"data":"Biker jacket leather"}],"name":[{"locale":"en_US","scope":null,"data":"Biker jacket"}],"collection":[{"locale":null,"scope":null,"data":["summer_2017"]}],"description":[{"locale":"en_US","scope":"ecommerce","data":"Biker jacket"}]},"associations":{"PACK":{"products":["sunglass"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"top","quantity":2},{"identifier":"cap","quantity":1}],"product_models":[{"code":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"created":"2017-10-02T15:03:55+02:00","updated":"2017-10-02T15:03:55+02:00"}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}}},"/api/rest/v1/published-products":{"get":{"summary":"Get list of published products","operationId":"get_published_products","description":"This endpoint allows you to get a list of published products. Published products are paginated and they can be filtered.","tags":["Published product"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"parameters":[{"name":"search","in":"query","description":"Filter published products, for more details see the Filters section","required":false,"type":"string"},{"name":"scope","in":"query","type":"string","description":"Filter published product values to return scopable attributes for the given channel as well as the non localizable/non scopable attributes, for more details see the Filter on published product values section","required":false},{"name":"locales","in":"query","type":"string","description":"Filter published product values to return localizable attributes for the given locales as well as the non localizable/non scopable attributes, for more details see the Filter on published product values section","required":false},{"name":"attributes","in":"query","type":"string","description":"Filter published product values to only return those concerning the given attributes, for more details see the Filter on product values section","required":false},{"name":"pagination_type","in":"query","description":"Pagination method type, see Pagination section","required":false,"type":"string","default":"page","x-validation-rules":"One of the following values","enum":["page","search_after"]},{"name":"page","in":"query","description":"Number of the page to retrieve when using the `page` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"integer","default":1},{"name":"search_after","in":"query","description":"Cursor when using the `search_after` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"string","default":"cursor to the first page"},{"name":"limit","in":"query","description":"Number of results by page, see Pagination section","required":false,"type":"integer","minimum":1,"maximum":100,"default":10},{"name":"with_count","in":"query","description":"Return the count of items in the response. Be carefull with that, on a big catalog, it can decrease performance in a significative way","default":false,"type":"boolean","required":false}],"responses":{"200":{"description":"Return published products paginated","schema":{"title":"Published products","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"previous":{"type":"object","properties":{"href":{"type":"string","description":"URI of the previous page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}},"current_page":{"type":"integer","description":"Current page number"}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["identifier"],"properties":{"identifier":{"type":"string","description":"Published product identifier, i.e. the value of the only `pim_catalog_identifier` attribute"},"enabled":{"type":"boolean","description":"Whether the published product is enable","default":true},"family":{"type":"string","description":"Family code from which the published product inherits its attributes and attributes requirements","x-validation-rules":"It is equal to an existing family code","default":"null"},"categories":{"type":"array","description":"Codes of the categories in which the published product is classified","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"groups":{"type":"array","description":"Codes of the groups to which the published product belong","x-validation-rules":"Each string of the array is equal to an existing group code","items":{"type":"string"},"default":[]},"values":{"type":"object","description":"Published product attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value"}}}}}},"associations":{"type":"object","description":"Several associations related to groups and/or other published products, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the identifier of an existing product. • Identifiers used in the array of the property `products` cannot be equal to the published product identifier.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the published product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of published product identifiers with which the published product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Warning: associations with quantities are not compatible with the published products. The response will always be empty."},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true}},"example":{"identifier":"top","enabled":true,"family":"tshirt","categories":["summer_collection"],"groups":[],"values":{"name":[{"data":"Top","locale":"en_US","scope":null},{"data":"Débardeur","locale":"fr_FR","scope":null}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce"},{"data":"Top","locale":"en_US","scope":"tablet"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black"}],"size":[{"locale":null,"scope":null,"data":"m"}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglass"],"product_models":[],"groups":[]}}}}]}}}}}}]},"examples":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/published-products?page=3&limit=3"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/published-products?page=1&limit=3"},"previous":{"href":"https://demo.akeneo.com/api/rest/v1/published-products?page=2&limit=3"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/published-products?page=4&limit=3"}},"current_page":3,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/published-products/top"}},"identifier":"top","family":"tshirt","groups":[],"categories":["summer_collection"],"enabled":true,"values":{"name":[{"data":"Top","locale":"en_US","scope":null},{"data":"Débardeur","locale":"fr_FR","scope":null}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce"},{"data":"Top","locale":"en_US","scope":"tablet"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black"}],"size":[{"locale":null,"scope":null,"data":"m"}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglasses"],"product_models":[],"groups":[]}}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/published-products/cap"}},"identifier":"cap","family":"caps","groups":[],"categories":["summer_collection"],"enabled":true,"values":{"name":[{"data":"Cap","locale":"en_US","scope":null},{"data":"Casquette","locale":"fr_FR","scope":null}],"description":[{"data":"Cap unisex","locale":"en_US","scope":"ecommerce"},{"data":"Cap unisex","locale":"en_US","scope":"tablet"},{"data":"Casquette unisexe","locale":"fr_FR","scope":"ecommerce"},{"data":"Casquette unisexe","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"20","currency":"EUR"},{"amount":"20","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black"}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglasses"],"product_models":[],"groups":[]}}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/published-products/sweat"}},"identifier":"sweat","family":null,"groups":[],"categories":["winter_collection"],"enabled":true,"values":{},"created":"2016-06-23T11:24:44+02:00","updated":"2016-06-23T11:24:44+02:00","associations":{}}]}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/published-products/{code}":{"get":{"summary":"Get a published product","operationId":"get_published_products__code_","tags":["Published product"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"description":"This endpoint allows you to get the information about a given published product.","parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the published product in JSON standard format","schema":{"type":"object","required":["identifier"],"properties":{"identifier":{"type":"string","description":"Published product identifier, i.e. the value of the only `pim_catalog_identifier` attribute"},"enabled":{"type":"boolean","description":"Whether the published product is enable","default":true},"family":{"type":"string","description":"Family code from which the published product inherits its attributes and attributes requirements","x-validation-rules":"It is equal to an existing family code","default":"null"},"categories":{"type":"array","description":"Codes of the categories in which the published product is classified","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"groups":{"type":"array","description":"Codes of the groups to which the published product belong","x-validation-rules":"Each string of the array is equal to an existing group code","items":{"type":"string"},"default":[]},"values":{"type":"object","description":"Published product attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value"}}}}}},"associations":{"type":"object","description":"Several associations related to groups and/or other published products, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the identifier of an existing product. • Identifiers used in the array of the property `products` cannot be equal to the published product identifier.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the published product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of published product identifiers with which the published product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Warning: associations with quantities are not compatible with the published products. The response will always be empty."},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true}},"example":{"identifier":"top","enabled":true,"family":"tshirt","categories":["summer_collection"],"groups":[],"values":{"name":[{"data":"Top","locale":"en_US","scope":null},{"data":"Débardeur","locale":"fr_FR","scope":null}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce"},{"data":"Top","locale":"en_US","scope":"tablet"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black"}],"size":[{"locale":null,"scope":null,"data":"m"}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglass"],"product_models":[],"groups":[]}}}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}}},"/api/rest/v1/media-files":{"get":{"summary":"Get a list of product media files","operationId":"get_media_files","description":"This endpoint allows you to get a list of media files that are used as attribute values in products or product models.","tags":["Product media file"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"page","in":"query","description":"Number of the page to retrieve when using the `page` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"integer","default":1},{"name":"limit","in":"query","description":"Number of results by page, see Pagination section","required":false,"type":"integer","minimum":1,"maximum":100,"default":10},{"name":"with_count","in":"query","description":"Return the count of items in the response. Be carefull with that, on a big catalog, it can decrease performance in a significative way","default":false,"type":"boolean","required":false}],"responses":{"200":{"description":"Return media files paginated","schema":{"title":"MediaFiles","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"previous":{"type":"object","properties":{"href":{"type":"string","description":"URI of the previous page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}},"current_page":{"type":"integer","description":"Current page number"}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI to get the metadata of the media file"}}},"download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the binaries of the media file"}}}}}}},{"type":"object","properties":{"code":{"type":"string","description":"Media file code","x-immutable":true},"original_filename":{"type":"string","description":"Original filename of the media file"},"mime_type":{"type":"string","description":"Mime type of the media file","x-read-only":true},"size":{"type":"integer","description":"Size of the media file","x-read-only":true},"extension":{"type":"string","description":"Extension of the media file","x-read-only":true}},"example":{"code":"7/5/8/e/758e39d48ea7b42a55091434fd3d8b6cf3189b7f_10806799_1356.jpg","original_filename":"10806799-1356.jpg","mime_type":"image/jpeg","size":16070,"extension":"jpg"}}]}}}}}}]},"examples":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/media-files?page=2&limit=4"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/media-files?page=1&limit=4"},"previous":{"href":"https://demo.akeneo.com/api/rest/v1/media-files?page=1&limit=4"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/media-files?page=2&limit=4"}},"current_page":2,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/media-files/7/5/8/e/758e39d48ea7b42a55091434fd3d8b6cf3189b7f_10806799_1356.jpg"},"download":{"href":"https://demo.akeneo.com/api/rest/v1/media-files/7/5/8/e/758e39d48ea7b42a55091434fd3d8b6cf3189b7f_10806799_1356.jpg/download"}},"code":"7/5/8/e/758e39d48ea7b42a55091434fd3d8b6cf3189b7f_10806799_1356.jpg","original_filename":"10806799-1356.jpg","mime_type":"image/jpeg","size":16070,"extension":"jpg"},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/media-files/d/0/3/2/d032a92d994df3ef67ee6746b7b7a795c2964e7c_10734346_1480.jpg"},"download":{"href":"https://demo.akeneo.com/api/rest/v1/media-files/d/0/3/2/d032a92d994df3ef67ee6746b7b7a795c2964e7c_10734346_1480.jpg/download"}},"code":"d/0/3/2/d032a92d994df3ef67ee6746b7b7a795c2964e7c_10734346_1480.jpg","original_filename":"10734346-1480.jpg","mime_type":"image/jpeg","size":16454,"extension":"jpg"},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/media-files/5/1/d/8/51d81dc778ba1501a8f998f3ab5797569f3b9e25_12431976_8797.jpg"},"download":{"href":"https://demo.akeneo.com/api/rest/v1/media-files/5/1/d/8/51d81dc778ba1501a8f998f3ab5797569f3b9e25_12431976_8797.jpg/download"}},"code":"5/1/d/8/51d81dc778ba1501a8f998f3ab5797569f3b9e25_12431976_8797.jpg","original_filename":"12431976-8797.jpg","mime_type":"image/jpeg","size":19725,"extension":"jpg"},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/media-files/0/c/b/0/0cb0c0e115dedba676f8d1ad8343e6207ab54c7b_107406_9841.jpg"},"download":{"href":"https://demo.akeneo.com/api/rest/v1/media-files/0/c/b/0/0cb0c0e115dedba676f8d1ad8343e6207ab54c7b_107406_9841.jpg/download"}},"code":"0/c/b/0/0cb0c0e115dedba676f8d1ad8343e6207ab54c7b_107406_9841.jpg","original_filename":"107406-9841.jpg","mime_type":"image/jpeg","size":17639,"extension":"jpg"}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"post":{"summary":"Create a new product media file","operationId":"post_media_files","description":"This endpoint allows you to create a new media file and associate it to an attribute value of a given product or product model.","tags":["Product media file"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"Content-type","in":"header","type":"string","description":"Equal to 'multipart/form-data', no other value allowed","required":true},{"name":"body","in":"body","x-form-data":true,"schema":{"required":["file"],"properties":{"product":{"type":"string","description":"The product to which the media file will be associated. It is a JSON string that follows this format '{\"identifier\":\"product_identifier\", \"attribute\":\"attribute_code\", \"scope\":\"channel_code\",\"locale\":\"locale_code\"}'. You have to either use this field or the `product_model` field, but not both at the same time."},"product_model":{"type":"string","description":"The product model to which the media file will be associated. It is a JSON string that follows this format '{\"code\":\"product_model_code\", \"attribute\":\"attribute_code\", \"scope\":\"channel_code\",\"locale\":\"locale_code\"}'. You have to either use this field or the `product` field, but not both at the same time."},"file":{"type":"string","description":"The binaries of the file","format":"binary"}}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `multipart/form-data`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘multipart/form-data’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/media-files/{code}":{"get":{"summary":"Get a product media file","operationId":"get_media_files__code_","description":"This endpoint allows you to get the information about a given media file that is used as an attribute value of a product or a product model.","tags":["Product media file"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the media file in JSON standard format","schema":{"allOf":[{"type":"object","properties":{"_links":{"type":"object","x-read-only":true,"properties":{"download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the binaries of the media file"}}}}}}},{"type":"object","properties":{"code":{"type":"string","description":"Media file code","x-immutable":true},"original_filename":{"type":"string","description":"Original filename of the media file"},"mime_type":{"type":"string","description":"Mime type of the media file","x-read-only":true},"size":{"type":"integer","description":"Size of the media file","x-read-only":true},"extension":{"type":"string","description":"Extension of the media file","x-read-only":true}},"example":{"code":"7/5/8/e/758e39d48ea7b42a55091434fd3d8b6cf3189b7f_10806799_1356.jpg","original_filename":"10806799-1356.jpg","mime_type":"image/jpeg","size":16070,"extension":"jpg"}}],"example":{"_links":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/media-files/7/5/8/e/758e39d48ea7b42a55091434fd3d8b6cf3189b7f_10806799_1356.jpg/download"}},"code":"7/5/8/e/758e39d48ea7b42a55091434fd3d8b6cf3189b7f_10806799_1356.jpg","original_filename":"10806799-1356.jpg","mime_type":"image/jpeg","size":16070,"extension":"jpg"}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}}},"/api/rest/v1/media-files/{code}/download":{"get":{"summary":"Download a product media file","operationId":"get_media_files__code__download","description":"This endpoint allows you to download a given media file that is used as an attribute value of a product or a product model.","x-content-type":"Mime-type of the media file","tags":["Product media file"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the binary of the media file","x-content-type":"Mime-type of the media file"},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}}}}},"/api/rest/v1/families":{"get":{"summary":"Get list of families","operationId":"get_families","description":"This endpoint allows you to get a list of families. Families are paginated and sorted by code.","tags":["Family"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"search","in":"query","description":"Filter families, for more details see the Filters section.","required":false,"type":"string"},{"name":"page","in":"query","description":"Number of the page to retrieve when using the `page` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"integer","default":1},{"name":"limit","in":"query","description":"Number of results by page, see Pagination section","required":false,"type":"integer","minimum":1,"maximum":100,"default":10},{"name":"with_count","in":"query","description":"Return the count of items in the response. Be carefull with that, on a big catalog, it can decrease performance in a significative way","default":false,"type":"boolean","required":false}],"responses":{"200":{"description":"Return families paginated","schema":{"title":"Families","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"previous":{"type":"object","properties":{"href":{"type":"string","description":"URI of the previous page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}},"current_page":{"type":"integer","description":"Current page number"}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code","attribute_as_label"],"properties":{"code":{"type":"string","description":"Family code","x-immutable":true},"attribute_as_label":{"type":"string","description":"Attribute code used as label","x-validation-rules":"• It is equal to an existing attribute code • This attribute code is in the array of the property `attributes` • The type of this attribute is either `pim_catalog_identifier` or `pim_catalog_text`"},"attribute_as_image":{"type":"string","description":"Attribute code used as the main picture in the user interface (only since v2.0)","x-validation-rules":"• It is equal to an existing attribute code • This attribute code is in the array of the property `attributes` • The type of this attribute is `pim_catalog_image`. Since v2.1, you can also use a `pim_assets_collection` attribute type","default":"null","x-from-version":"2.0"},"attributes":{"type":"array","description":"Attributes codes that compose the family","x-validation-rules":"Each string of the array is an existing attribute code","items":{"type":"string"},"default":[]},"attribute_requirements":{"type":"object","description":"Attributes codes of the family that are required for the completeness calculation for each channel","x-validation-rules":"• Each string of these arrays is an existing attribute code • These attribute codes are in the array of the property `attributes` • The `channelCode` is the code of an existing and activated channel","properties":{"channelCode":{"type":"array","items":{"type":"string","description":"Attributes codes of the family that are required for the completeness calculation for the channel `channelCode`"}}}},"labels":{"type":"object","description":"Family labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Family label for the locale `localeCode`"}}}},"example":{"code":"caps","attributes":["sku","name","description","price","color","picture"],"attribute_as_label":"name","attribute_as_image":"picture","attribute_requirements":{"ecommerce":["sku","name","description","price","color"],"tablet":["sku","name","description","price"]},"labels":{"en_US":"Caps","fr_FR":"Casquettes"}}}]}}}}}}]},"examples":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/families?page=2&limit=2"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/families?page=1&limit=2"},"previous":{"href":"https://demo.akeneo.com/api/rest/v1/families?page=1&limit=2"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/families?page=3&limit=2"}},"current_page":2,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/families/tshirt"}},"code":"tshirt","attributes":["sku","name","description","price","size","color","picture"],"attribute_as_label":"name","attribute_as_image":"picture","attribute_requirements":{"ecommerce":["sku","name","description","price","size","color"],"tablet":["sku","name","description","price"]},"labels":{"en_US":"Tshirt","fr_FR":"Tshirt"}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/families/caps"}},"code":"caps","attributes":["sku","name","description","price","color","picture"],"attribute_as_label":"name","attribute_as_image":"picture","attribute_requirements":{"ecommerce":["sku","name","description","price","color"],"tablet":["sku","name","description","price"]},"labels":{"en_US":"Caps","fr_FR":"Casquettes"}}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"post":{"summary":"Create a new family","operationId":"post_families","description":"This endpoint allows you to create a new family.","tags":["Family"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","required":["code","attribute_as_label"],"properties":{"code":{"type":"string","description":"Family code","x-immutable":true},"attribute_as_label":{"type":"string","description":"Attribute code used as label","x-validation-rules":"• It is equal to an existing attribute code • This attribute code is in the array of the property `attributes` • The type of this attribute is either `pim_catalog_identifier` or `pim_catalog_text`"},"attribute_as_image":{"type":"string","description":"Attribute code used as the main picture in the user interface (only since v2.0)","x-validation-rules":"• It is equal to an existing attribute code • This attribute code is in the array of the property `attributes` • The type of this attribute is `pim_catalog_image`. Since v2.1, you can also use a `pim_assets_collection` attribute type","default":"null","x-from-version":"2.0"},"attributes":{"type":"array","description":"Attributes codes that compose the family","x-validation-rules":"Each string of the array is an existing attribute code","items":{"type":"string"},"default":[]},"attribute_requirements":{"type":"object","description":"Attributes codes of the family that are required for the completeness calculation for each channel","x-validation-rules":"• Each string of these arrays is an existing attribute code • These attribute codes are in the array of the property `attributes` • The `channelCode` is the code of an existing and activated channel","properties":{"channelCode":{"type":"array","items":{"type":"string","description":"Attributes codes of the family that are required for the completeness calculation for the channel `channelCode`"}}}},"labels":{"type":"object","description":"Family labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Family label for the locale `localeCode`"}}}},"example":{"code":"caps","attributes":["sku","name","description","price","color","picture"],"attribute_as_label":"name","attribute_as_image":"picture","attribute_requirements":{"ecommerce":["sku","name","description","price","color"],"tablet":["sku","name","description","price"]},"labels":{"en_US":"Caps","fr_FR":"Casquettes"}}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}},"patch":{"summary":"Update/create several families","operationId":"patch_families","tags":["Family"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to update and/or create several families at once.","x-body-by-line":"Contains several lines, each line is a family in JSON standard format","parameters":[{"name":"body","in":"body","schema":{"x-examples":{"x-example-1":"{\"code\":\"tshirt\",\"attributes\":[\"description\",\"size\"]}","x-example-2":"{\"code\":\"cap\",\"attribute_as_label\":\"descripion\"}","x-example-3":"{\"code\":\"mug\",\"attributes\":[\"description\",\"short_description\"]}"},"type":"object","required":["code","attribute_as_label"],"properties":{"code":{"type":"string","description":"Family code","x-immutable":true},"attribute_as_label":{"type":"string","description":"Attribute code used as label","x-validation-rules":"• It is equal to an existing attribute code • This attribute code is in the array of the property `attributes` • The type of this attribute is either `pim_catalog_identifier` or `pim_catalog_text`"},"attribute_as_image":{"type":"string","description":"Attribute code used as the main picture in the user interface (only since v2.0)","x-validation-rules":"• It is equal to an existing attribute code • This attribute code is in the array of the property `attributes` • The type of this attribute is `pim_catalog_image`. Since v2.1, you can also use a `pim_assets_collection` attribute type","default":"null","x-from-version":"2.0"},"attributes":{"type":"array","description":"Attributes codes that compose the family","x-validation-rules":"Each string of the array is an existing attribute code","items":{"type":"string"},"default":[]},"attribute_requirements":{"type":"object","description":"Attributes codes of the family that are required for the completeness calculation for each channel","x-validation-rules":"• Each string of these arrays is an existing attribute code • These attribute codes are in the array of the property `attributes` • The `channelCode` is the code of an existing and activated channel","properties":{"channelCode":{"type":"array","items":{"type":"string","description":"Attributes codes of the family that are required for the completeness calculation for the channel `channelCode`"}}}},"labels":{"type":"object","description":"Family labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Family label for the locale `localeCode`"}}}},"example":{"code":"caps","attributes":["sku","name","description","price","color","picture"],"attribute_as_label":"name","attribute_as_image":"picture","attribute_requirements":{"ecommerce":["sku","name","description","price","color"],"tablet":["sku","name","description","price"]},"labels":{"en_US":"Caps","fr_FR":"Casquettes"}}}}],"responses":{"200":{"description":"OK","x-details":"Returns a plain text response whose lines are JSON containing the status of each update or creation","x-no-entity":true,"schema":{"type":"object","properties":{"line":{"type":"integer","description":"Line number"},"identifier":{"type":"string","description":"Resource identifier, only filled when the resource is a product"},"code":{"type":"string","description":"Resource code, only filled when the resource is not a product"},"status_code":{"type":"integer","description":"HTTP status code, see Client errors to understand the meaning of each code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"x-example-1":"{\"line\":1,\"code\":\"tshirt\",\"status_code\":201}","x-example-2":"{\"line\":2,\"code\":\"cap\",\"status_code\":422,\"message\":\"Attribute \\\"descripion\\\" does not exist.\"}","x-example-3":"{\"line\":3,\"code\":\"mug\",\"status_code\":204}"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"413":{"description":"Request Entity Too Large","x-details":"There are too many resources to process (max 100) or the line of JSON is too long (max 1 000 000 characters)","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":413,"message":"Too many resources to process, 100 is the maximum allowed."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/vnd.akeneo.collection+json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/vnd.akeneo.collection+json’ is allowed."}}}}},"/api/rest/v1/families/{code}":{"get":{"summary":"Get a family","operationId":"get_families__code_","description":"This endpoint allows you to get the information about a given family.","tags":["Family"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the family in JSON standard format","schema":{"type":"object","required":["code","attribute_as_label"],"properties":{"code":{"type":"string","description":"Family code","x-immutable":true},"attribute_as_label":{"type":"string","description":"Attribute code used as label","x-validation-rules":"• It is equal to an existing attribute code • This attribute code is in the array of the property `attributes` • The type of this attribute is either `pim_catalog_identifier` or `pim_catalog_text`"},"attribute_as_image":{"type":"string","description":"Attribute code used as the main picture in the user interface (only since v2.0)","x-validation-rules":"• It is equal to an existing attribute code • This attribute code is in the array of the property `attributes` • The type of this attribute is `pim_catalog_image`. Since v2.1, you can also use a `pim_assets_collection` attribute type","default":"null","x-from-version":"2.0"},"attributes":{"type":"array","description":"Attributes codes that compose the family","x-validation-rules":"Each string of the array is an existing attribute code","items":{"type":"string"},"default":[]},"attribute_requirements":{"type":"object","description":"Attributes codes of the family that are required for the completeness calculation for each channel","x-validation-rules":"• Each string of these arrays is an existing attribute code • These attribute codes are in the array of the property `attributes` • The `channelCode` is the code of an existing and activated channel","properties":{"channelCode":{"type":"array","items":{"type":"string","description":"Attributes codes of the family that are required for the completeness calculation for the channel `channelCode`"}}}},"labels":{"type":"object","description":"Family labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Family label for the locale `localeCode`"}}}},"example":{"code":"caps","attributes":["sku","name","description","price","color","picture"],"attribute_as_label":"name","attribute_as_image":"picture","attribute_requirements":{"ecommerce":["sku","name","description","price","color"],"tablet":["sku","name","description","price"]},"labels":{"en_US":"Caps","fr_FR":"Casquettes"}}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"patch":{"summary":"Update/create a family","operationId":"patch_families__code_","tags":["Family"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to update a given family. Know more about Update behavior. Note that if no family exists for the given code, it creates it.","parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"},{"name":"body","in":"body","required":true,"schema":{"type":"object","required":["code","attribute_as_label"],"properties":{"code":{"type":"string","description":"Family code","x-immutable":true},"attribute_as_label":{"type":"string","description":"Attribute code used as label","x-validation-rules":"• It is equal to an existing attribute code • This attribute code is in the array of the property `attributes` • The type of this attribute is either `pim_catalog_identifier` or `pim_catalog_text`"},"attribute_as_image":{"type":"string","description":"Attribute code used as the main picture in the user interface (only since v2.0)","x-validation-rules":"• It is equal to an existing attribute code • This attribute code is in the array of the property `attributes` • The type of this attribute is `pim_catalog_image`. Since v2.1, you can also use a `pim_assets_collection` attribute type","default":"null","x-from-version":"2.0"},"attributes":{"type":"array","description":"Attributes codes that compose the family","x-validation-rules":"Each string of the array is an existing attribute code","items":{"type":"string"},"default":[]},"attribute_requirements":{"type":"object","description":"Attributes codes of the family that are required for the completeness calculation for each channel","x-validation-rules":"• Each string of these arrays is an existing attribute code • These attribute codes are in the array of the property `attributes` • The `channelCode` is the code of an existing and activated channel","properties":{"channelCode":{"type":"array","items":{"type":"string","description":"Attributes codes of the family that are required for the completeness calculation for the channel `channelCode`"}}}},"labels":{"type":"object","description":"Family labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Family label for the locale `localeCode`"}}}},"example":{"code":"caps","attributes":["sku","name","description","price","color","picture"],"attribute_as_label":"name","attribute_as_image":"picture","attribute_requirements":{"ecommerce":["sku","name","description","price","color"],"tablet":["sku","name","description","price"]},"labels":{"en_US":"Caps","fr_FR":"Casquettes"}}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"204":{"description":"No content to return","x-details":"Means that the update was successful","headers":{"Location":{"description":"URI of the updated resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/families/{family_code}/variants":{"get":{"summary":"Get list of family variants","operationId":"get_families__family_code__variants","description":"This endpoint allows you to get a list of family variants. Family variants are paginated and sorted by code.","tags":["Family variant"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"family_code","in":"path","description":"Code of the family","required":true,"type":"string"},{"name":"page","in":"query","description":"Number of the page to retrieve when using the `page` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"integer","default":1},{"name":"limit","in":"query","description":"Number of results by page, see Pagination section","required":false,"type":"integer","minimum":1,"maximum":100,"default":10},{"name":"with_count","in":"query","description":"Return the count of items in the response. Be carefull with that, on a big catalog, it can decrease performance in a significative way","default":false,"type":"boolean","required":false}],"responses":{"200":{"description":"Return family variants paginated","schema":{"title":"Family Variants","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"previous":{"type":"object","properties":{"href":{"type":"string","description":"URI of the previous page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}},"current_page":{"type":"integer","description":"Current page number"}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code","variant_attribute_sets"],"properties":{"code":{"type":"string","description":"Family variant code","x-immutable":true},"variant_attribute_sets":{"type":"array","description":"Attributes distribution according to the enrichment level","items":{"type":"object","required":["level","axes"],"description":"Enrichment level","properties":{"level":{"type":"integer","description":"Enrichment level","x-immutable":true,"x-validation-rules":"• Number representing the level of the attribute set. • It should be equal to 1 or 2. • If you specify the level 2, you have to specify the level 1 as well."},"axes":{"type":"array","description":"Codes of attributes used as variant axes","x-immutable":true,"items":{"type":"string"},"default":[],"x-validation-rules":"• Should be an array of maximum 5 existing attribute codes • These attributes should belong to the family of the family variant • Only the following attribute types are allowed: `simple select`, `multi select`, `reference data`, `metric`, `boolean` • Attributes cannot be scopable, nor localizable nor locale specific • Attributes used as axes in one level cannot be used as axes or as attributes in the other level"},"attributes":{"type":"array","description":"Codes of attributes bind to this enrichment level","items":{"type":"string"},"default":[],"x-validation-rules":"• Should be an array of existing attribute codes • These attributes should belong to the family of the family variant • Attributes used as attribute in one level cannot be used as axes or as attributes in the other level • Attributes that are `unique value` or `identifier` are automatically distributed to the lower level."}}}},"labels":{"type":"object","description":"Family variant labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Family variant label for the locale `localeCode`"}}}},"example":{"code":"shoesVariant","labels":{"en_US":"Shoes variant","fr_FR":"Variante de chaussures"},"variant_attribute_sets":[{"level":1,"attributes":["color","material"],"axes":["color"]},{"level":2,"attributes":["sku","size"],"axes":["size"]}]}}]}}}}}}]},"examples":{"code":"shoesVariant","labels":{"en_US":"Shoes variant","fr_FR":"Variante de chaussures"},"variant_attribute_sets":[{"level":1,"attributes":["color","material"],"axes":["color"]},{"level":2,"attributes":["sku","size"],"axes":["size"]}]}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"post":{"summary":"Create a new family variant","operationId":"post_families__family_code__variants","tags":["Family"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to create a family variant.","parameters":[{"name":"family_code","in":"path","description":"Code of the family","required":true,"type":"string"},{"name":"body","in":"body","schema":{"type":"object","required":["code","variant_attribute_sets"],"properties":{"code":{"type":"string","description":"Family variant code","x-immutable":true},"variant_attribute_sets":{"type":"array","description":"Attributes distribution according to the enrichment level","items":{"type":"object","required":["level","axes"],"description":"Enrichment level","properties":{"level":{"type":"integer","description":"Enrichment level","x-immutable":true,"x-validation-rules":"• Number representing the level of the attribute set. • It should be equal to 1 or 2. • If you specify the level 2, you have to specify the level 1 as well."},"axes":{"type":"array","description":"Codes of attributes used as variant axes","x-immutable":true,"items":{"type":"string"},"default":[],"x-validation-rules":"• Should be an array of maximum 5 existing attribute codes • These attributes should belong to the family of the family variant • Only the following attribute types are allowed: `simple select`, `multi select`, `reference data`, `metric`, `boolean` • Attributes cannot be scopable, nor localizable nor locale specific • Attributes used as axes in one level cannot be used as axes or as attributes in the other level"},"attributes":{"type":"array","description":"Codes of attributes bind to this enrichment level","items":{"type":"string"},"default":[],"x-validation-rules":"• Should be an array of existing attribute codes • These attributes should belong to the family of the family variant • Attributes used as attribute in one level cannot be used as axes or as attributes in the other level • Attributes that are `unique value` or `identifier` are automatically distributed to the lower level."}}}},"labels":{"type":"object","description":"Family variant labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Family variant label for the locale `localeCode`"}}}},"example":{"code":"shoesVariant","labels":{"en_US":"Shoes variant","fr_FR":"Variante de chaussures"},"variant_attribute_sets":[{"level":1,"attributes":["color","material"],"axes":["color"]},{"level":2,"attributes":["sku","size"],"axes":["size"]}]}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}},"patch":{"summary":"Update/create several family variants","operationId":"patch_families__family_code__variants","tags":["Family variant"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to update and/or create several family variants at once, for a given family.","x-body-by-line":"Contains several lines, each line is a family in JSON standard format","parameters":[{"name":"family_code","in":"path","description":"Code of the family","required":true,"type":"string"},{"name":"body","in":"body","schema":{"x-examples":{"x-example-1":"{\"code\": \"shoes_by_size\", \"variant_attribute_sets\": [{\"level\": 1, \"axes\": [\"size\"], \"attributes\": [\"color\"]}]}","x-example-2":"{\"code\": \"shoes_by_color\",\"labels\": {\"en_US\": \"Shoes by color\"}}","x-example-3":"{\"code\": \"shoes_without_axes\", \"variant_attribute_sets\": [{\"level\": 1, \"axes\": [], \"attributes\": [\"color\"]}]}"},"type":"object","required":["code","variant_attribute_sets"],"properties":{"code":{"type":"string","description":"Family variant code","x-immutable":true},"variant_attribute_sets":{"type":"array","description":"Attributes distribution according to the enrichment level","items":{"type":"object","required":["level","axes"],"description":"Enrichment level","properties":{"level":{"type":"integer","description":"Enrichment level","x-immutable":true,"x-validation-rules":"• Number representing the level of the attribute set. • It should be equal to 1 or 2. • If you specify the level 2, you have to specify the level 1 as well."},"axes":{"type":"array","description":"Codes of attributes used as variant axes","x-immutable":true,"items":{"type":"string"},"default":[],"x-validation-rules":"• Should be an array of maximum 5 existing attribute codes • These attributes should belong to the family of the family variant • Only the following attribute types are allowed: `simple select`, `multi select`, `reference data`, `metric`, `boolean` • Attributes cannot be scopable, nor localizable nor locale specific • Attributes used as axes in one level cannot be used as axes or as attributes in the other level"},"attributes":{"type":"array","description":"Codes of attributes bind to this enrichment level","items":{"type":"string"},"default":[],"x-validation-rules":"• Should be an array of existing attribute codes • These attributes should belong to the family of the family variant • Attributes used as attribute in one level cannot be used as axes or as attributes in the other level • Attributes that are `unique value` or `identifier` are automatically distributed to the lower level."}}}},"labels":{"type":"object","description":"Family variant labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Family variant label for the locale `localeCode`"}}}},"example":{"code":"shoesVariant","labels":{"en_US":"Shoes variant","fr_FR":"Variante de chaussures"},"variant_attribute_sets":[{"level":1,"attributes":["color","material"],"axes":["color"]},{"level":2,"attributes":["sku","size"],"axes":["size"]}]}}}],"responses":{"200":{"description":"OK","x-details":"Returns a plain text response whose lines are JSON containing the status of each update or creation","x-no-entity":true,"schema":{"type":"object","properties":{"line":{"type":"integer","description":"Line number"},"identifier":{"type":"string","description":"Resource identifier, only filled when the resource is a product"},"code":{"type":"string","description":"Resource code, only filled when the resource is not a product"},"status_code":{"type":"integer","description":"HTTP status code, see Client errors to understand the meaning of each code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"x-example-1":"{\"line\":1,\"code\":\"shoes_by_size\",\"status_code\":201}","x-example-2":"{\"line\":2,\"code\":\"shoes_by_color\",\"status_code\":204}","x-example-3":"{\"line\":3,\"code\":\"mug\",\"status_code\":422, \"message\":\"There should be at least one attribute defined as axis for the attribute set for level \\\"1\\\"\"}"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"413":{"description":"Request Entity Too Large","x-details":"There are too many resources to process (max 100) or the line of JSON is too long (max 1 000 000 characters)","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":413,"message":"Too many resources to process, 100 is the maximum allowed."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/vnd.akeneo.collection+json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/vnd.akeneo.collection+json’ is allowed."}}}}},"/api/rest/v1/families/{family_code}/variants/{code}":{"get":{"summary":"Get a family variant","operationId":"get_families__family_code__variants__code__","description":"This endpoint allows you to get the information about a given family variant.","tags":["Family variant"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"family_code","in":"path","description":"Code of the family","required":true,"type":"string"},{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the family variant in JSON standard format","schema":{"type":"object","required":["code","variant_attribute_sets"],"properties":{"code":{"type":"string","description":"Family variant code","x-immutable":true},"variant_attribute_sets":{"type":"array","description":"Attributes distribution according to the enrichment level","items":{"type":"object","required":["level","axes"],"description":"Enrichment level","properties":{"level":{"type":"integer","description":"Enrichment level","x-immutable":true,"x-validation-rules":"• Number representing the level of the attribute set. • It should be equal to 1 or 2. • If you specify the level 2, you have to specify the level 1 as well."},"axes":{"type":"array","description":"Codes of attributes used as variant axes","x-immutable":true,"items":{"type":"string"},"default":[],"x-validation-rules":"• Should be an array of maximum 5 existing attribute codes • These attributes should belong to the family of the family variant • Only the following attribute types are allowed: `simple select`, `multi select`, `reference data`, `metric`, `boolean` • Attributes cannot be scopable, nor localizable nor locale specific • Attributes used as axes in one level cannot be used as axes or as attributes in the other level"},"attributes":{"type":"array","description":"Codes of attributes bind to this enrichment level","items":{"type":"string"},"default":[],"x-validation-rules":"• Should be an array of existing attribute codes • These attributes should belong to the family of the family variant • Attributes used as attribute in one level cannot be used as axes or as attributes in the other level • Attributes that are `unique value` or `identifier` are automatically distributed to the lower level."}}}},"labels":{"type":"object","description":"Family variant labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Family variant label for the locale `localeCode`"}}}},"example":{"code":"shoesVariant","labels":{"en_US":"Shoes variant","fr_FR":"Variante de chaussures"},"variant_attribute_sets":[{"level":1,"attributes":["color","material"],"axes":["color"]},{"level":2,"attributes":["sku","size"],"axes":["size"]}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"patch":{"summary":"Update/create a family variant","operationId":"patch_families__family_code__variants__code__","tags":["Family variant"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to update a given family variant. Know more about Update behavior. Note that if no family variant exists for the given code, it creates it.","parameters":[{"name":"family_code","in":"path","description":"Code of the family","required":true,"type":"string"},{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"},{"name":"body","in":"body","required":true,"schema":{"type":"object","required":["code","variant_attribute_sets"],"properties":{"code":{"type":"string","description":"Family variant code","x-immutable":true},"variant_attribute_sets":{"type":"array","description":"Attributes distribution according to the enrichment level","items":{"type":"object","required":["level","axes"],"description":"Enrichment level","properties":{"level":{"type":"integer","description":"Enrichment level","x-immutable":true,"x-validation-rules":"• Number representing the level of the attribute set. • It should be equal to 1 or 2. • If you specify the level 2, you have to specify the level 1 as well."},"axes":{"type":"array","description":"Codes of attributes used as variant axes","x-immutable":true,"items":{"type":"string"},"default":[],"x-validation-rules":"• Should be an array of maximum 5 existing attribute codes • These attributes should belong to the family of the family variant • Only the following attribute types are allowed: `simple select`, `multi select`, `reference data`, `metric`, `boolean` • Attributes cannot be scopable, nor localizable nor locale specific • Attributes used as axes in one level cannot be used as axes or as attributes in the other level"},"attributes":{"type":"array","description":"Codes of attributes bind to this enrichment level","items":{"type":"string"},"default":[],"x-validation-rules":"• Should be an array of existing attribute codes • These attributes should belong to the family of the family variant • Attributes used as attribute in one level cannot be used as axes or as attributes in the other level • Attributes that are `unique value` or `identifier` are automatically distributed to the lower level."}}}},"labels":{"type":"object","description":"Family variant labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Family variant label for the locale `localeCode`"}}}},"example":{"code":"shoesVariant","labels":{"en_US":"Shoes variant","fr_FR":"Variante de chaussures"},"variant_attribute_sets":[{"level":1,"attributes":["color","material"],"axes":["color"]},{"level":2,"attributes":["sku","size"],"axes":["size"]}]}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"204":{"description":"No content to return","x-details":"Means that the update was successful","headers":{"Location":{"description":"URI of the updated resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/attributes":{"get":{"summary":"Get list of attributes","operationId":"get_attributes","description":"This endpoint allows you to get a list of attributes. Attributes are paginated and sorted by code.","tags":["Attribute"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"search","in":"query","description":"Filter attributes, for more details see the Filters section.","required":false,"type":"string"},{"name":"page","in":"query","description":"Number of the page to retrieve when using the `page` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"integer","default":1},{"name":"limit","in":"query","description":"Number of results by page, see Pagination section","required":false,"type":"integer","minimum":1,"maximum":100,"default":10},{"name":"with_count","in":"query","description":"Return the count of items in the response. Be carefull with that, on a big catalog, it can decrease performance in a significative way","default":false,"type":"boolean","required":false},{"name":"with_table_select_options","in":"query","description":"Return the options of 'select' column types (of a table attribute) in the response. (Only available since the 7.0 version)","default":false,"type":"boolean","required":false,"x-from-version":"7.0"}],"responses":{"200":{"description":"Return attributes paginated","schema":{"title":"Attributes","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"previous":{"type":"object","properties":{"href":{"type":"string","description":"URI of the previous page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}},"current_page":{"type":"integer","description":"Current page number"}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code","type","group"],"properties":{"code":{"type":"string","description":"Attribute code","x-immutable":true},"type":{"type":"string","description":"Attribute type. See type section for more details.","x-validation-rules":"The type is one of the following values","enum":["pim_catalog_identifier","pim_catalog_metric","pim_catalog_number","pim_catalog_reference_data_multi_select","pim_catalog_reference_data_simple_select","pim_catalog_simpleselect","pim_catalog_multiselect","pim_catalog_date","pim_catalog_textarea","pim_catalog_text","pim_catalog_file","pim_catalog_image","pim_catalog_price_collection","pim_catalog_boolean","akeneo_reference_entity","akeneo_reference_entity_collection","pim_catalog_asset_collection"],"x-immutable":true},"labels":{"type":"object","description":"Attribute labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute label for the locale `localeCode`"}}},"group":{"type":"string","description":"Attribute group","x-validation-rules":"It is the code of an existing group"},"group_labels":{"type":"object","description":"Group labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","x-read-only":true,"default":{},"properties":{"localeCode":{"type":"string","description":"Group label for the locale `localeCode`"}}},"sort_order":{"type":"integer","description":"Order of the attribute in its group","x-validation-rules":"It is a positive integer","default":0},"localizable":{"type":"boolean","description":"Whether the attribute is localizable, i.e. can have one value by locale","default":false,"x-immutable":true},"scopable":{"type":"boolean","description":"Whether the attribute is scopable, i.e. can have one value by channel","default":false,"x-immutable":true},"available_locales":{"type":"array","description":"To make the attribute locale specfic, specify here for which locales it is specific","x-validation-rules":"Each string of the array is an existing and activated locale","items":{"type":"string"}},"unique":{"type":"boolean","description":"Whether two values for the attribute cannot be the same","x-immutable":true},"useable_as_grid_filter":{"type":"boolean","description":"Whether the attribute can be used as a filter for the product grid in the PIM user interface"},"max_characters":{"type":"integer","description":"Number maximum of characters allowed for the value of the attribute when the attribute type is `pim_catalog_text`, `pim_catalog_textarea` or `pim_catalog_identifier`","x-warning":"Only for `pim_catalog_text`, `pim_catalog_textarea` or `pim_catalog_identifier` attribute types"},"validation_rule":{"type":"string","description":"Validation rule type used to validate any attribute value when the attribute type is `pim_catalog_text` or `pim_catalog_identifier`","x-validation-rules":"Equal to `regexp` when the attribute type is equal to `pim_catalog_identifier`","x-warning":"Only for `pim_catalog_text` or `pim_catalog_identifier` attribute types"},"validation_regexp":{"type":"string","description":"Regexp expression used to validate any attribute value when the attribute type is `pim_catalog_text` or `pim_catalog_identifier`","x-validation-rules":"Required when the property `validation_rule` is equal to `regexp`","x-warning":"Only for `pim_catalog_text` or `pim_catalog_identifier` attribute types"},"wysiwyg_enabled":{"type":"boolean","description":"Whether the WYSIWYG interface is shown when the attribute type is `pim_catalog_textarea`","x-warning":"Only for `pim_catalog_textarea` attribute type"},"number_min":{"type":"string","description":"Minimum integer value allowed when the attribute type is `pim_catalog_metric`, `pim_catalog_price` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric`, `pim_catalog_price_collection` or `pim_catalog_number` attribute types"},"number_max":{"type":"string","description":"Maximum integer value allowed when the attribute type is `pim_catalog_metric`, `pim_catalog_price` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric`, `pim_catalog_price_collection` or `pim_catalog_number` attribute types"},"decimals_allowed":{"type":"boolean","description":"Whether decimals are allowed when the attribute type is `pim_catalog_metric`, `pim_catalog_price` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric`, `pim_catalog_price_collection` or `pim_catalog_number` attribute types"},"negative_allowed":{"type":"boolean","description":"Whether negative values are allowed when the attribute type is `pim_catalog_metric` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric` or `pim_catalog_number` attribute types"},"metric_family":{"type":"string","description":"Metric family when the attribute type is `pim_catalog_metric`","x-immutable":true,"x-validation-rules":"Required for `pim_catalog_metric` attribute type","x-warning":"Only for `pim_catalog_metric` attribute type"},"default_metric_unit":{"type":"string","description":"Default metric unit when the attribute type is `pim_catalog_metric`","x-validation-rules":"Required for `pim_catalog_metric` attribute type","x-warning":"Only for `pim_catalog_metric` attribute type"},"date_min":{"type":"string","description":"Minimum date allowed when the attribute type is `pim_catalog_date`","x-validation-rules":"The datetime format follows the ISO-8601 norm","x-warning":"Only for `pim_catalog_date` attribute type","format":"date-time"},"date_max":{"type":"string","description":"Maximum date allowed when the attribute type is `pim_catalog_date`","x-validation-rules":"The datetime format follows the ISO-8601 norm","x-warning":"Only for `pim_catalog_date` attribute type","format":"date-time"},"allowed_extensions":{"type":"array","description":"Extensions allowed when the attribute type is `pim_catalog_file` or `pim_catalog_image`","x-warning":"Only for `pim_catalog_file` or `pim_catalog_image` attribute types","items":{"type":"string"}},"max_file_size":{"type":"string","description":"Max file size in MB when the attribute type is `pim_catalog_file` or `pim_catalog_image`","x-warning":"Only for `pim_catalog_file` or `pim_catalog_image` attribute types"},"reference_data_name":{"type":"string","description":"Reference entity code when the attribute type is `akeneo_reference_entity` or `akeneo_reference_entity_collection` OR Asset family code when the attribute type is `pim_catalog_asset_collection`","x-validation-rules":"Required only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types","x-warning":"Only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types"},"default_value":{"type":"boolean","description":"Default value for a Yes/No attribute, applied when creating a new product or product model (only available since the 5.0)","x-warning":"Only for `pim_catalog_boolean` attribute type","x-from-version":"5.0"},"table_configuration":{"type":"array","description":"Configuration of the Table attribute (columns)","x-validation-rules":"Required only for `pim_catalog_table` attribute type","x-warning":"Only for `pim_catalog_table` attribute type","items":{"type":"object","required":["code","data_type"],"properties":{"code":{"type":"string","description":"Column code"},"data_type":{"type":"string","enum":["select","text","number","boolean"],"description":"Column data type"},"validations":{"type":"object","description":"User defined validation constraints on the cell content","default":{},"properties":{"min":{"type":"number","description":"minimum value of a numeric cell","x-validation-rules":"only for `number` data type columns"},"max":{"type":"number","description":"maximum value of a numeric cell","x-validation-rules":"only for `number` data type columns"},"decimals_allowed":{"type":"boolean","description":"whether the value of a numeric cell can hold a decimal part","x-validation-rules":"only for `number` data type columns"},"max_length":{"type":"number","description":"maximum length of a text cell","x-validation-rules":"only for `text` data type columns"}}},"labels":{"type":"object","description":"Column labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Column label for the locale `localeCode`"}}},"is_required_for_completeness":{"type":"boolean","description":"Defines if the column should be entirely filled for the attribute to be considered complete","x-warning":"This value is always true for the first column in a table configuration","default":false}}}},"is_main_identifier":{"type":"boolean","description":"Is this attribute main identifier when attribute type is `pim_catalog_identifier`"}},"example":{"code":"release_date","type":"pim_catalog_date","group":"marketing","group_labels":{"en_US":"Marketing","fr_FR":"Marketing"},"unique":false,"useable_as_grid_filter":true,"allowed_extensions":[],"metric_family":null,"default_metric_unit":null,"reference_data_name":null,"available_locales":[],"max_characters":null,"validation_rule":null,"validation_regexp":null,"wysiwyg_enabled":null,"number_min":null,"number_max":null,"decimals_allowed":null,"negative_allowed":null,"date_min":"2017-06-28T08:00:00","date_max":"2017-08-08T22:00:00","max_file_size":null,"minimum_input_length":null,"sort_order":1,"localizable":false,"scopable":false,"default_value":null,"labels":{"en_US":"Sale date","fr_FR":"Date des soldes"}}}]}}}}}}]},"examples":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/attributes?page=3&limit=3"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/attributes?page=1&limit=3"},"previous":{"href":"https://demo.akeneo.com/api/rest/v1/attributes?page=2&limit=3"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/attributes?page=4&limit=3"}},"current_page":3,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/attributes/sku"}},"code":"sku","type":"pim_catalog_identifier","group":"other","group_labels":{"en_US":"Other","fr_FR":"Autre"},"unique":true,"useable_as_grid_filter":true,"allowed_extensions":[],"metric_family":null,"default_metric_unit":null,"reference_data_name":null,"available_locales":[],"max_characters":null,"validation_rule":null,"validation_regexp":null,"wysiwyg_enabled":false,"number_min":null,"number_max":null,"decimals_allowed":false,"negative_allowed":false,"date_min":null,"date_max":null,"max_file_size":null,"minimum_input_length":null,"sort_order":1,"localizable":false,"scopable":false,"default_value":null,"labels":{"en_US":"Identifier","fr_FR":"Identifiant"}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/attributes/release_date"}},"code":"release_date","type":"pim_catalog_date","group":"marketing","unique":false,"useable_as_grid_filter":true,"allowed_extensions":[],"metric_family":null,"default_metric_unit":null,"reference_data_name":null,"available_locales":[],"max_characters":null,"validation_rule":null,"validation_regexp":null,"wysiwyg_enabled":false,"number_min":null,"number_max":null,"decimals_allowed":false,"negative_allowed":false,"date_min":"2017-06-28T08:00:00","date_max":"2017-08-08T22:00:00","max_file_size":null,"minimum_input_length":null,"sort_order":1,"localizable":false,"scopable":false,"default_value":null,"labels":{"en_US":"Sale date","fr_FR":"Date des soldes"}},{"_links":{"self":{"href":"http://localhost:8080/api/rest/v1/attributes/food_composition"}},"code":"food_composition","type":"pim_catalog_table","group":"product","unique":false,"useable_as_grid_filter":false,"allowed_extensions":[],"metric_family":null,"default_metric_unit":null,"reference_data_name":null,"available_locales":[],"max_characters":null,"validation_rule":null,"validation_regexp":null,"wysiwyg_enabled":null,"number_min":null,"number_max":null,"decimals_allowed":null,"negative_allowed":null,"date_min":null,"date_max":null,"max_file_size":null,"minimum_input_length":null,"sort_order":0,"localizable":false,"scopable":false,"labels":{"en_US":"Composition","fr_FR":"Composition"},"guidelines":{},"auto_option_sorting":null,"is_read_only":null,"default_value":null,"table_configuration":[{"code":"ingredient","data_type":"select","labels":{"en_US":"Ingredient","fr_FR":"Ingrédient"},"validations":{},"is_required_for_completeness":true},{"code":"percentage","data_type":"number","labels":{"en_US":"%","fr_FR":"%"},"validations":{"max":100,"min":0,"decimals_allowed":true},"is_required_for_completeness":true},{"code":"allergen","data_type":"boolean","labels":{"en_US":"Allergen","fr_FR":"Allergène"},"validations":{},"is_required_for_completeness":false}]}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"post":{"summary":"Create a new attribute","operationId":"post_attributes","description":"This endpoint allows you to create a new attribute.","tags":["Attribute"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","required":["code","type","group"],"properties":{"code":{"type":"string","description":"Attribute code","x-immutable":true},"type":{"type":"string","description":"Attribute type. See type section for more details.","x-validation-rules":"The type is one of the following values","enum":["pim_catalog_identifier","pim_catalog_metric","pim_catalog_number","pim_catalog_reference_data_multi_select","pim_catalog_reference_data_simple_select","pim_catalog_simpleselect","pim_catalog_multiselect","pim_catalog_date","pim_catalog_textarea","pim_catalog_text","pim_catalog_file","pim_catalog_image","pim_catalog_price_collection","pim_catalog_boolean","akeneo_reference_entity","akeneo_reference_entity_collection","pim_catalog_asset_collection"],"x-immutable":true},"labels":{"type":"object","description":"Attribute labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute label for the locale `localeCode`"}}},"group":{"type":"string","description":"Attribute group","x-validation-rules":"It is the code of an existing group"},"group_labels":{"type":"object","description":"Group labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","x-read-only":true,"default":{},"properties":{"localeCode":{"type":"string","description":"Group label for the locale `localeCode`"}}},"sort_order":{"type":"integer","description":"Order of the attribute in its group","x-validation-rules":"It is a positive integer","default":0},"localizable":{"type":"boolean","description":"Whether the attribute is localizable, i.e. can have one value by locale","default":false,"x-immutable":true},"scopable":{"type":"boolean","description":"Whether the attribute is scopable, i.e. can have one value by channel","default":false,"x-immutable":true},"available_locales":{"type":"array","description":"To make the attribute locale specfic, specify here for which locales it is specific","x-validation-rules":"Each string of the array is an existing and activated locale","items":{"type":"string"}},"unique":{"type":"boolean","description":"Whether two values for the attribute cannot be the same","x-immutable":true},"useable_as_grid_filter":{"type":"boolean","description":"Whether the attribute can be used as a filter for the product grid in the PIM user interface"},"max_characters":{"type":"integer","description":"Number maximum of characters allowed for the value of the attribute when the attribute type is `pim_catalog_text`, `pim_catalog_textarea` or `pim_catalog_identifier`","x-warning":"Only for `pim_catalog_text`, `pim_catalog_textarea` or `pim_catalog_identifier` attribute types"},"validation_rule":{"type":"string","description":"Validation rule type used to validate any attribute value when the attribute type is `pim_catalog_text` or `pim_catalog_identifier`","x-validation-rules":"Equal to `regexp` when the attribute type is equal to `pim_catalog_identifier`","x-warning":"Only for `pim_catalog_text` or `pim_catalog_identifier` attribute types"},"validation_regexp":{"type":"string","description":"Regexp expression used to validate any attribute value when the attribute type is `pim_catalog_text` or `pim_catalog_identifier`","x-validation-rules":"Required when the property `validation_rule` is equal to `regexp`","x-warning":"Only for `pim_catalog_text` or `pim_catalog_identifier` attribute types"},"wysiwyg_enabled":{"type":"boolean","description":"Whether the WYSIWYG interface is shown when the attribute type is `pim_catalog_textarea`","x-warning":"Only for `pim_catalog_textarea` attribute type"},"number_min":{"type":"string","description":"Minimum integer value allowed when the attribute type is `pim_catalog_metric`, `pim_catalog_price` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric`, `pim_catalog_price_collection` or `pim_catalog_number` attribute types"},"number_max":{"type":"string","description":"Maximum integer value allowed when the attribute type is `pim_catalog_metric`, `pim_catalog_price` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric`, `pim_catalog_price_collection` or `pim_catalog_number` attribute types"},"decimals_allowed":{"type":"boolean","description":"Whether decimals are allowed when the attribute type is `pim_catalog_metric`, `pim_catalog_price` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric`, `pim_catalog_price_collection` or `pim_catalog_number` attribute types"},"negative_allowed":{"type":"boolean","description":"Whether negative values are allowed when the attribute type is `pim_catalog_metric` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric` or `pim_catalog_number` attribute types"},"metric_family":{"type":"string","description":"Metric family when the attribute type is `pim_catalog_metric`","x-immutable":true,"x-validation-rules":"Required for `pim_catalog_metric` attribute type","x-warning":"Only for `pim_catalog_metric` attribute type"},"default_metric_unit":{"type":"string","description":"Default metric unit when the attribute type is `pim_catalog_metric`","x-validation-rules":"Required for `pim_catalog_metric` attribute type","x-warning":"Only for `pim_catalog_metric` attribute type"},"date_min":{"type":"string","description":"Minimum date allowed when the attribute type is `pim_catalog_date`","x-validation-rules":"The datetime format follows the ISO-8601 norm","x-warning":"Only for `pim_catalog_date` attribute type","format":"date-time"},"date_max":{"type":"string","description":"Maximum date allowed when the attribute type is `pim_catalog_date`","x-validation-rules":"The datetime format follows the ISO-8601 norm","x-warning":"Only for `pim_catalog_date` attribute type","format":"date-time"},"allowed_extensions":{"type":"array","description":"Extensions allowed when the attribute type is `pim_catalog_file` or `pim_catalog_image`","x-warning":"Only for `pim_catalog_file` or `pim_catalog_image` attribute types","items":{"type":"string"}},"max_file_size":{"type":"string","description":"Max file size in MB when the attribute type is `pim_catalog_file` or `pim_catalog_image`","x-warning":"Only for `pim_catalog_file` or `pim_catalog_image` attribute types"},"reference_data_name":{"type":"string","description":"Reference entity code when the attribute type is `akeneo_reference_entity` or `akeneo_reference_entity_collection` OR Asset family code when the attribute type is `pim_catalog_asset_collection`","x-validation-rules":"Required only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types","x-warning":"Only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types"},"default_value":{"type":"boolean","description":"Default value for a Yes/No attribute, applied when creating a new product or product model (only available since the 5.0)","x-warning":"Only for `pim_catalog_boolean` attribute type","x-from-version":"5.0"},"table_configuration":{"type":"array","description":"Configuration of the Table attribute (columns)","x-validation-rules":"Required only for `pim_catalog_table` attribute type","x-warning":"Only for `pim_catalog_table` attribute type","items":{"type":"object","required":["code","data_type"],"properties":{"code":{"type":"string","description":"Column code"},"data_type":{"type":"string","enum":["select","text","number","boolean"],"description":"Column data type"},"validations":{"type":"object","description":"User defined validation constraints on the cell content","default":{},"properties":{"min":{"type":"number","description":"minimum value of a numeric cell","x-validation-rules":"only for `number` data type columns"},"max":{"type":"number","description":"maximum value of a numeric cell","x-validation-rules":"only for `number` data type columns"},"decimals_allowed":{"type":"boolean","description":"whether the value of a numeric cell can hold a decimal part","x-validation-rules":"only for `number` data type columns"},"max_length":{"type":"number","description":"maximum length of a text cell","x-validation-rules":"only for `text` data type columns"}}},"labels":{"type":"object","description":"Column labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Column label for the locale `localeCode`"}}},"is_required_for_completeness":{"type":"boolean","description":"Defines if the column should be entirely filled for the attribute to be considered complete","x-warning":"This value is always true for the first column in a table configuration","default":false}}}},"is_main_identifier":{"type":"boolean","description":"Is this attribute main identifier when attribute type is `pim_catalog_identifier`"}},"example":{"code":"release_date","type":"pim_catalog_date","group":"marketing","group_labels":{"en_US":"Marketing","fr_FR":"Marketing"},"unique":false,"useable_as_grid_filter":true,"allowed_extensions":[],"metric_family":null,"default_metric_unit":null,"reference_data_name":null,"available_locales":[],"max_characters":null,"validation_rule":null,"validation_regexp":null,"wysiwyg_enabled":null,"number_min":null,"number_max":null,"decimals_allowed":null,"negative_allowed":null,"date_min":"2017-06-28T08:00:00","date_max":"2017-08-08T22:00:00","max_file_size":null,"minimum_input_length":null,"sort_order":1,"localizable":false,"scopable":false,"default_value":null,"labels":{"en_US":"Sale date","fr_FR":"Date des soldes"}}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}},"patch":{"summary":"Update/create several attributes","operationId":"patch_attributes","tags":["Attribute"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to update and/or create several attributes at once.","x-body-by-line":"Contains several lines, each line is an attribute in JSON standard format","parameters":[{"name":"body","in":"body","schema":{"x-examples":{"x-example-1":"{\"code\":\"description\",\"useable_as_grid_filter\":true}","x-example-2":"{\"code\":\"short_description\",\"group\":\"marketig\"}","x-example-3":"{\"code\":\"release_date\",\"date_min\":\"2017-06-28T08:00:00\"}"},"type":"object","required":["code","type","group"],"properties":{"code":{"type":"string","description":"Attribute code","x-immutable":true},"type":{"type":"string","description":"Attribute type. See type section for more details.","x-validation-rules":"The type is one of the following values","enum":["pim_catalog_identifier","pim_catalog_metric","pim_catalog_number","pim_catalog_reference_data_multi_select","pim_catalog_reference_data_simple_select","pim_catalog_simpleselect","pim_catalog_multiselect","pim_catalog_date","pim_catalog_textarea","pim_catalog_text","pim_catalog_file","pim_catalog_image","pim_catalog_price_collection","pim_catalog_boolean","akeneo_reference_entity","akeneo_reference_entity_collection","pim_catalog_asset_collection"],"x-immutable":true},"labels":{"type":"object","description":"Attribute labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute label for the locale `localeCode`"}}},"group":{"type":"string","description":"Attribute group","x-validation-rules":"It is the code of an existing group"},"group_labels":{"type":"object","description":"Group labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","x-read-only":true,"default":{},"properties":{"localeCode":{"type":"string","description":"Group label for the locale `localeCode`"}}},"sort_order":{"type":"integer","description":"Order of the attribute in its group","x-validation-rules":"It is a positive integer","default":0},"localizable":{"type":"boolean","description":"Whether the attribute is localizable, i.e. can have one value by locale","default":false,"x-immutable":true},"scopable":{"type":"boolean","description":"Whether the attribute is scopable, i.e. can have one value by channel","default":false,"x-immutable":true},"available_locales":{"type":"array","description":"To make the attribute locale specfic, specify here for which locales it is specific","x-validation-rules":"Each string of the array is an existing and activated locale","items":{"type":"string"}},"unique":{"type":"boolean","description":"Whether two values for the attribute cannot be the same","x-immutable":true},"useable_as_grid_filter":{"type":"boolean","description":"Whether the attribute can be used as a filter for the product grid in the PIM user interface"},"max_characters":{"type":"integer","description":"Number maximum of characters allowed for the value of the attribute when the attribute type is `pim_catalog_text`, `pim_catalog_textarea` or `pim_catalog_identifier`","x-warning":"Only for `pim_catalog_text`, `pim_catalog_textarea` or `pim_catalog_identifier` attribute types"},"validation_rule":{"type":"string","description":"Validation rule type used to validate any attribute value when the attribute type is `pim_catalog_text` or `pim_catalog_identifier`","x-validation-rules":"Equal to `regexp` when the attribute type is equal to `pim_catalog_identifier`","x-warning":"Only for `pim_catalog_text` or `pim_catalog_identifier` attribute types"},"validation_regexp":{"type":"string","description":"Regexp expression used to validate any attribute value when the attribute type is `pim_catalog_text` or `pim_catalog_identifier`","x-validation-rules":"Required when the property `validation_rule` is equal to `regexp`","x-warning":"Only for `pim_catalog_text` or `pim_catalog_identifier` attribute types"},"wysiwyg_enabled":{"type":"boolean","description":"Whether the WYSIWYG interface is shown when the attribute type is `pim_catalog_textarea`","x-warning":"Only for `pim_catalog_textarea` attribute type"},"number_min":{"type":"string","description":"Minimum integer value allowed when the attribute type is `pim_catalog_metric`, `pim_catalog_price` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric`, `pim_catalog_price_collection` or `pim_catalog_number` attribute types"},"number_max":{"type":"string","description":"Maximum integer value allowed when the attribute type is `pim_catalog_metric`, `pim_catalog_price` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric`, `pim_catalog_price_collection` or `pim_catalog_number` attribute types"},"decimals_allowed":{"type":"boolean","description":"Whether decimals are allowed when the attribute type is `pim_catalog_metric`, `pim_catalog_price` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric`, `pim_catalog_price_collection` or `pim_catalog_number` attribute types"},"negative_allowed":{"type":"boolean","description":"Whether negative values are allowed when the attribute type is `pim_catalog_metric` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric` or `pim_catalog_number` attribute types"},"metric_family":{"type":"string","description":"Metric family when the attribute type is `pim_catalog_metric`","x-immutable":true,"x-validation-rules":"Required for `pim_catalog_metric` attribute type","x-warning":"Only for `pim_catalog_metric` attribute type"},"default_metric_unit":{"type":"string","description":"Default metric unit when the attribute type is `pim_catalog_metric`","x-validation-rules":"Required for `pim_catalog_metric` attribute type","x-warning":"Only for `pim_catalog_metric` attribute type"},"date_min":{"type":"string","description":"Minimum date allowed when the attribute type is `pim_catalog_date`","x-validation-rules":"The datetime format follows the ISO-8601 norm","x-warning":"Only for `pim_catalog_date` attribute type","format":"date-time"},"date_max":{"type":"string","description":"Maximum date allowed when the attribute type is `pim_catalog_date`","x-validation-rules":"The datetime format follows the ISO-8601 norm","x-warning":"Only for `pim_catalog_date` attribute type","format":"date-time"},"allowed_extensions":{"type":"array","description":"Extensions allowed when the attribute type is `pim_catalog_file` or `pim_catalog_image`","x-warning":"Only for `pim_catalog_file` or `pim_catalog_image` attribute types","items":{"type":"string"}},"max_file_size":{"type":"string","description":"Max file size in MB when the attribute type is `pim_catalog_file` or `pim_catalog_image`","x-warning":"Only for `pim_catalog_file` or `pim_catalog_image` attribute types"},"reference_data_name":{"type":"string","description":"Reference entity code when the attribute type is `akeneo_reference_entity` or `akeneo_reference_entity_collection` OR Asset family code when the attribute type is `pim_catalog_asset_collection`","x-validation-rules":"Required only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types","x-warning":"Only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types"},"default_value":{"type":"boolean","description":"Default value for a Yes/No attribute, applied when creating a new product or product model (only available since the 5.0)","x-warning":"Only for `pim_catalog_boolean` attribute type","x-from-version":"5.0"},"table_configuration":{"type":"array","description":"Configuration of the Table attribute (columns)","x-validation-rules":"Required only for `pim_catalog_table` attribute type","x-warning":"Only for `pim_catalog_table` attribute type","items":{"type":"object","required":["code","data_type"],"properties":{"code":{"type":"string","description":"Column code"},"data_type":{"type":"string","enum":["select","text","number","boolean"],"description":"Column data type"},"validations":{"type":"object","description":"User defined validation constraints on the cell content","default":{},"properties":{"min":{"type":"number","description":"minimum value of a numeric cell","x-validation-rules":"only for `number` data type columns"},"max":{"type":"number","description":"maximum value of a numeric cell","x-validation-rules":"only for `number` data type columns"},"decimals_allowed":{"type":"boolean","description":"whether the value of a numeric cell can hold a decimal part","x-validation-rules":"only for `number` data type columns"},"max_length":{"type":"number","description":"maximum length of a text cell","x-validation-rules":"only for `text` data type columns"}}},"labels":{"type":"object","description":"Column labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Column label for the locale `localeCode`"}}},"is_required_for_completeness":{"type":"boolean","description":"Defines if the column should be entirely filled for the attribute to be considered complete","x-warning":"This value is always true for the first column in a table configuration","default":false}}}},"is_main_identifier":{"type":"boolean","description":"Is this attribute main identifier when attribute type is `pim_catalog_identifier`"}},"example":{"code":"release_date","type":"pim_catalog_date","group":"marketing","group_labels":{"en_US":"Marketing","fr_FR":"Marketing"},"unique":false,"useable_as_grid_filter":true,"allowed_extensions":[],"metric_family":null,"default_metric_unit":null,"reference_data_name":null,"available_locales":[],"max_characters":null,"validation_rule":null,"validation_regexp":null,"wysiwyg_enabled":null,"number_min":null,"number_max":null,"decimals_allowed":null,"negative_allowed":null,"date_min":"2017-06-28T08:00:00","date_max":"2017-08-08T22:00:00","max_file_size":null,"minimum_input_length":null,"sort_order":1,"localizable":false,"scopable":false,"default_value":null,"labels":{"en_US":"Sale date","fr_FR":"Date des soldes"}}}}],"responses":{"200":{"description":"OK","x-details":"Returns a plain text response whose lines are JSON containing the status of each update or creation","x-no-entity":true,"schema":{"type":"object","properties":{"line":{"type":"integer","description":"Line number"},"identifier":{"type":"string","description":"Resource identifier, only filled when the resource is a product"},"code":{"type":"string","description":"Resource code, only filled when the resource is not a product"},"status_code":{"type":"integer","description":"HTTP status code, see Client errors to understand the meaning of each code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"x-example-1":"{\"line\":1,\"code\":\"description\",\"status_code\":201}","x-example-2":"{\"line\":2,\"code\":\"short_description\",\"status_code\":422,\"message\":\"Group \\\"marketig\\\" does not exist.\"}","x-example-3":"{\"line\":3,\"code\":\"release_date\",\"status_code\":204}"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"413":{"description":"Request Entity Too Large","x-details":"There are too many resources to process (max 100) or the line of JSON is too long (max 1 000 000 characters)","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":413,"message":"Too many resources to process, 100 is the maximum allowed."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/vnd.akeneo.collection+json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/vnd.akeneo.collection+json’ is allowed."}}}}},"/api/rest/v1/attributes/{code}":{"get":{"summary":"Get an attribute","operationId":"get_attributes__code_","description":"This endpoint allows you to get the information about a given attribute.","tags":["Attribute"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"},{"name":"with_table_select_options","in":"query","description":"Return the options of 'select' column types (of a table attribute) in the response. (Only available since the 7.0 version)","default":false,"type":"boolean","required":false,"x-from-version":"7.0"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the attribute in JSON standard format","schema":{"type":"object","required":["code","type","group"],"properties":{"code":{"type":"string","description":"Attribute code","x-immutable":true},"type":{"type":"string","description":"Attribute type. See type section for more details.","x-validation-rules":"The type is one of the following values","enum":["pim_catalog_identifier","pim_catalog_metric","pim_catalog_number","pim_catalog_reference_data_multi_select","pim_catalog_reference_data_simple_select","pim_catalog_simpleselect","pim_catalog_multiselect","pim_catalog_date","pim_catalog_textarea","pim_catalog_text","pim_catalog_file","pim_catalog_image","pim_catalog_price_collection","pim_catalog_boolean","akeneo_reference_entity","akeneo_reference_entity_collection","pim_catalog_asset_collection"],"x-immutable":true},"labels":{"type":"object","description":"Attribute labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute label for the locale `localeCode`"}}},"group":{"type":"string","description":"Attribute group","x-validation-rules":"It is the code of an existing group"},"group_labels":{"type":"object","description":"Group labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","x-read-only":true,"default":{},"properties":{"localeCode":{"type":"string","description":"Group label for the locale `localeCode`"}}},"sort_order":{"type":"integer","description":"Order of the attribute in its group","x-validation-rules":"It is a positive integer","default":0},"localizable":{"type":"boolean","description":"Whether the attribute is localizable, i.e. can have one value by locale","default":false,"x-immutable":true},"scopable":{"type":"boolean","description":"Whether the attribute is scopable, i.e. can have one value by channel","default":false,"x-immutable":true},"available_locales":{"type":"array","description":"To make the attribute locale specfic, specify here for which locales it is specific","x-validation-rules":"Each string of the array is an existing and activated locale","items":{"type":"string"}},"unique":{"type":"boolean","description":"Whether two values for the attribute cannot be the same","x-immutable":true},"useable_as_grid_filter":{"type":"boolean","description":"Whether the attribute can be used as a filter for the product grid in the PIM user interface"},"max_characters":{"type":"integer","description":"Number maximum of characters allowed for the value of the attribute when the attribute type is `pim_catalog_text`, `pim_catalog_textarea` or `pim_catalog_identifier`","x-warning":"Only for `pim_catalog_text`, `pim_catalog_textarea` or `pim_catalog_identifier` attribute types"},"validation_rule":{"type":"string","description":"Validation rule type used to validate any attribute value when the attribute type is `pim_catalog_text` or `pim_catalog_identifier`","x-validation-rules":"Equal to `regexp` when the attribute type is equal to `pim_catalog_identifier`","x-warning":"Only for `pim_catalog_text` or `pim_catalog_identifier` attribute types"},"validation_regexp":{"type":"string","description":"Regexp expression used to validate any attribute value when the attribute type is `pim_catalog_text` or `pim_catalog_identifier`","x-validation-rules":"Required when the property `validation_rule` is equal to `regexp`","x-warning":"Only for `pim_catalog_text` or `pim_catalog_identifier` attribute types"},"wysiwyg_enabled":{"type":"boolean","description":"Whether the WYSIWYG interface is shown when the attribute type is `pim_catalog_textarea`","x-warning":"Only for `pim_catalog_textarea` attribute type"},"number_min":{"type":"string","description":"Minimum integer value allowed when the attribute type is `pim_catalog_metric`, `pim_catalog_price` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric`, `pim_catalog_price_collection` or `pim_catalog_number` attribute types"},"number_max":{"type":"string","description":"Maximum integer value allowed when the attribute type is `pim_catalog_metric`, `pim_catalog_price` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric`, `pim_catalog_price_collection` or `pim_catalog_number` attribute types"},"decimals_allowed":{"type":"boolean","description":"Whether decimals are allowed when the attribute type is `pim_catalog_metric`, `pim_catalog_price` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric`, `pim_catalog_price_collection` or `pim_catalog_number` attribute types"},"negative_allowed":{"type":"boolean","description":"Whether negative values are allowed when the attribute type is `pim_catalog_metric` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric` or `pim_catalog_number` attribute types"},"metric_family":{"type":"string","description":"Metric family when the attribute type is `pim_catalog_metric`","x-immutable":true,"x-validation-rules":"Required for `pim_catalog_metric` attribute type","x-warning":"Only for `pim_catalog_metric` attribute type"},"default_metric_unit":{"type":"string","description":"Default metric unit when the attribute type is `pim_catalog_metric`","x-validation-rules":"Required for `pim_catalog_metric` attribute type","x-warning":"Only for `pim_catalog_metric` attribute type"},"date_min":{"type":"string","description":"Minimum date allowed when the attribute type is `pim_catalog_date`","x-validation-rules":"The datetime format follows the ISO-8601 norm","x-warning":"Only for `pim_catalog_date` attribute type","format":"date-time"},"date_max":{"type":"string","description":"Maximum date allowed when the attribute type is `pim_catalog_date`","x-validation-rules":"The datetime format follows the ISO-8601 norm","x-warning":"Only for `pim_catalog_date` attribute type","format":"date-time"},"allowed_extensions":{"type":"array","description":"Extensions allowed when the attribute type is `pim_catalog_file` or `pim_catalog_image`","x-warning":"Only for `pim_catalog_file` or `pim_catalog_image` attribute types","items":{"type":"string"}},"max_file_size":{"type":"string","description":"Max file size in MB when the attribute type is `pim_catalog_file` or `pim_catalog_image`","x-warning":"Only for `pim_catalog_file` or `pim_catalog_image` attribute types"},"reference_data_name":{"type":"string","description":"Reference entity code when the attribute type is `akeneo_reference_entity` or `akeneo_reference_entity_collection` OR Asset family code when the attribute type is `pim_catalog_asset_collection`","x-validation-rules":"Required only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types","x-warning":"Only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types"},"default_value":{"type":"boolean","description":"Default value for a Yes/No attribute, applied when creating a new product or product model (only available since the 5.0)","x-warning":"Only for `pim_catalog_boolean` attribute type","x-from-version":"5.0"},"table_configuration":{"type":"array","description":"Configuration of the Table attribute (columns)","x-validation-rules":"Required only for `pim_catalog_table` attribute type","x-warning":"Only for `pim_catalog_table` attribute type","items":{"type":"object","required":["code","data_type"],"properties":{"code":{"type":"string","description":"Column code"},"data_type":{"type":"string","enum":["select","text","number","boolean"],"description":"Column data type"},"validations":{"type":"object","description":"User defined validation constraints on the cell content","default":{},"properties":{"min":{"type":"number","description":"minimum value of a numeric cell","x-validation-rules":"only for `number` data type columns"},"max":{"type":"number","description":"maximum value of a numeric cell","x-validation-rules":"only for `number` data type columns"},"decimals_allowed":{"type":"boolean","description":"whether the value of a numeric cell can hold a decimal part","x-validation-rules":"only for `number` data type columns"},"max_length":{"type":"number","description":"maximum length of a text cell","x-validation-rules":"only for `text` data type columns"}}},"labels":{"type":"object","description":"Column labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Column label for the locale `localeCode`"}}},"is_required_for_completeness":{"type":"boolean","description":"Defines if the column should be entirely filled for the attribute to be considered complete","x-warning":"This value is always true for the first column in a table configuration","default":false}}}},"is_main_identifier":{"type":"boolean","description":"Is this attribute main identifier when attribute type is `pim_catalog_identifier`"}},"example":{"code":"release_date","type":"pim_catalog_date","group":"marketing","group_labels":{"en_US":"Marketing","fr_FR":"Marketing"},"unique":false,"useable_as_grid_filter":true,"allowed_extensions":[],"metric_family":null,"default_metric_unit":null,"reference_data_name":null,"available_locales":[],"max_characters":null,"validation_rule":null,"validation_regexp":null,"wysiwyg_enabled":null,"number_min":null,"number_max":null,"decimals_allowed":null,"negative_allowed":null,"date_min":"2017-06-28T08:00:00","date_max":"2017-08-08T22:00:00","max_file_size":null,"minimum_input_length":null,"sort_order":1,"localizable":false,"scopable":false,"default_value":null,"labels":{"en_US":"Sale date","fr_FR":"Date des soldes"}}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"patch":{"summary":"Update/create an attribute","operationId":"patch_attributes__code_","tags":["Attribute"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to update a given attribute. Know more about Update behavior. Note that if no attribute exists for the given code, it creates it.","parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"},{"name":"body","in":"body","required":true,"schema":{"type":"object","required":["code","type","group"],"properties":{"code":{"type":"string","description":"Attribute code","x-immutable":true},"type":{"type":"string","description":"Attribute type. See type section for more details.","x-validation-rules":"The type is one of the following values","enum":["pim_catalog_identifier","pim_catalog_metric","pim_catalog_number","pim_catalog_reference_data_multi_select","pim_catalog_reference_data_simple_select","pim_catalog_simpleselect","pim_catalog_multiselect","pim_catalog_date","pim_catalog_textarea","pim_catalog_text","pim_catalog_file","pim_catalog_image","pim_catalog_price_collection","pim_catalog_boolean","akeneo_reference_entity","akeneo_reference_entity_collection","pim_catalog_asset_collection"],"x-immutable":true},"labels":{"type":"object","description":"Attribute labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute label for the locale `localeCode`"}}},"group":{"type":"string","description":"Attribute group","x-validation-rules":"It is the code of an existing group"},"group_labels":{"type":"object","description":"Group labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","x-read-only":true,"default":{},"properties":{"localeCode":{"type":"string","description":"Group label for the locale `localeCode`"}}},"sort_order":{"type":"integer","description":"Order of the attribute in its group","x-validation-rules":"It is a positive integer","default":0},"localizable":{"type":"boolean","description":"Whether the attribute is localizable, i.e. can have one value by locale","default":false,"x-immutable":true},"scopable":{"type":"boolean","description":"Whether the attribute is scopable, i.e. can have one value by channel","default":false,"x-immutable":true},"available_locales":{"type":"array","description":"To make the attribute locale specfic, specify here for which locales it is specific","x-validation-rules":"Each string of the array is an existing and activated locale","items":{"type":"string"}},"unique":{"type":"boolean","description":"Whether two values for the attribute cannot be the same","x-immutable":true},"useable_as_grid_filter":{"type":"boolean","description":"Whether the attribute can be used as a filter for the product grid in the PIM user interface"},"max_characters":{"type":"integer","description":"Number maximum of characters allowed for the value of the attribute when the attribute type is `pim_catalog_text`, `pim_catalog_textarea` or `pim_catalog_identifier`","x-warning":"Only for `pim_catalog_text`, `pim_catalog_textarea` or `pim_catalog_identifier` attribute types"},"validation_rule":{"type":"string","description":"Validation rule type used to validate any attribute value when the attribute type is `pim_catalog_text` or `pim_catalog_identifier`","x-validation-rules":"Equal to `regexp` when the attribute type is equal to `pim_catalog_identifier`","x-warning":"Only for `pim_catalog_text` or `pim_catalog_identifier` attribute types"},"validation_regexp":{"type":"string","description":"Regexp expression used to validate any attribute value when the attribute type is `pim_catalog_text` or `pim_catalog_identifier`","x-validation-rules":"Required when the property `validation_rule` is equal to `regexp`","x-warning":"Only for `pim_catalog_text` or `pim_catalog_identifier` attribute types"},"wysiwyg_enabled":{"type":"boolean","description":"Whether the WYSIWYG interface is shown when the attribute type is `pim_catalog_textarea`","x-warning":"Only for `pim_catalog_textarea` attribute type"},"number_min":{"type":"string","description":"Minimum integer value allowed when the attribute type is `pim_catalog_metric`, `pim_catalog_price` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric`, `pim_catalog_price_collection` or `pim_catalog_number` attribute types"},"number_max":{"type":"string","description":"Maximum integer value allowed when the attribute type is `pim_catalog_metric`, `pim_catalog_price` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric`, `pim_catalog_price_collection` or `pim_catalog_number` attribute types"},"decimals_allowed":{"type":"boolean","description":"Whether decimals are allowed when the attribute type is `pim_catalog_metric`, `pim_catalog_price` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric`, `pim_catalog_price_collection` or `pim_catalog_number` attribute types"},"negative_allowed":{"type":"boolean","description":"Whether negative values are allowed when the attribute type is `pim_catalog_metric` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric` or `pim_catalog_number` attribute types"},"metric_family":{"type":"string","description":"Metric family when the attribute type is `pim_catalog_metric`","x-immutable":true,"x-validation-rules":"Required for `pim_catalog_metric` attribute type","x-warning":"Only for `pim_catalog_metric` attribute type"},"default_metric_unit":{"type":"string","description":"Default metric unit when the attribute type is `pim_catalog_metric`","x-validation-rules":"Required for `pim_catalog_metric` attribute type","x-warning":"Only for `pim_catalog_metric` attribute type"},"date_min":{"type":"string","description":"Minimum date allowed when the attribute type is `pim_catalog_date`","x-validation-rules":"The datetime format follows the ISO-8601 norm","x-warning":"Only for `pim_catalog_date` attribute type","format":"date-time"},"date_max":{"type":"string","description":"Maximum date allowed when the attribute type is `pim_catalog_date`","x-validation-rules":"The datetime format follows the ISO-8601 norm","x-warning":"Only for `pim_catalog_date` attribute type","format":"date-time"},"allowed_extensions":{"type":"array","description":"Extensions allowed when the attribute type is `pim_catalog_file` or `pim_catalog_image`","x-warning":"Only for `pim_catalog_file` or `pim_catalog_image` attribute types","items":{"type":"string"}},"max_file_size":{"type":"string","description":"Max file size in MB when the attribute type is `pim_catalog_file` or `pim_catalog_image`","x-warning":"Only for `pim_catalog_file` or `pim_catalog_image` attribute types"},"reference_data_name":{"type":"string","description":"Reference entity code when the attribute type is `akeneo_reference_entity` or `akeneo_reference_entity_collection` OR Asset family code when the attribute type is `pim_catalog_asset_collection`","x-validation-rules":"Required only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types","x-warning":"Only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types"},"default_value":{"type":"boolean","description":"Default value for a Yes/No attribute, applied when creating a new product or product model (only available since the 5.0)","x-warning":"Only for `pim_catalog_boolean` attribute type","x-from-version":"5.0"},"table_configuration":{"type":"array","description":"Configuration of the Table attribute (columns)","x-validation-rules":"Required only for `pim_catalog_table` attribute type","x-warning":"Only for `pim_catalog_table` attribute type","items":{"type":"object","required":["code","data_type"],"properties":{"code":{"type":"string","description":"Column code"},"data_type":{"type":"string","enum":["select","text","number","boolean"],"description":"Column data type"},"validations":{"type":"object","description":"User defined validation constraints on the cell content","default":{},"properties":{"min":{"type":"number","description":"minimum value of a numeric cell","x-validation-rules":"only for `number` data type columns"},"max":{"type":"number","description":"maximum value of a numeric cell","x-validation-rules":"only for `number` data type columns"},"decimals_allowed":{"type":"boolean","description":"whether the value of a numeric cell can hold a decimal part","x-validation-rules":"only for `number` data type columns"},"max_length":{"type":"number","description":"maximum length of a text cell","x-validation-rules":"only for `text` data type columns"}}},"labels":{"type":"object","description":"Column labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Column label for the locale `localeCode`"}}},"is_required_for_completeness":{"type":"boolean","description":"Defines if the column should be entirely filled for the attribute to be considered complete","x-warning":"This value is always true for the first column in a table configuration","default":false}}}},"is_main_identifier":{"type":"boolean","description":"Is this attribute main identifier when attribute type is `pim_catalog_identifier`"}},"example":{"code":"release_date","type":"pim_catalog_date","group":"marketing","group_labels":{"en_US":"Marketing","fr_FR":"Marketing"},"unique":false,"useable_as_grid_filter":true,"allowed_extensions":[],"metric_family":null,"default_metric_unit":null,"reference_data_name":null,"available_locales":[],"max_characters":null,"validation_rule":null,"validation_regexp":null,"wysiwyg_enabled":null,"number_min":null,"number_max":null,"decimals_allowed":null,"negative_allowed":null,"date_min":"2017-06-28T08:00:00","date_max":"2017-08-08T22:00:00","max_file_size":null,"minimum_input_length":null,"sort_order":1,"localizable":false,"scopable":false,"default_value":null,"labels":{"en_US":"Sale date","fr_FR":"Date des soldes"}}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"204":{"description":"No content to return","x-details":"Means that the update was successful","headers":{"Location":{"description":"URI of the updated resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/attributes/{attribute_code}/options":{"get":{"summary":"Get list of attribute options","operationId":"get_attributes__attribute_code__options","description":"This endpoint allows you to get a list of attribute options. Attribute options are paginated and sorted by code.","tags":["Attribute option"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"attribute_code","in":"path","description":"Code of the attribute","required":true,"type":"string"},{"name":"page","in":"query","description":"Number of the page to retrieve when using the `page` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"integer","default":1},{"name":"limit","in":"query","description":"Number of results by page, see Pagination section","required":false,"type":"integer","minimum":1,"maximum":100,"default":10},{"name":"with_count","in":"query","description":"Return the count of items in the response. Be carefull with that, on a big catalog, it can decrease performance in a significative way","default":false,"type":"boolean","required":false}],"responses":{"200":{"description":"Return attribute options paginated","schema":{"title":"Attribute Options","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"previous":{"type":"object","properties":{"href":{"type":"string","description":"URI of the previous page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}},"current_page":{"type":"integer","description":"Current page number"}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Code of option"},"attribute":{"type":"string","description":"Code of attribute related to the attribute option","x-validation-rules":"It is the same attribute code as the one given as path parameter"},"sort_order":{"type":"integer","description":"Order of attribute option","x-validation-rules":"It is a positive integer"},"labels":{"type":"object","description":"Attribute option labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute option label for the locale `localeCode`"}}}},"example":{"code":"black","attribute":"a_simple_select","sort_order":2,"labels":{"en_US":"Black","fr_FR":"Noir"}}}]}}}}}}]},"examples":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/attributes/color/options?page=3&limit=3"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/attributes/color/options?page=1&limit=3"},"previous":{"href":"https://demo.akeneo.com/api/rest/v1/attributes/color/options?page=2&limit=3"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/attributes/color/options?page=4&limit=3"}},"current_page":3,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/attributes/color/options/red"}},"code":"red","attribute":"a_simple_select","sort_order":1,"labels":{"en_US":"Red","fr_FR":"Rouge"}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/attributes/color/options/black"}},"code":"black","attribute":"a_simple_select","sort_order":2,"labels":{"en_US":"Black","fr_FR":"Noir"}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/attributes/color/options/purple"}},"code":"purple","attribute":"a_simple_select","sort_order":3,"labels":{"en_US":"Purple","fr_FR":"Violet"}}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"post":{"summary":"Create a new attribute option","operationId":"post_attributes__attribute_code__options","description":"This endpoint allows you to create a new attribute option.","tags":["Attribute option"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"attribute_code","in":"path","description":"Code of the attribute","required":true,"type":"string"},{"name":"body","in":"body","schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Code of option"},"attribute":{"type":"string","description":"Code of attribute related to the attribute option","x-validation-rules":"It is the same attribute code as the one given as path parameter"},"sort_order":{"type":"integer","description":"Order of attribute option","x-validation-rules":"It is a positive integer"},"labels":{"type":"object","description":"Attribute option labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute option label for the locale `localeCode`"}}}},"example":{"code":"black","attribute":"a_simple_select","sort_order":2,"labels":{"en_US":"Black","fr_FR":"Noir"}}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}},"patch":{"summary":"Update/create several attribute options","operationId":"patch_attributes__attribute_code__options","tags":["Attribute option"],"x-versions":["2.1","2.2","2.3","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to update several attribute options at once. Please note that this endpoint applies a rate limit of 3 concurrent API requests per second.","x-body-by-line":"Contains several lines, each line is an attribute option in JSON standard format","parameters":[{"name":"attribute_code","in":"path","description":"Code of the attribute","required":true,"type":"string"},{"name":"body","in":"body","schema":{"x-examples":{"x-example-1":"{\"code\":\"black\", \"attribute\":\"a_simple_select\", \"labels\":{\"en_US\": \"Black\",\"fr_FR\": \"Noir\"}}","x-example-2":"{\"code\":\"red\", \"label\":{\"en_US\": \"Red\",\"fr_FR\": \"Rouge\"}}","x-example-3":"{\"code\":\"yellow\", \"labels\":{\"en_US\": \"Yellow\",\"fr_FR\": \"Jaune\"}}"},"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Code of option"},"attribute":{"type":"string","description":"Code of attribute related to the attribute option","x-validation-rules":"It is the same attribute code as the one given as path parameter"},"sort_order":{"type":"integer","description":"Order of attribute option","x-validation-rules":"It is a positive integer"},"labels":{"type":"object","description":"Attribute option labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute option label for the locale `localeCode`"}}}},"example":{"code":"black","attribute":"a_simple_select","sort_order":2,"labels":{"en_US":"Black","fr_FR":"Noir"}}}}],"responses":{"200":{"description":"OK","x-details":"Returns a plain text response whose lines are JSON containing the status of each update or creation","x-no-entity":true,"schema":{"type":"object","properties":{"line":{"type":"integer","description":"Line number"},"identifier":{"type":"string","description":"Resource identifier, only filled when the resource is a product"},"code":{"type":"string","description":"Resource code, only filled when the resource is not a product"},"status_code":{"type":"integer","description":"HTTP status code, see Client errors to understand the meaning of each code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"x-example-1":"{\"line\":1,\"code\":\"black\",\"status_code\":201}","x-example-2":"{\"line\":2,\"code\":\"red\",\"status_code\":422,\"message\":\"Property \\\"label\\\" does not exist. Check the API format documentation.\"}","x-example-3":"{\"line\":3,\"code\":\"yellow\",\"status_code\":204}"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"413":{"description":"Request Entity Too Large","x-details":"There are too many resources to process (max 100) or the line of JSON is too long (max 1 000 000 characters)","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":413,"message":"Too many resources to process, 100 is the maximum allowed."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/vnd.akeneo.collection+json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/vnd.akeneo.collection+json’ is allowed."}},"429":{"description":"Too many requests","x-details":"There are too many requests on this endpoint","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":429,"message":"You have exceeded the limit of API requests per second."}}}}},"/api/rest/v1/attributes/{attribute_code}/options/{code}":{"get":{"summary":"Get an attribute option","operationId":"get_attributes__attribute_code__options__code_","description":"This endpoint allows you to get the information about a given attribute option.","tags":["Attribute option"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"attribute_code","in":"path","description":"Code of the attribute","required":true,"type":"string"},{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the attribute option in JSON standard format","schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Code of option"},"attribute":{"type":"string","description":"Code of attribute related to the attribute option","x-validation-rules":"It is the same attribute code as the one given as path parameter"},"sort_order":{"type":"integer","description":"Order of attribute option","x-validation-rules":"It is a positive integer"},"labels":{"type":"object","description":"Attribute option labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute option label for the locale `localeCode`"}}}},"example":{"code":"black","attribute":"a_simple_select","sort_order":2,"labels":{"en_US":"Black","fr_FR":"Noir"}}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"patch":{"summary":"Update/create an attribute option","operationId":"patch_attributes__attribute_code__options__code_","tags":["Attribute option"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to update a given attribute option. Know more about Update behavior. Note that if no attribute option exists for the given code, it creates it. Please note that this endpoint applies a rate limit of 3 concurrent API requests per second.","parameters":[{"name":"attribute_code","in":"path","description":"Code of the attribute","required":true,"type":"string"},{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"},{"name":"body","in":"body","required":true,"schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Code of option"},"attribute":{"type":"string","description":"Code of attribute related to the attribute option","x-validation-rules":"It is the same attribute code as the one given as path parameter"},"sort_order":{"type":"integer","description":"Order of attribute option","x-validation-rules":"It is a positive integer"},"labels":{"type":"object","description":"Attribute option labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute option label for the locale `localeCode`"}}}},"example":{"code":"black","attribute":"a_simple_select","sort_order":2,"labels":{"en_US":"Black","fr_FR":"Noir"}}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"204":{"description":"No content to return","x-details":"Means that the update was successful","headers":{"Location":{"description":"URI of the updated resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}},"429":{"description":"Too many requests","x-details":"There are too many requests on this endpoint","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":429,"message":"You have exceeded the limit of API requests per second."}}}}},"/api/rest/v1/attribute-groups":{"get":{"summary":"Get list of attribute groups","operationId":"attribute_groups_get_list","description":"This endpoint allows you to get a list of attribute groups. Attribute groups are paginated and sorted by code.","tags":["Attribute group"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"search","in":"query","description":"Filter attribute groups, for more details see the Filters section.","required":false,"type":"string"},{"name":"page","in":"query","description":"Number of the page to retrieve when using the `page` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"integer","default":1},{"name":"limit","in":"query","description":"Number of results by page, see Pagination section","required":false,"type":"integer","minimum":1,"maximum":100,"default":10},{"name":"with_count","in":"query","description":"Return the count of items in the response. Be carefull with that, on a big catalog, it can decrease performance in a significative way","default":false,"type":"boolean","required":false}],"responses":{"200":{"description":"Return attribute groups paginated","schema":{"title":"Attribute groups","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"previous":{"type":"object","properties":{"href":{"type":"string","description":"URI of the previous page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}},"current_page":{"type":"integer","description":"Current page number"}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Attribute group code","x-immutable":true},"sort_order":{"type":"integer","description":"Attribute group order among other attribute groups","x-validation-rules":"It is a positive integer","default":0},"attributes":{"type":"array","description":"Attribute codes that compose the attribute group","x-validation-rules":"Each string of the array is an existing attribute code, an attribute can only be in one attribute group","items":{"type":"string"},"default":[]},"labels":{"type":"object","description":"Attribute group labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute group label for the locale `localeCode`"}}}},"example":{"code":"marketing","sort_order":4,"attributes":["sku","name","description","response_time","release_date","price"],"labels":{"en_US":"Marketing","fr_FR":"Marketing"}}}]}}}}}}]},"examples":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/attribute-groups?page=3&limit=2"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/attribute-groups?page=1&limit=2"},"previous":{"href":"https://demo.akeneo.com/api/rest/v1/attribute-groups?page=2&limit=2"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/attribute-groups?page=4&limit=2"}},"current_page":3,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/attribute-groups/marketing"}},"code":"marketing","sort_order":4,"attributes":["sku","name","description","response_time","release_date","price"],"labels":{"en_US":"Marketing","fr_FR":"Marketing"}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/attribute-groups/technical"}},"code":"technical","sort_order":5,"attributes":["weight","maximum_scan_size","color_scanning","power_requirements","maximum_print_size","sensor_type","total_megapixels","optical_zoom","camera_type"],"labels":{"en_US":"Technical","fr_FR":"Technique"}}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"post":{"summary":"Create a new attribute group","operationId":"attribute_groups_post","description":"This endpoint allows you to create a new attribute group.","tags":["Attribute group"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Attribute group code","x-immutable":true},"sort_order":{"type":"integer","description":"Attribute group order among other attribute groups","x-validation-rules":"It is a positive integer","default":0},"attributes":{"type":"array","description":"Attribute codes that compose the attribute group","x-validation-rules":"Each string of the array is an existing attribute code, an attribute can only be in one attribute group","items":{"type":"string"},"default":[]},"labels":{"type":"object","description":"Attribute group labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute group label for the locale `localeCode`"}}}},"example":{"code":"marketing","sort_order":4,"attributes":["sku","name","description","response_time","release_date","price"],"labels":{"en_US":"Marketing","fr_FR":"Marketing"}}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}},"patch":{"summary":"Update/create several attribute groups","operationId":"several_attribute_groups_patch","tags":["Attribute group"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to update and/or create several attribute groups at once.","x-body-by-line":"Contains several lines, each line is an attribute group in JSON standard format","parameters":[{"name":"body","in":"body","schema":{"x-examples":{"x-example-1":"{\"code\":\"technical\",\"labels\":{\"en_US\": \"Technical\", \"fr_FR\": \"Technique\"}}","x-example-2":"{\"code\":\"marketing\",\"type\":\"bar\"}","x-example-3":"{\"code\":\"design\",\"sort_order\":7}"},"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Attribute group code","x-immutable":true},"sort_order":{"type":"integer","description":"Attribute group order among other attribute groups","x-validation-rules":"It is a positive integer","default":0},"attributes":{"type":"array","description":"Attribute codes that compose the attribute group","x-validation-rules":"Each string of the array is an existing attribute code, an attribute can only be in one attribute group","items":{"type":"string"},"default":[]},"labels":{"type":"object","description":"Attribute group labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute group label for the locale `localeCode`"}}}},"example":{"code":"marketing","sort_order":4,"attributes":["sku","name","description","response_time","release_date","price"],"labels":{"en_US":"Marketing","fr_FR":"Marketing"}}}}],"responses":{"200":{"description":"OK","x-details":"Returns a plain text response whose lines are JSON containing the status of each update or creation","schema":{"type":"object","properties":{"line":{"type":"integer","description":"Line number"},"identifier":{"type":"string","description":"Resource identifier, only filled when the resource is a product"},"code":{"type":"string","description":"Resource code, only filled when the resource is not a product"},"status_code":{"type":"integer","description":"HTTP status code, see Client errors to understand the meaning of each code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"x-example-1":"{\"line\":1,\"code\":\"technical\",\"status_code\":201}","x-example-2":"{\"line\":2,\"code\":\"marketing\",\"status_code\":422,\"message\":\"Property \\\"type\\\" does not exist. Check the standard format documentation.\",\"_links\":{\"documentation\":{\"href\":\"http:\\/\\/api.akeneo.com\\/api-reference.html#patch_attribute_groups__code_\"}}}","x-example-3":"{\"line\":3,\"code\":\"design\",\"status_code\":204}"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"413":{"description":"Request Entity Too Large","x-details":"There are too many resources to process (max 100) or the line of JSON is too long (max 1 000 000 characters)","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":413,"message":"Too many resources to process, 100 is the maximum allowed."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/vnd.akeneo.collection+json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/vnd.akeneo.collection+json’ is allowed."}}}}},"/api/rest/v1/attribute-groups/{code}":{"get":{"summary":"Get an attribute group","operationId":"attribute_groups_get","description":"This endpoint allows you to get the information about a given attribute group.","tags":["Attribute group"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the attribute group in JSON standard format","schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Attribute group code","x-immutable":true},"sort_order":{"type":"integer","description":"Attribute group order among other attribute groups","x-validation-rules":"It is a positive integer","default":0},"attributes":{"type":"array","description":"Attribute codes that compose the attribute group","x-validation-rules":"Each string of the array is an existing attribute code, an attribute can only be in one attribute group","items":{"type":"string"},"default":[]},"labels":{"type":"object","description":"Attribute group labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute group label for the locale `localeCode`"}}}},"example":{"code":"marketing","sort_order":4,"attributes":["sku","name","description","response_time","release_date","price"],"labels":{"en_US":"Marketing","fr_FR":"Marketing"}}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"patch":{"summary":"Update/create an attribute group","operationId":"attribute_groups_patch","tags":["Attribute group"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to update a given attribute group. Know more about Update behavior. Note that if no attribute group exists for the given code, it creates it.","parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"},{"name":"body","in":"body","required":true,"schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Attribute group code","x-immutable":true},"sort_order":{"type":"integer","description":"Attribute group order among other attribute groups","x-validation-rules":"It is a positive integer","default":0},"attributes":{"type":"array","description":"Attribute codes that compose the attribute group","x-validation-rules":"Each string of the array is an existing attribute code, an attribute can only be in one attribute group","items":{"type":"string"},"default":[]},"labels":{"type":"object","description":"Attribute group labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute group label for the locale `localeCode`"}}}},"example":{"code":"marketing","sort_order":4,"attributes":["sku","name","description","response_time","release_date","price"],"labels":{"en_US":"Marketing","fr_FR":"Marketing"}}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"204":{"description":"No content to return","x-details":"Means that the update was successful","headers":{"Location":{"description":"URI of the updated resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/association-types":{"get":{"summary":"Get a list of association types","operationId":"association_types_get_list","description":"This endpoint allows you to get a list of association types. Association types are paginated and sorted by code.","tags":["Association type"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"page","in":"query","description":"Number of the page to retrieve when using the `page` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"integer","default":1},{"name":"limit","in":"query","description":"Number of results by page, see Pagination section","required":false,"type":"integer","minimum":1,"maximum":100,"default":10},{"name":"with_count","in":"query","description":"Return the count of items in the response. Be carefull with that, on a big catalog, it can decrease performance in a significative way","default":false,"type":"boolean","required":false}],"responses":{"200":{"description":"Return association types paginated","schema":{"title":"Association types","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"previous":{"type":"object","properties":{"href":{"type":"string","description":"URI of the previous page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}},"current_page":{"type":"integer","description":"Current page number"}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Association type code","x-immutable":true},"labels":{"type":"object","description":"Association type labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Association type label for the locale `localeCode`"}}},"is_quantified":{"type":"boolean","description":"When true, the association is a quantified association (Only available in the PIM Serenity version.)","default":false,"x-immutable":true},"is_two_way":{"type":"boolean","description":"When true, the association is a two-way association (Only available in the PIM Serenity version.)","default":false,"x-immutable":true}},"example":{"code":"upsell","labels":{"en_US":"Upsell","fr_FR":"Vente incitative"},"is_quantified":false,"is_two_way":false}}]}}}}}}]},"examples":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/association-types?page=1&limit=3"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/association-types?page=1&limit=3"}},"current_page":1,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/association-types/X_SELL"}},"code":"X_SELL","labels":{"en_US":"Cross sell","fr_FR":"Vente croisée"},"is_quantified":false,"is_two_way":false},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/association-types/UPSELL"}},"code":"UPSELL","labels":{"en_US":"Upsell","fr_FR":"Vente incitative"},"is_quantified":false,"is_two_way":false},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/association-types/SUBSTITUTION"}},"code":"SUBSTITUTION","labels":{"en_US":"Substitution","fr_FR":"Remplacement"},"is_quantified":false,"is_two_way":false}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"post":{"summary":"Create a new association type","operationId":"association_types_post","description":"This endpoint allows you to create a new association type.","tags":["Association type"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Association type code","x-immutable":true},"labels":{"type":"object","description":"Association type labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Association type label for the locale `localeCode`"}}},"is_quantified":{"type":"boolean","description":"When true, the association is a quantified association (Only available in the PIM Serenity version.)","default":false,"x-immutable":true},"is_two_way":{"type":"boolean","description":"When true, the association is a two-way association (Only available in the PIM Serenity version.)","default":false,"x-immutable":true}},"example":{"code":"upsell","labels":{"en_US":"Upsell","fr_FR":"Vente incitative"},"is_quantified":false,"is_two_way":false}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}},"patch":{"summary":"Update/create several association types","operationId":"several_association_types_patch","tags":["Association type"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to update and/or create several association types at once.","x-body-by-line":"Contains several lines, each line is an association type in JSON standard format","parameters":[{"name":"body","in":"body","schema":{"x-examples":{"x-example-1":"{\"code\":\"new_sell\"}","x-example-2":"{\"code\":\"substitution\", \"type\":\"bar\"}","x-example-3":"{\"code\":\"x_cross_sell\", \"is_two_way\": true, \"is_quantified\": false}"},"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Association type code","x-immutable":true},"labels":{"type":"object","description":"Association type labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Association type label for the locale `localeCode`"}}},"is_quantified":{"type":"boolean","description":"When true, the association is a quantified association (Only available in the PIM Serenity version.)","default":false,"x-immutable":true},"is_two_way":{"type":"boolean","description":"When true, the association is a two-way association (Only available in the PIM Serenity version.)","default":false,"x-immutable":true}},"example":{"code":"upsell","labels":{"en_US":"Upsell","fr_FR":"Vente incitative"},"is_quantified":false,"is_two_way":false}}}],"responses":{"200":{"description":"OK","x-details":"Returns a plain text response whose lines are JSON containing the status of each update or creation","schema":{"type":"object","properties":{"line":{"type":"integer","description":"Line number"},"identifier":{"type":"string","description":"Resource identifier, only filled when the resource is a product"},"code":{"type":"string","description":"Resource code, only filled when the resource is not a product"},"status_code":{"type":"integer","description":"HTTP status code, see Client errors to understand the meaning of each code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"x-example-1":"{\"line\":1,\"code\":\"new_sell\",\"status_code\":201}","x-example-2":"{\"line\":2,\"code\":\"substitution\",\"status_code\":422,\"message\":\"Property \\\"type\\\" does not exist. Check the standard format documentation.\",\"_links\":{\"documentation\":{\"href\":\"http:\\/\\/api.akeneo.com\\/api-reference.html#patch_association_types__code_\"}}}","x-example-3":"{\"line\":3,\"code\":\"x_cross_sell\",\"status_code\":204}"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"413":{"description":"Request Entity Too Large","x-details":"There are too many resources to process (max 100) or the line of JSON is too long (max 1 000 000 characters)","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":413,"message":"Too many resources to process, 100 is the maximum allowed."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/vnd.akeneo.collection+json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/vnd.akeneo.collection+json’ is allowed."}}}}},"/api/rest/v1/association-types/{code}":{"get":{"summary":"Get an association type","operationId":"association_types_get","description":"This endpoint allows you to get the information about a given association type.","tags":["Association type"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the association type in JSON standard format","schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Association type code","x-immutable":true},"labels":{"type":"object","description":"Association type labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Association type label for the locale `localeCode`"}}},"is_quantified":{"type":"boolean","description":"When true, the association is a quantified association (Only available in the PIM Serenity version.)","default":false,"x-immutable":true},"is_two_way":{"type":"boolean","description":"When true, the association is a two-way association (Only available in the PIM Serenity version.)","default":false,"x-immutable":true}},"example":{"code":"upsell","labels":{"en_US":"Upsell","fr_FR":"Vente incitative"},"is_quantified":false,"is_two_way":false}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"patch":{"summary":"Update/create an association type","operationId":"association_types_patch","tags":["Association type"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to update a given association type. Know more about Update behavior. Note that if no association type exists for the given code, it creates it.","parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"},{"name":"body","in":"body","required":true,"schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Association type code","x-immutable":true},"labels":{"type":"object","description":"Association type labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Association type label for the locale `localeCode`"}}},"is_quantified":{"type":"boolean","description":"When true, the association is a quantified association (Only available in the PIM Serenity version.)","default":false,"x-immutable":true},"is_two_way":{"type":"boolean","description":"When true, the association is a two-way association (Only available in the PIM Serenity version.)","default":false,"x-immutable":true}},"example":{"code":"upsell","labels":{"en_US":"Upsell","fr_FR":"Vente incitative"},"is_quantified":false,"is_two_way":false}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"204":{"description":"No content to return","x-details":"Means that the update was successful","headers":{"Location":{"description":"URI of the updated resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/channels":{"get":{"summary":"Get a list of channels","operationId":"get_channels","description":"This endpoint allows you to get a list of channels. Channels are paginated and sorted by code.","tags":["Channel"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"page","in":"query","description":"Number of the page to retrieve when using the `page` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"integer","default":1},{"name":"limit","in":"query","description":"Number of results by page, see Pagination section","required":false,"type":"integer","minimum":1,"maximum":100,"default":10},{"name":"with_count","in":"query","description":"Return the count of items in the response. Be carefull with that, on a big catalog, it can decrease performance in a significative way","default":false,"type":"boolean","required":false}],"responses":{"200":{"description":"Return channels paginated","schema":{"title":"Channels","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"previous":{"type":"object","properties":{"href":{"type":"string","description":"URI of the previous page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}},"current_page":{"type":"integer","description":"Current page number"}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code","category_tree","locales","currencies"],"properties":{"code":{"type":"string","description":"Channel code","x-immutable":true},"locales":{"type":"array","description":"Codes of activated locales for the channel","x-validation-rules":"• Each string of the array is an existing locale code • At least one locale in the array","items":{"type":"string"}},"currencies":{"type":"array","description":"Codes of activated currencies for the channel","x-validation-rules":"• Each string of the array is an existing currency code • At least one currency in the array","items":{"type":"string"}},"category_tree":{"type":"string","description":"Code of the category tree linked to the channel","x-validation-rules":"It is the code of an existing category code that is a tree (a category without parent)"},"conversion_units":{"type":"object","description":"Units to which the given metric attributes should be converted when exporting products","x-validation-rules":"• The `attributeCode` is the code of an existing attribute whose type is `pim_catalog_metric` • The strings are existing unit codes.","properties":{"attributeCode":{"type":"string","description":"Conversion unit code used to convert the values of the attribute `attributeCode` when exporting via the channel"}}},"labels":{"type":"object","description":"Channel labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Channel label for the locale `localeCode`"}}}},"example":{"code":"ecommerce","currencies":["USD","EUR"],"locales":["de_DE","en_US","fr_FR"],"category_tree":"master","conversion_units":{"weight":"KILOGRAM"},"labels":{"en_US":"Ecommerce","de_DE":"Ecommerce","fr_FR":"Ecommerce"}}}]}}}}}}]},"examples":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/channels?page=1&limit=3"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/channels?page=1&limit=3"}},"current_page":1,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/channels/ecommerce"}},"code":"ecommerce","currencies":["USD","EUR"],"locales":["en_US","fr_FR","de_DE"],"category_tree":"master","conversion_units":{"a_metric":"KILOWATT","a_metric_negative":"CELSIUS","a_metric_to_not_convert":null},"labels":{"en_US":"Ecommerce","fr_FR":"E-commerce","de_DE":"E-commerce"}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/channels/mobile"}},"code":"mobile","currencies":["USD","EUR"],"locales":["en_US","fr_FR","de_DE"],"category_tree":"master","conversion_units":{"a_metric":"KILOWATT","a_metric_negative":"CELSIUS","a_metric_to_not_convert":null},"labels":{"en_US":"Mobile","fr_FR":"Mobile","de_DE":"Mobile"}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/channels/print"}},"code":"print","currencies":["USD","EUR"],"locales":["en_US","fr_FR","de_DE"],"category_tree":"master","conversion_units":{},"labels":{"en_US":"Print","fr_FR":"Print","de_DE":"Print"}}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"post":{"summary":"Create a new channel","operationId":"channels_post","description":"This endpoint allows you to create a new channel.","tags":["Channel"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","required":["code","category_tree","locales","currencies"],"properties":{"code":{"type":"string","description":"Channel code","x-immutable":true},"locales":{"type":"array","description":"Codes of activated locales for the channel","x-validation-rules":"• Each string of the array is an existing locale code • At least one locale in the array","items":{"type":"string"}},"currencies":{"type":"array","description":"Codes of activated currencies for the channel","x-validation-rules":"• Each string of the array is an existing currency code • At least one currency in the array","items":{"type":"string"}},"category_tree":{"type":"string","description":"Code of the category tree linked to the channel","x-validation-rules":"It is the code of an existing category code that is a tree (a category without parent)"},"conversion_units":{"type":"object","description":"Units to which the given metric attributes should be converted when exporting products","x-validation-rules":"• The `attributeCode` is the code of an existing attribute whose type is `pim_catalog_metric` • The strings are existing unit codes.","properties":{"attributeCode":{"type":"string","description":"Conversion unit code used to convert the values of the attribute `attributeCode` when exporting via the channel"}}},"labels":{"type":"object","description":"Channel labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Channel label for the locale `localeCode`"}}}},"example":{"code":"ecommerce","currencies":["USD","EUR"],"locales":["de_DE","en_US","fr_FR"],"category_tree":"master","conversion_units":{"weight":"KILOGRAM"},"labels":{"en_US":"Ecommerce","de_DE":"Ecommerce","fr_FR":"Ecommerce"}}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}},"patch":{"summary":"Update/create several channels","operationId":"several_channels_patch","tags":["Channel"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to update and/or create several channels at once.","x-body-by-line":"Contains several lines, each line is a channel in JSON standard format","parameters":[{"name":"body","in":"body","schema":{"x-examples":{"x-example-1":"{\"code\":\"ecommerce_fr\", \"category_tree\": \"master\", \"currencies\": [\"EUR\"], \"locales\": [\"fr_FR\"], \"labels\":{\"fr_FR\": \"Ecommerce Fr\"}}","x-example-2":"{\"code\":\"ecommerce_ch\", \"type\":\"bar\"}","x-example-3":"{\"code\":\"tablet\", \"labels\":{\"en_US\": \"Tablet\", \"fr_FR\": \"Tablette\"}}"},"type":"object","required":["code","category_tree","locales","currencies"],"properties":{"code":{"type":"string","description":"Channel code","x-immutable":true},"locales":{"type":"array","description":"Codes of activated locales for the channel","x-validation-rules":"• Each string of the array is an existing locale code • At least one locale in the array","items":{"type":"string"}},"currencies":{"type":"array","description":"Codes of activated currencies for the channel","x-validation-rules":"• Each string of the array is an existing currency code • At least one currency in the array","items":{"type":"string"}},"category_tree":{"type":"string","description":"Code of the category tree linked to the channel","x-validation-rules":"It is the code of an existing category code that is a tree (a category without parent)"},"conversion_units":{"type":"object","description":"Units to which the given metric attributes should be converted when exporting products","x-validation-rules":"• The `attributeCode` is the code of an existing attribute whose type is `pim_catalog_metric` • The strings are existing unit codes.","properties":{"attributeCode":{"type":"string","description":"Conversion unit code used to convert the values of the attribute `attributeCode` when exporting via the channel"}}},"labels":{"type":"object","description":"Channel labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Channel label for the locale `localeCode`"}}}},"example":{"code":"ecommerce","currencies":["USD","EUR"],"locales":["de_DE","en_US","fr_FR"],"category_tree":"master","conversion_units":{"weight":"KILOGRAM"},"labels":{"en_US":"Ecommerce","de_DE":"Ecommerce","fr_FR":"Ecommerce"}}}}],"responses":{"200":{"description":"OK","x-details":"Returns a plain text response whose lines are JSON containing the status of each update or creation","schema":{"type":"object","properties":{"line":{"type":"integer","description":"Line number"},"identifier":{"type":"string","description":"Resource identifier, only filled when the resource is a product"},"code":{"type":"string","description":"Resource code, only filled when the resource is not a product"},"status_code":{"type":"integer","description":"HTTP status code, see Client errors to understand the meaning of each code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"x-example-1":"{\"line\":1,\"code\":\"ecommerce_fr\",\"status_code\":201}","x-example-2":"{\"line\":2,\"code\":\"ecommerce_ch\",\"status_code\":422,\"message\":\"Property \\\"type\\\" does not exist. Check the standard format documentation.\",\"_links\":{\"documentation\":{\"href\":\"http:\\/\\/api.akeneo.com\\/api-reference.html#patch_channels__code_\"}}}","x-example-3":"{\"line\":3,\"code\":\"tablet\",\"status_code\":204}"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"413":{"description":"Request Entity Too Large","x-details":"There are too many resources to process (max 100) or the line of JSON is too long (max 1 000 000 characters)","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":413,"message":"Too many resources to process, 100 is the maximum allowed."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/vnd.akeneo.collection+json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/vnd.akeneo.collection+json’ is allowed."}}}}},"/api/rest/v1/channels/{code}":{"get":{"summary":"Get a channel","operationId":"get_channels__code_","description":"This endpoint allows you to get the information about a given channel.","tags":["Channel"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the channel in JSON standard format","schema":{"type":"object","required":["code","category_tree","locales","currencies"],"properties":{"code":{"type":"string","description":"Channel code","x-immutable":true},"locales":{"type":"array","description":"Codes of activated locales for the channel","x-validation-rules":"• Each string of the array is an existing locale code • At least one locale in the array","items":{"type":"string"}},"currencies":{"type":"array","description":"Codes of activated currencies for the channel","x-validation-rules":"• Each string of the array is an existing currency code • At least one currency in the array","items":{"type":"string"}},"category_tree":{"type":"string","description":"Code of the category tree linked to the channel","x-validation-rules":"It is the code of an existing category code that is a tree (a category without parent)"},"conversion_units":{"type":"object","description":"Units to which the given metric attributes should be converted when exporting products","x-validation-rules":"• The `attributeCode` is the code of an existing attribute whose type is `pim_catalog_metric` • The strings are existing unit codes.","properties":{"attributeCode":{"type":"string","description":"Conversion unit code used to convert the values of the attribute `attributeCode` when exporting via the channel"}}},"labels":{"type":"object","description":"Channel labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Channel label for the locale `localeCode`"}}}},"example":{"code":"ecommerce","currencies":["USD","EUR"],"locales":["de_DE","en_US","fr_FR"],"category_tree":"master","conversion_units":{"weight":"KILOGRAM"},"labels":{"en_US":"Ecommerce","de_DE":"Ecommerce","fr_FR":"Ecommerce"}}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"patch":{"summary":"Update/create a channel","operationId":"channels_patch","tags":["Channel"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to update a given channel. Know more about Update behavior. Note that if no channel exists for the given code, it creates it.","parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"},{"name":"body","in":"body","required":true,"schema":{"type":"object","required":["code","category_tree","locales","currencies"],"properties":{"code":{"type":"string","description":"Channel code","x-immutable":true},"locales":{"type":"array","description":"Codes of activated locales for the channel","x-validation-rules":"• Each string of the array is an existing locale code • At least one locale in the array","items":{"type":"string"}},"currencies":{"type":"array","description":"Codes of activated currencies for the channel","x-validation-rules":"• Each string of the array is an existing currency code • At least one currency in the array","items":{"type":"string"}},"category_tree":{"type":"string","description":"Code of the category tree linked to the channel","x-validation-rules":"It is the code of an existing category code that is a tree (a category without parent)"},"conversion_units":{"type":"object","description":"Units to which the given metric attributes should be converted when exporting products","x-validation-rules":"• The `attributeCode` is the code of an existing attribute whose type is `pim_catalog_metric` • The strings are existing unit codes.","properties":{"attributeCode":{"type":"string","description":"Conversion unit code used to convert the values of the attribute `attributeCode` when exporting via the channel"}}},"labels":{"type":"object","description":"Channel labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Channel label for the locale `localeCode`"}}}},"example":{"code":"ecommerce","currencies":["USD","EUR"],"locales":["de_DE","en_US","fr_FR"],"category_tree":"master","conversion_units":{"weight":"KILOGRAM"},"labels":{"en_US":"Ecommerce","de_DE":"Ecommerce","fr_FR":"Ecommerce"}}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"204":{"description":"No content to return","x-details":"Means that the update was successful","headers":{"Location":{"description":"URI of the updated resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/locales":{"get":{"summary":"Get a list of locales","operationId":"get_locales","description":"This endpoint allows you to get a list of locales. Locales are paginated and sorted by code.","tags":["Locale"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"search","in":"query","description":"Filter locales, for more details see the Filters section","required":false,"type":"string"},{"name":"page","in":"query","description":"Number of the page to retrieve when using the `page` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"integer","default":1},{"name":"limit","in":"query","description":"Number of results by page, see Pagination section","required":false,"type":"integer","minimum":1,"maximum":100,"default":10},{"name":"with_count","in":"query","description":"Return the count of items in the response. Be carefull with that, on a big catalog, it can decrease performance in a significative way","default":false,"type":"boolean","required":false}],"responses":{"200":{"description":"Return locales paginated","schema":{"title":"Locales","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"previous":{"type":"object","properties":{"href":{"type":"string","description":"URI of the previous page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}},"current_page":{"type":"integer","description":"Current page number"}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Locale code","x-immutable":true},"enabled":{"type":"boolean","description":"Whether the locale is enabled","default":false}},"example":{"code":"en_US","enable":true}}]}}}}}}]},"examples":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/locales?page=2&limit=4"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/locales?page=1&limit=4"},"previous":{"href":"https://demo.akeneo.com/api/rest/v1/locales?page=1&limit=4"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/locales?page=2&limit=4"}},"current_page":2,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/locales/en_US"}},"code":"en_US","enabled":true},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/locales/fr_FR"}},"code":"fr_FR","enabled":true},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/locales/de_DE"}},"code":"de_DE","enabled":true},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/locales/af_ZA"}},"code":"af_ZA","enabled":false}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}}},"/api/rest/v1/locales/{code}":{"get":{"summary":"Get a locale","operationId":"get_locales__code_","description":"This endpoint allows you to get the information about a given locale.","tags":["Locale"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the locale in JSON standard format","schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Locale code","x-immutable":true},"enabled":{"type":"boolean","description":"Whether the locale is enabled","default":false}},"example":{"code":"en_US","enable":true}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}}},"/api/rest/v1/categories":{"get":{"summary":"Get list of categories","operationId":"get_categories","description":"This endpoint allows you to get a list of categories. Categories are paginated and sorted by `root/left`.","tags":["Category"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"search","in":"query","description":"Filter categories, for more details see the Filters section.","required":false,"type":"string"},{"name":"page","in":"query","description":"Number of the page to retrieve when using the `page` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"integer","default":1},{"name":"limit","in":"query","description":"Number of results by page, see Pagination section","required":false,"type":"integer","minimum":1,"maximum":100,"default":10},{"name":"with_count","in":"query","description":"Return the count of items in the response. Be carefull with that, on a big catalog, it can decrease performance in a significative way","default":false,"type":"boolean","required":false},{"name":"with_position","in":"query","description":"Return information about category position into its category tree (only available since the 7.0 version)","required":false,"type":"boolean","x-from-version":"7.0"},{"name":"with_enriched_attributes","in":"query","description":"Return attribute values of the category (only available on SaaS platforms)","required":false,"type":"boolean","x-from-version":"SaaS"}],"responses":{"200":{"description":"Return categories paginated","schema":{"title":"Categories","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"previous":{"type":"object","properties":{"href":{"type":"string","description":"URI of the previous page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}},"current_page":{"type":"integer","description":"Current page number"}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Category code","x-immutable":true},"parent":{"type":"string","description":"Category code of the parent's category","x-validation-rules":"• It is either equal to `null` or to an existing category code. • If equal to an existing category code, it cannot reference itself.","default":"null"},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"position":{"type":"integer","description":"Position of the category in its level, start from 1 (only available since the 7.0 version and when query parameter \"with_position\" is set to \"true\")","x-read-only":true},"labels":{"type":"object","description":"Category labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Category label for the locale `localeCode`"}}},"values":{"type":"object","description":"Attribute values","default":null,"properties":{"attributeCode|attributeUuid|channelCode|localeCode":{"type":"array","items":{"type":"object","properties":{"data":{"type":"object","description":"Attribute value"},"type":{"type":"string","description":"The attribute type"},"locale":{"type":"string","description":"Locale code of the attribute value"},"channel":{"type":"string","description":"Channel code of the attribute value"},"attribute_code":{"type":"string","description":"The attribute code with its uuid (attributeCode|attributeUuid)"}}}}}}},"example":{"code":"winter_collection","parent":null,"updated":"2021-05-22T12:48:00+02:00","position":1,"labels":{"en_US":"Winter collection","fr_FR":"Collection hiver"},"values":{"description|96b88bf4-c2b7-4b64-a1f9-5d4876c02c26|ecommerce|en_US":{"data":"

Winter collection description

\n","type":"textarea","channel":"ecommerce","locale":"en_US","attribute_code":"description|96b88bf4-c2b7-4b64-a1f9-5d4876c02c26"},"image_1|871b8686-79b5-415c-9c6f-a38f8732dfb7|ecommerce|en_US":{"data":{"size":1401359,"extension":"jpg","file_path":"2/d/c/7/2dc791671d726e7438219d5dc7fd51a53d6bf2bb_IMG_7860.jpg","mime_type":"image/jpeg","original_filename":"IMG_7860.jpg"},"type":"image","channel":"ecommerce","locale":"en_US","attribute_code":"image_1|871b8686-79b5-415c-9c6f-a38f8732dfb7"}}}}]}}}}}}]},"examples":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/categories?page=2&limit=5"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/categories?page=1&limit=5"},"previous":{"href":"https://demo.akeneo.com/api/rest/v1/categories?page=1&limit=5"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/categories?page=3&limit=5"}},"current_page":2,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/categories/winter_collection"}},"code":"winter_collection","parent":null,"updated":"2021-05-21T11:32:00+02:00","position":1,"labels":{"en_US":"Winter collection","fr_FR":"Collection hiver","de_DE":"Winter-Kollektion"},"values":{"description|96b88bf4-c2b7-4b64-a1f9-5d4876c02c26|ecommerce|en_US":{"data":"

Winter collection description

\n","type":"textarea","channel":"ecommerce","locale":"en_US","attribute_code":"description|96b88bf4-c2b7-4b64-a1f9-5d4876c02c26"},"image_1|871b8686-79b5-415c-9c6f-a38f8732dfb7|ecommerce|en_US":{"data":{"size":1401359,"extension":"jpg","file_path":"2/d/c/7/2dc791671d726e7438219d5dc7fd51a53d6bf2bb_IMG_7860.jpg","mime_type":"image/jpeg","original_filename":"IMG_7860.jpg"},"type":"image","channel":"ecommerce","locale":"en_US","attribute_code":"image_1|871b8686-79b5-415c-9c6f-a38f8732dfb7"}}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/categories/woman"}},"code":"woman","parent":"winter_collection","updated":"2021-04-21T10:41:02+02:00","position":1,"labels":{"en_US":"Woman","fr_FR":"Femme","de_DE":"Damen"},"values":{}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/categories/man"}},"code":"man","parent":"winter_collection","updated":"2021-03-02T12:59:59+02:00","position":2,"labels":{"en_US":"Man","fr_FR":"Homme","de_DE":"Herren"},"values":{}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/categories/kids"}},"code":"kids","parent":"winter_collection","updated":"2021-01-03T12:40:00+02:00","position":3,"labels":{"en_US":"Kids","fr_FR":"Enfant","de_DE":"Kinder"},"values":{}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/categories/summer_collection"}},"code":"summer_collection","parent":null,"updated":"2021-04-04T09:42:00+02:00","position":1,"labels":{"en_US":"Summer collection","fr_FR":"Collection été","de_DE":"Sommer-Kollektion"},"values":{}}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"post":{"summary":"Create a new category","operationId":"post_categories","description":"This endpoint allows you to create a new category.","tags":["Category"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Category code","x-immutable":true},"parent":{"type":"string","description":"Category code of the parent's category","x-validation-rules":"• It is either equal to `null` or to an existing category code. • If equal to an existing category code, it cannot reference itself.","default":"null"},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"position":{"type":"integer","description":"Position of the category in its level, start from 1 (only available since the 7.0 version and when query parameter \"with_position\" is set to \"true\")","x-read-only":true},"labels":{"type":"object","description":"Category labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Category label for the locale `localeCode`"}}},"values":{"type":"array","description":"Attribute values (only available on SaaS).","default":[],"items":{"type":"object","properties":{"data":{"type":"string","description":"Attribute value. It should be a `string` for Text and Text Area attributes, a `boolean` for Yes/No attribute and for Image attribute use the create category media file endpoint. It can also be `null` to remove the value."},"locale":{"type":"string","description":"Locale code of the attribute value."},"channel":{"type":"string","description":"Channel code of the attribute value."},"attribute_code":{"type":"string","description":"The attribute code."}}}}},"example":{"code":"winter_collection","parent":null,"labels":{"en_US":"Winter collection","fr_FR":"Collection hiver"},"values":[{"data":"

Winter collection description

","channel":"ecommerce","locale":"en_US","attribute_code":"a_text_area_attribute"},{"data":false,"channel":"ecommerce","locale":null,"attribute_code":"a_boolean_attribute"},{"data":null,"channel":null,"locale":null,"attribute_code":"an_image_attribute"}]}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}},"patch":{"summary":"Update/create several categories","operationId":"patch_categories","tags":["Category"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to update several categories at once.","x-body-by-line":"Contains several lines, each line is a category in JSON standard format","parameters":[{"name":"body","in":"body","schema":{"x-examples":{"x-example-1":"{\"code\":\"spring_collection\",\"parent\":null}","x-example-2":"{\"code\":\"woman\",\"parent\":\"spring_collectionn\"}","x-example-3":"{\"code\":\"man\",\"parent\":\"spring_collection\"}"},"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Category code","x-immutable":true},"parent":{"type":"string","description":"Category code of the parent's category","x-validation-rules":"• It is either equal to `null` or to an existing category code. • If equal to an existing category code, it cannot reference itself.","default":"null"},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"position":{"type":"integer","description":"Position of the category in its level, start from 1 (only available since the 7.0 version and when query parameter \"with_position\" is set to \"true\")","x-read-only":true},"labels":{"type":"object","description":"Category labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Category label for the locale `localeCode`"}}},"values":{"type":"array","description":"Attribute values (only available on SaaS).","default":[],"items":{"type":"object","properties":{"data":{"type":"string","description":"Attribute value. It should be a `string` for Text and Text Area attributes, a `boolean` for Yes/No attribute and for Image attribute use the create category media file endpoint. It can also be `null` to remove the value."},"locale":{"type":"string","description":"Locale code of the attribute value."},"channel":{"type":"string","description":"Channel code of the attribute value."},"attribute_code":{"type":"string","description":"The attribute code."}}}}},"example":{"code":"winter_collection","parent":null,"labels":{"en_US":"Winter collection","fr_FR":"Collection hiver"},"values":[{"data":"

Winter collection description

","channel":"ecommerce","locale":"en_US","attribute_code":"a_text_area_attribute"},{"data":false,"channel":"ecommerce","locale":null,"attribute_code":"a_boolean_attribute"},{"data":null,"channel":null,"locale":null,"attribute_code":"an_image_attribute"}]}}}],"responses":{"200":{"description":"OK","x-details":"Returns a plain text response whose lines are JSON containing the status of each update or creation","x-no-entity":true,"schema":{"type":"object","properties":{"line":{"type":"integer","description":"Line number"},"identifier":{"type":"string","description":"Resource identifier, only filled when the resource is a product"},"code":{"type":"string","description":"Resource code, only filled when the resource is not a product"},"status_code":{"type":"integer","description":"HTTP status code, see Client errors to understand the meaning of each code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"x-example-1":"{\"line\":1,\"code\":\"spring_collection\",\"status_code\":201}","x-example-2":"{\"line\":2,\"code\":\"woman\",\"status_code\":422,\"message\":\"Category \\\"spring_collectionn\\\" does not exist.\"}","x-example-3":"{\"line\":3,\"code\":\"man\",\"status_code\":204}"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"413":{"description":"Request Entity Too Large","x-details":"There are too many resources to process (max 100) or the line of JSON is too long (max 1 000 000 characters)","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":413,"message":"Too many resources to process, 100 is the maximum allowed."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/vnd.akeneo.collection+json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/vnd.akeneo.collection+json’ is allowed."}}}}},"/api/rest/v1/categories/{code}":{"get":{"summary":"Get a category","operationId":"get_categories__code_","description":"This endpoint allows you to get the information about a given category.","tags":["Category"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"},{"name":"with_position","in":"query","description":"Return information about category position into its category tree (only available since the 7.0 version)","required":false,"type":"boolean","x-from-version":"7.0"},{"name":"with_enriched_attributes","in":"query","description":"Return attribute values of the category (only available on SaaS platforms)","required":false,"type":"boolean","x-from-version":"SaaS"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the category in JSON standard format","schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Category code","x-immutable":true},"parent":{"type":"string","description":"Category code of the parent's category","x-validation-rules":"• It is either equal to `null` or to an existing category code. • If equal to an existing category code, it cannot reference itself.","default":"null"},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"position":{"type":"integer","description":"Position of the category in its level, start from 1 (only available since the 7.0 version and when query parameter \"with_position\" is set to \"true\")","x-read-only":true},"labels":{"type":"object","description":"Category labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Category label for the locale `localeCode`"}}},"values":{"type":"object","description":"Attribute values","default":null,"properties":{"attributeCode|attributeUuid|channelCode|localeCode":{"type":"array","items":{"type":"object","properties":{"data":{"type":"object","description":"Attribute value"},"type":{"type":"string","description":"The attribute type"},"locale":{"type":"string","description":"Locale code of the attribute value"},"channel":{"type":"string","description":"Channel code of the attribute value"},"attribute_code":{"type":"string","description":"The attribute code with its uuid (attributeCode|attributeUuid)"}}}}}}},"example":{"code":"winter_collection","parent":null,"updated":"2021-05-22T12:48:00+02:00","position":1,"labels":{"en_US":"Winter collection","fr_FR":"Collection hiver"},"values":{"description|96b88bf4-c2b7-4b64-a1f9-5d4876c02c26|ecommerce|en_US":{"data":"

Winter collection description

\n","type":"textarea","channel":"ecommerce","locale":"en_US","attribute_code":"description|96b88bf4-c2b7-4b64-a1f9-5d4876c02c26"},"image_1|871b8686-79b5-415c-9c6f-a38f8732dfb7|ecommerce|en_US":{"data":{"size":1401359,"extension":"jpg","file_path":"2/d/c/7/2dc791671d726e7438219d5dc7fd51a53d6bf2bb_IMG_7860.jpg","mime_type":"image/jpeg","original_filename":"IMG_7860.jpg"},"type":"image","channel":"ecommerce","locale":"en_US","attribute_code":"image_1|871b8686-79b5-415c-9c6f-a38f8732dfb7"}}}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"patch":{"summary":"Update/create a category","operationId":"patch_categories__code_","tags":["Category"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to update a given category. Know more about Update behavior. Note that if no category exists for the given code, it creates it.","parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"},{"name":"body","in":"body","required":true,"schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Category code","x-immutable":true},"parent":{"type":"string","description":"Category code of the parent's category","x-validation-rules":"• It is either equal to `null` or to an existing category code. • If equal to an existing category code, it cannot reference itself.","default":"null"},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"position":{"type":"integer","description":"Position of the category in its level, start from 1 (only available since the 7.0 version and when query parameter \"with_position\" is set to \"true\")","x-read-only":true},"labels":{"type":"object","description":"Category labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Category label for the locale `localeCode`"}}},"values":{"type":"array","description":"Attribute values (only available on SaaS).","default":[],"items":{"type":"object","properties":{"data":{"type":"string","description":"Attribute value. It should be a `string` for Text and Text Area attributes, a `boolean` for Yes/No attribute and for Image attribute use the create category media file endpoint. It can also be `null` to remove the value."},"locale":{"type":"string","description":"Locale code of the attribute value."},"channel":{"type":"string","description":"Channel code of the attribute value."},"attribute_code":{"type":"string","description":"The attribute code."}}}}},"example":{"code":"winter_collection","parent":null,"labels":{"en_US":"Winter collection","fr_FR":"Collection hiver"},"values":[{"data":"

Winter collection description

","channel":"ecommerce","locale":"en_US","attribute_code":"a_text_area_attribute"},{"data":false,"channel":"ecommerce","locale":null,"attribute_code":"a_boolean_attribute"},{"data":null,"channel":null,"locale":null,"attribute_code":"an_image_attribute"}]}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"204":{"description":"No content to return","x-details":"Means that the update was successful","headers":{"Location":{"description":"URI of the updated resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/category-media-files":{"post":{"summary":"Create a category media file","operationId":"post_category_media_files","description":"This endpoint allows you to create a new media file and associate it to an attribute value of a given enriched category.","tags":["Category"],"x-versions":["SaaS"],"parameters":[{"name":"Content-type","in":"header","type":"string","description":"Equal to 'multipart/form-data'.","required":true},{"name":"body","in":"body","x-form-data":true,"schema":{"required":["file"],"properties":{"category":{"type":"string","description":"The category to which the media file will be associated. It is a JSON string that follows this format '{\"code\":\"category code\", \"attribute_code\":\"attribute code\", \"channel\":\"channel code or null\", \"locale\":\"locale code or null\"}'."},"file":{"type":"string","description":"The binary of the file.","format":"binary"}}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `multipart/form-data`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘multipart/form-data’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/category-media-files/{file_path}/download":{"get":{"summary":"Download a category media file","operationId":"get_category_media_files__file_path__download","description":"This endpoint allows you to download a given media file that is used as an attribute value of a enriched category.","x-content-type":"Mime-type of the media file","tags":["Category"],"x-versions":["SaaS"],"parameters":[{"name":"file_path","in":"path","description":"Path of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the binary of the media file","x-content-type":"Mime-type of the media file"},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}}}}},"/api/rest/v1/currencies":{"get":{"summary":"Get a list of currencies","operationId":"currencies_get_list","description":"This endpoint allows you to get a list of currencies. Currencies are paginated and sorted by code.","tags":["Currency"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"search","in":"query","description":"Filter currencies, for more details see the Filters section","required":false,"type":"string"},{"name":"page","in":"query","description":"Number of the page to retrieve when using the `page` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"integer","default":1},{"name":"limit","in":"query","description":"Number of results by page, see Pagination section","required":false,"type":"integer","minimum":1,"maximum":100,"default":10},{"name":"with_count","in":"query","description":"Return the count of items in the response. Be carefull with that, on a big catalog, it can decrease performance in a significative way","default":false,"type":"boolean","required":false}],"responses":{"200":{"description":"Return currencies paginated","schema":{"title":"Currencies","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"previous":{"type":"object","properties":{"href":{"type":"string","description":"URI of the previous page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}},"current_page":{"type":"integer","description":"Current page number"}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Currency code","x-immutable":true},"enabled":{"type":"boolean","description":"Whether the currency is enabled"},"label":{"type":"string","description":"Currency label"}},"example":{"code":"EUR","enabled":true,"label":"EUR (Euro)"}}]}}}}}}]},"examples":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/currencies?page=1&limit=3"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/currencies?page=1&limit=3"}},"current_page":1,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/currencies/ADP"}},"code":"ADP","enabled":true,"label":"ADP (Andorran Peseta)"},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/currencies/AED"}},"code":"AED","enabled":true,"label":"AED (United Arab Emirates Dirham)"},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/currencies/AFA"}},"code":"AFA","enabled":false,"label":"AFA (Afghan Afghani (1927–2002))"}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}}},"/api/rest/v1/currencies/{code}":{"get":{"summary":"Get a currency","operationId":"currencies_get","description":"This endpoint allows you to get the information about a given currency.","tags":["Currency"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the currency in JSON standard format","schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Currency code","x-immutable":true},"enabled":{"type":"boolean","description":"Whether the currency is enabled"},"label":{"type":"string","description":"Currency label"}},"example":{"code":"EUR","enabled":true,"label":"EUR (Euro)"}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}}},"/api/rest/v1/measure-families":{"get":{"summary":"Get list of measure familiy","operationId":"measure_families_get_list","description":"This endpoint allows you to get a list of measure families. Measure families are paginated and sorted by code.","tags":["Measure family"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"responses":{"200":{"description":"Return measure families paginated","schema":{"title":"Measure Families","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"previous":{"type":"object","properties":{"href":{"type":"string","description":"URI of the previous page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}},"current_page":{"type":"integer","description":"Current page number"}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Measure family code","x-immutable":true},"standard":{"type":"string","description":"Measure family standard","x-immutable":true},"units":{"type":"array","description":"Family units","items":{"type":"object","properties":{"code":{"type":"string","description":"Measure code","x-immutable":true},"convert":{"type":"object","description":"Mathematic operation to convert the unit into the standard unit"},"symbol":{"type":"string","description":"Measure symbol","x-immutable":true}}}}},"example":{"code":"Area","standard":"SQUARE_METER","units":[{"code":"SQUARE_MILLIMETER","convert":{"mul":"0.001"},"symbol":"mm²"},{"code":"SQUARE_CENTIMETER","convert":{"mul":"0.001"},"symbol":"cm²"}]}}]}}}}}}]},"examples":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/measure-families?page=1&limit=1"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/measure-families?page=1&limit=1"}},"current_page":1,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/measure-families/Area"}},"code":"Area","standard":"SQUARE_METER","units":[{"code":"SQUARE_MILLIMETER","convert":{"mul":"0.000001"},"symbol":"mm²"},{"code":"SQUARE_CENTIMETER","convert":{"mul":"0.0001"},"symbol":"cm²"},{"code":"SQUARE_DECIMETER","convert":{"mul":"0.01"},"symbol":"dm²"},{"code":"SQUARE_METER","convert":{"mul":"1"},"symbol":"m²"},{"code":"CENTIARE","convert":{"mul":"1"},"symbol":"ca"},{"code":"SQUARE_DEKAMETER","convert":{"mul":"100"},"symbol":"dam²"},{"code":"ARE","convert":{"mul":"100"},"symbol":"a"},{"code":"SQUARE_HECTOMETER","convert":{"mul":"10000"},"symbol":"hm²"}]}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}}},"/api/rest/v1/measure-families/{code}":{"get":{"summary":"Get a measure family","operationId":"measure_families_get","description":"This endpoint allows you to get the information about a given measure family.","tags":["Measure family"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the measure family in JSON standard format","schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Measure family code","x-immutable":true},"standard":{"type":"string","description":"Measure family standard","x-immutable":true},"units":{"type":"array","description":"Family units","items":{"type":"object","properties":{"code":{"type":"string","description":"Measure code","x-immutable":true},"convert":{"type":"object","description":"Mathematic operation to convert the unit into the standard unit"},"symbol":{"type":"string","description":"Measure symbol","x-immutable":true}}}}},"example":{"code":"Area","standard":"SQUARE_METER","units":[{"code":"SQUARE_MILLIMETER","convert":{"mul":"0.001"},"symbol":"mm²"},{"code":"SQUARE_CENTIMETER","convert":{"mul":"0.001"},"symbol":"cm²"}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}}},"/api/rest/v1/measurement-families":{"get":{"summary":"Get list of measurement families","operationId":"measurement_families_get_list","description":"This endpoint allows you to get a list of measurement families.","tags":["Measurement family"],"x-versions":["5.0","6.0","7.0","SaaS"],"responses":{"200":{"description":"Return the measurement families","x-no-entity":true,"schema":{"type":"object","required":["code","standard_unit_code","units"],"properties":{"code":{"type":"string","description":"Measurement family code","x-immutable":true},"labels":{"type":"object","description":"Measurement family labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Measurement family label for the locale `localeCode`"}}},"standard_unit_code":{"type":"string","description":"Unit code used as the standard unit for this measurement family","x-immutable":true,"x-validation-rules":"The unit code exists in the list of the property `units`"},"units":{"type":"object","description":"Measurement units for this family with their conversion operations. More details here.","x-validation-rules":"A unit can't be added when a product attribute is linked to this measurement family","properties":{"unitCode":{"type":"object","properties":{"code":{"type":"string","description":"Measurement unit code. More details here.","x-immutable":true},"labels":{"type":"object","description":"Unit labels for each locale. More details here.","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Unit label for the locale `localeCode`"}}},"convert_from_standard":{"type":"array","description":"Calculation to convert the unit from the standard unit. More details here.","x-validation-rules":"• The conversion operations can't be updated when a product attribute is linked to this measurement family • At least one conversion operation per unit is required","items":{"type":"object","properties":{"operator":{"type":"string","description":"Operator for a conversion operation to convert the unit in the standard unit","x-validation-rules":"The operator is one of the following values","enum":["mul","div","add","sub"]},"value":{"type":"string","description":"Value for a conversion operation to convert the unit in the standard unit"}}}},"symbol":{"type":"string","description":"Measurement unit symbol. More details here."}}}}}},"example":{"code":"AREA","labels":{"en_US":"Area","fr_FR":"Surface"},"standard_unit_code":"SQUARE_METER","units":{"SQUARE_MILLIMETER":{"code":"SQUARE_MILLIMETER","labels":{"en_US":"Square millimeter","fr_FR":"Millimètre carré"},"convert_from_standard":[{"operator":"mul","value":"0.000001"}],"symbol":"mm²"},"SQUARE_CENTIMETER":{"code":"SQUARE_CENTIMETER","labels":{"en_US":"Square centimeter","fr_FR":"Centimètre carré"},"convert_from_standard":[{"operator":"mul","value":"0.0001"}],"symbol":"cm²"},"SQUARE_METER":{"code":"SQUARE_METER","labels":{"en_US":"Square meter","fr_FR":"Mètre carré"},"convert_from_standard":[{"operator":"mul","value":"1"}],"symbol":"m²"}}}},"x-examples":[{"code":"AREA","labels":{"en_US":"Area","fr_FR":"Surface"},"standard_unit_code":"SQUARE_METER","units":{"SQUARE_MILLIMETER":{"code":"SQUARE_MILLIMETER","labels":{"en_US":"Square millimeter","fr_FR":"Millimètre carré"},"convert_from_standard":[{"operator":"mul","value":"0.000001"}],"symbol":"mm²"},"SQUARE_CENTIMETER":{"code":"SQUARE_CENTIMETER","labels":{"en_US":"Square centimeter","fr_FR":"Centimètre carré"},"convert_from_standard":[{"operator":"mul","value":"0.0001"}],"symbol":"cm²"},"SQUARE_METER":{"code":"SQUARE_METER","labels":{"en_US":"Square meter","fr_FR":"Mètre carré"},"convert_from_standard":[{"operator":"mul","value":"1"}],"symbol":"m²"}}}]},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"patch":{"summary":"Update/create several measurement families","operationId":"patch_measurement_families","tags":["Measurement family"],"x-versions":["5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to update and/or create several measurement families at once.","parameters":[{"name":"body","in":"body","schema":{"type":"array","items":{"type":"object","required":["code","standard_unit_code","units"],"properties":{"code":{"type":"string","description":"Measurement family code","x-immutable":true},"labels":{"type":"object","description":"Measurement family labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Measurement family label for the locale `localeCode`"}}},"standard_unit_code":{"type":"string","description":"Unit code used as the standard unit for this measurement family","x-immutable":true,"x-validation-rules":"The unit code exists in the list of the property `units`"},"units":{"type":"object","description":"Measurement units for this family with their conversion operations. More details here.","x-validation-rules":"A unit can't be added when a product attribute is linked to this measurement family","properties":{"unitCode":{"type":"object","properties":{"code":{"type":"string","description":"Measurement unit code. More details here.","x-immutable":true},"labels":{"type":"object","description":"Unit labels for each locale. More details here.","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Unit label for the locale `localeCode`"}}},"convert_from_standard":{"type":"array","description":"Calculation to convert the unit from the standard unit. More details here.","x-validation-rules":"• The conversion operations can't be updated when a product attribute is linked to this measurement family • At least one conversion operation per unit is required","items":{"type":"object","properties":{"operator":{"type":"string","description":"Operator for a conversion operation to convert the unit in the standard unit","x-validation-rules":"The operator is one of the following values","enum":["mul","div","add","sub"]},"value":{"type":"string","description":"Value for a conversion operation to convert the unit in the standard unit"}}}},"symbol":{"type":"string","description":"Measurement unit symbol. More details here."}}}}}},"example":{"code":"AREA","labels":{"en_US":"Area","fr_FR":"Surface"},"standard_unit_code":"SQUARE_METER","units":{"SQUARE_MILLIMETER":{"code":"SQUARE_MILLIMETER","labels":{"en_US":"Square millimeter","fr_FR":"Millimètre carré"},"convert_from_standard":[{"operator":"mul","value":"0.000001"}],"symbol":"mm²"},"SQUARE_CENTIMETER":{"code":"SQUARE_CENTIMETER","labels":{"en_US":"Square centimeter","fr_FR":"Centimètre carré"},"convert_from_standard":[{"operator":"mul","value":"0.0001"}],"symbol":"cm²"},"SQUARE_METER":{"code":"SQUARE_METER","labels":{"en_US":"Square meter","fr_FR":"Mètre carré"},"convert_from_standard":[{"operator":"mul","value":"1"}],"symbol":"m²"}}}},"example":[{"code":"AREA","labels":{"en_US":"Area","fr_FR":"Surface"},"standard_unit_code":"SQUARE_METER","units":{"SQUARE_MILLIMETER":{"code":"SQUARE_MILLIMETER","labels":{"en_US":"Square millimeter","fr_FR":"Millimètre carré"},"convert_from_standard":[{"operator":"mul","value":"0.000001"}],"symbol":"mm²"},"SQUARE_CENTIMETER":{"code":"SQUARE_CENTIMETER","labels":{"en_US":"Square centimeter","fr_FR":"Centimètre carré"},"convert_from_standard":[{"operator":"mul","value":"0.0001"}],"symbol":"cm²"},"SQUARE_METER":{"code":"SQUARE_METER","labels":{"en_US":"Square meter","fr_FR":"Mètre carré"},"convert_from_standard":[{"operator":"mul","value":"1"}],"symbol":"m²"}}}]}}],"responses":{"200":{"description":"OK","x-details":"Returns a JSON containing the status of each update or creation","x-no-entity":true,"schema":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Resource code"},"status_code":{"type":"integer","description":"HTTP status code, see Client errors to understand the meaning of each code"},"message":{"type":"string","description":"Message explaining the error"},"errors":{"type":"array","description":"List of errors","items":{"type":"object","properties":{"property":{"type":"string"},"message":{"type":"string"}}}}}}},"x-examples":[{"code":"Angle","status_code":201},{"code":"Force","status_code":204},{"code":"Area","status_code":422,"message":"The measurement family has data that does not comply with the business rules.","errors":[{"property":"standard_unit_code","message":"The standard unit code of the \"Angle\" measurement family cannot be changed"}]}]},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"413":{"description":"Request Entity Too Large","x-details":"There are too many resources to process (max 100) or the line of JSON is too long (max 1 000 000 characters)","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":413,"message":"Too many resources to process, 100 is the maximum allowed."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/vnd.akeneo.collection+json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/vnd.akeneo.collection+json’ is allowed."}}}}},"/api/rest/v1/reference-entities":{"get":{"summary":"Get list of reference entities","operationId":"get_reference_entities","description":"This endpoint allows you to get a list of reference entities. Reference entities are paginated.","tags":["Reference entity"],"x-versions":["3.x","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"parameters":[{"name":"search_after","in":"query","description":"Cursor when using the `search_after` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"string","default":"cursor to the first page"}],"responses":{"200":{"description":"Return reference entities paginated","schema":{"title":"Reference Entities","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}},"image_download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the binaries of the reference entity image file"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Reference entity code","x-immutable":true},"labels":{"type":"object","description":"Reference entity labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Reference entity label for the locale `localeCode`"}}},"image":{"type":"string","description":"Code of the reference entity image","default":null}},"example":{"code":"brands","labels":{"en_US":"Brands","fr_FR":"Marques"},"image":"0/2/d/6/54d81dc888ba1501a8g765f3ab5797569f3bv756c_ref_img.png"}}]}}}}}}]},"examples":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/reference-entities"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/reference-entities"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/reference-entities?search_after=2x055w%3D%3D"}},"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/reference-entities/brands"},"image_download":{"href":"https://demo.akeneo.com/api/rest/v1/reference-entities-media-files/0/2/d/6/54d81dc888ba1501a8g765f3ab5797569f3bv756c_ref_img.png"}},"code":"brands","labels":{"en_US":"Brands","fr_FR":"Marque"},"image":"0/2/d/6/54d81dc888ba1501a8g765f3ab5797569f3bv756c_ref_img.png"},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/reference-entities/designers"}},"code":"designers","labels":{"en_US":"Designers","fr_FR":"Designers"},"image":null},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/reference-entities/colors"}},"code":"colors","labels":{"en_US":"Colors","fr_FR":"Couleurs"},"image":null}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}}},"/api/rest/v1/reference-entities/{code}":{"get":{"summary":"Get a reference entity","operationId":"get_reference_entities__code_","tags":["Reference entity"],"x-versions":["3.x","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"description":"This endpoint allows you to get the information about a given reference entity.","parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the reference entity in JSON format.","schema":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","x-read-only":true,"properties":{"image_download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the binaries of the reference entity image file"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Reference entity code","x-immutable":true},"labels":{"type":"object","description":"Reference entity labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Reference entity label for the locale `localeCode`"}}},"image":{"type":"string","description":"Code of the reference entity image","default":null}},"example":{"code":"brands","labels":{"en_US":"Brands","fr_FR":"Marques"},"image":"0/2/d/6/54d81dc888ba1501a8g765f3ab5797569f3bv756c_ref_img.png"}}],"example":{"_links":{"image_download":{"href":"https://demo.akeneo.com/api/rest/v1/reference-entities-media-files/0/2/d/6/54d81dc888ba1501a8g765f3ab5797569f3bv756c_ref_img.png"}},"code":"brands","labels":{"en_US":"Brands","fr_FR":"Marques"},"image":"0/2/d/6/54d81dc888ba1501a8g765f3ab5797569f3bv756c_ref_img.png"}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"patch":{"summary":"Update/create a reference entity","operationId":"patch_reference_entity__code_","tags":["Reference entity"],"x-versions":["3.x","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"description":"This endpoint allows you to update a given reference entity. Note that if the reference entity does not already exist, it creates it.","parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"},{"name":"body","in":"body","required":true,"schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Reference entity code","x-immutable":true},"labels":{"type":"object","description":"Reference entity labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Reference entity label for the locale `localeCode`"}}},"image":{"type":"string","description":"Code of the reference entity image","default":null}},"example":{"code":"brands","labels":{"en_US":"Brands","fr_FR":"Marques"},"image":"0/2/d/6/54d81dc888ba1501a8g765f3ab5797569f3bv756c_ref_img.png"}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"204":{"description":"No content to return","x-details":"Means that the update was successful","headers":{"Location":{"description":"URI of the updated resource","type":"string"}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/reference-entities/{reference_entity_code}/attributes":{"get":{"summary":"Get the list of attributes of a given reference entity","operationId":"get_reference_entities__code__attributes","description":"This endpoint allows you to get the list of attributes of a given reference entity.","tags":["Reference entity attribute"],"x-versions":["3.x","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"parameters":[{"name":"reference_entity_code","in":"path","description":"Code of the reference entity","required":true,"type":"string"}],"responses":{"200":{"description":"Return the attributes of the given reference entity","x-no-entity":true,"schema":{"type":"array","items":{"type":"object","required":["code","type"],"properties":{"code":{"type":"string","description":"Attribute code","x-immutable":true},"labels":{"type":"object","description":"Attribute labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute label for the locale `localeCode`"}}},"type":{"type":"string","description":"Attribute type. See type section for more details.","enum":["text","image","number","single_option","multiple_options","reference_entity_single_link","reference_entity_multiple_links"],"x-immutable":true},"value_per_locale":{"type":"boolean","description":"Whether the attribute is localizable, i.e. can have one value by locale","default":false,"x-immutable":true},"value_per_channel":{"type":"boolean","description":"Whether the attribute is scopable, i.e. can have one value by channel","default":false,"x-immutable":true},"is_required_for_completeness":{"type":"boolean","description":"Whether the attribute should be part of the record's completeness calculation","default":false},"max_characters":{"type":"integer","description":"Maximum number of characters allowed for the value of the attribute when the attribute type is `text`","x-warning":"Only for `text` attribute type"},"is_textarea":{"type":"boolean","description":"Whether the UI should display a text area instead of a simple field when the attribute type is `text`","default":false,"x-warning":"Only for `text` attribute type"},"is_rich_text_editor":{"type":"boolean","description":"Whether the UI should display a rich text editor instead of a simple text area when the attribute type is `text`","x-validation-rules":"Required when the property `is_textarea` is equal to `true`","x-warning":"Only for `text` attribute type"},"validation_rule":{"type":"string","description":"Validation rule type used to validate the attribute value when the attribute type is `text`","default":"none","x-warning":"Only for `text` attribute type","enum":["email","url","regexp","none"]},"validation_regexp":{"type":"string","description":"Regexp expression used to validate the attribute value when the attribute type is `text`","default":null,"x-validation-rules":"Required when the property `validation_rule` is equal to `regexp`","x-warning":"Only for `text` attribute type"},"allowed_extensions":{"type":"array","description":"Extensions allowed when the attribute type is `image`","default":[],"x-warning":"Only for `image` attribute type","items":{"type":"string"}},"max_file_size":{"type":"string","description":"Max file size in MB when the attribute type is `image`","default":null,"x-warning":"Only for `image` attribute type"},"reference_entity_code":{"type":"string","description":"Code of the linked reference entity when the attribute type is `reference_entity_single_link` or `reference_entity_multiple_links`","default":null,"x-validation-rules":"Required when the attribute type is either `reference_entity_single_link` or `reference_entity_multiple_links`","x-warning":"Only for `reference_entity_single_link` and `reference_entity_multiple_links` attribute type","x-immutable":true},"decimals_allowed":{"type":"boolean","description":"Whether decimals are allowed when the attribute type is `number`","default":false,"x-warning":"Only for `number` attribute type"},"min_value":{"type":"string","description":"Minimum value allowed when the attribute type is `number`","default":null,"x-validation-rules":"The minimum value must be lower than the maximum value","x-warning":"Only for `number` attribute type"},"max_value":{"type":"string","description":"Maximum value allowed when the attribute type is `number`","default":null,"x-validation-rules":"The maximum value must be greater than the minimum value","x-warning":"Only for `number` attribute type"}},"example":{"code":"description","labels":{"en_US":"Description","fr_FR":"Description"},"type":"text","value_per_locale":true,"value_per_channel":false,"is_required_for_completeness":true,"max_characters":null,"is_textarea":true,"is_rich_text_editor":true,"validation_rule":"none","validation_regexp":null}}},"x-examples":[{"code":"description","labels":{"en_US":"Description","fr_FR":"Description"},"type":"text","value_per_locale":true,"value_per_channel":false,"is_required_for_completeness":true,"max_characters":null,"is_textarea":true,"is_rich_text_editor":true,"validation_rule":"none","validation_regexp":null},{"code":"country","labels":{"en_US":"Country","fr_FR":"Pays"},"type":"text","value_per_locale":false,"value_per_channel":false,"is_required_for_completeness":false},{"code":"creation_year","labels":{"en_US":"Creation year","fr_FR":"Année de création"},"type":"number","value_per_locale":false,"value_per_channel":false,"is_required_for_completeness":false,"decimals_allowed":false,"min_value":"1800","max_value":"2100"},{"code":"collection_overview","labels":{"en_US":"Collection overview","fr_FR":"Aperçu de la collection"},"type":"image","value_per_locale":true,"value_per_channel":false,"is_required_for_completeness":true,"allowed_extensions":["png"],"max_file_size":"1000"}]},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}}},"/api/rest/v1/reference-entities/{reference_entity_code}/attributes/{code}":{"get":{"summary":"Get an attribute of a given reference entity","operationId":"get_reference_entity_attributes__code_","tags":["Reference entity attribute"],"x-versions":["3.x","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"description":"This endpoint allows you to get the information about a given attribute for a given reference entity.","parameters":[{"name":"reference_entity_code","in":"path","description":"Code of the reference entity","required":true,"type":"string"},{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the reference entity attribute in JSON format","schema":{"type":"object","required":["code","type"],"properties":{"code":{"type":"string","description":"Attribute code","x-immutable":true},"labels":{"type":"object","description":"Attribute labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute label for the locale `localeCode`"}}},"type":{"type":"string","description":"Attribute type. See type section for more details.","enum":["text","image","number","single_option","multiple_options","reference_entity_single_link","reference_entity_multiple_links"],"x-immutable":true},"value_per_locale":{"type":"boolean","description":"Whether the attribute is localizable, i.e. can have one value by locale","default":false,"x-immutable":true},"value_per_channel":{"type":"boolean","description":"Whether the attribute is scopable, i.e. can have one value by channel","default":false,"x-immutable":true},"is_required_for_completeness":{"type":"boolean","description":"Whether the attribute should be part of the record's completeness calculation","default":false},"max_characters":{"type":"integer","description":"Maximum number of characters allowed for the value of the attribute when the attribute type is `text`","x-warning":"Only for `text` attribute type"},"is_textarea":{"type":"boolean","description":"Whether the UI should display a text area instead of a simple field when the attribute type is `text`","default":false,"x-warning":"Only for `text` attribute type"},"is_rich_text_editor":{"type":"boolean","description":"Whether the UI should display a rich text editor instead of a simple text area when the attribute type is `text`","x-validation-rules":"Required when the property `is_textarea` is equal to `true`","x-warning":"Only for `text` attribute type"},"validation_rule":{"type":"string","description":"Validation rule type used to validate the attribute value when the attribute type is `text`","default":"none","x-warning":"Only for `text` attribute type","enum":["email","url","regexp","none"]},"validation_regexp":{"type":"string","description":"Regexp expression used to validate the attribute value when the attribute type is `text`","default":null,"x-validation-rules":"Required when the property `validation_rule` is equal to `regexp`","x-warning":"Only for `text` attribute type"},"allowed_extensions":{"type":"array","description":"Extensions allowed when the attribute type is `image`","default":[],"x-warning":"Only for `image` attribute type","items":{"type":"string"}},"max_file_size":{"type":"string","description":"Max file size in MB when the attribute type is `image`","default":null,"x-warning":"Only for `image` attribute type"},"reference_entity_code":{"type":"string","description":"Code of the linked reference entity when the attribute type is `reference_entity_single_link` or `reference_entity_multiple_links`","default":null,"x-validation-rules":"Required when the attribute type is either `reference_entity_single_link` or `reference_entity_multiple_links`","x-warning":"Only for `reference_entity_single_link` and `reference_entity_multiple_links` attribute type","x-immutable":true},"decimals_allowed":{"type":"boolean","description":"Whether decimals are allowed when the attribute type is `number`","default":false,"x-warning":"Only for `number` attribute type"},"min_value":{"type":"string","description":"Minimum value allowed when the attribute type is `number`","default":null,"x-validation-rules":"The minimum value must be lower than the maximum value","x-warning":"Only for `number` attribute type"},"max_value":{"type":"string","description":"Maximum value allowed when the attribute type is `number`","default":null,"x-validation-rules":"The maximum value must be greater than the minimum value","x-warning":"Only for `number` attribute type"}},"example":{"code":"description","labels":{"en_US":"Description","fr_FR":"Description"},"type":"text","value_per_locale":true,"value_per_channel":false,"is_required_for_completeness":true,"max_characters":null,"is_textarea":true,"is_rich_text_editor":true,"validation_rule":"none","validation_regexp":null}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"patch":{"summary":"Update/create an attribute of a given reference entity","operationId":"patch_reference_entity_attributes__code_","tags":["Reference entity attribute"],"x-versions":["3.x","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"description":"This endpoint allows you to update a given attribute for a given renference entity. Note that if the attribute does not already exist for the given reference entity, it creates it.","parameters":[{"name":"reference_entity_code","in":"path","description":"Code of the reference entity","required":true,"type":"string"},{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"},{"name":"body","in":"body","required":true,"schema":{"type":"object","required":["code","type"],"properties":{"code":{"type":"string","description":"Attribute code","x-immutable":true},"labels":{"type":"object","description":"Attribute labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute label for the locale `localeCode`"}}},"type":{"type":"string","description":"Attribute type. See type section for more details.","enum":["text","image","number","single_option","multiple_options","reference_entity_single_link","reference_entity_multiple_links"],"x-immutable":true},"value_per_locale":{"type":"boolean","description":"Whether the attribute is localizable, i.e. can have one value by locale","default":false,"x-immutable":true},"value_per_channel":{"type":"boolean","description":"Whether the attribute is scopable, i.e. can have one value by channel","default":false,"x-immutable":true},"is_required_for_completeness":{"type":"boolean","description":"Whether the attribute should be part of the record's completeness calculation","default":false},"max_characters":{"type":"integer","description":"Maximum number of characters allowed for the value of the attribute when the attribute type is `text`","x-warning":"Only for `text` attribute type"},"is_textarea":{"type":"boolean","description":"Whether the UI should display a text area instead of a simple field when the attribute type is `text`","default":false,"x-warning":"Only for `text` attribute type"},"is_rich_text_editor":{"type":"boolean","description":"Whether the UI should display a rich text editor instead of a simple text area when the attribute type is `text`","x-validation-rules":"Required when the property `is_textarea` is equal to `true`","x-warning":"Only for `text` attribute type"},"validation_rule":{"type":"string","description":"Validation rule type used to validate the attribute value when the attribute type is `text`","default":"none","x-warning":"Only for `text` attribute type","enum":["email","url","regexp","none"]},"validation_regexp":{"type":"string","description":"Regexp expression used to validate the attribute value when the attribute type is `text`","default":null,"x-validation-rules":"Required when the property `validation_rule` is equal to `regexp`","x-warning":"Only for `text` attribute type"},"allowed_extensions":{"type":"array","description":"Extensions allowed when the attribute type is `image`","default":[],"x-warning":"Only for `image` attribute type","items":{"type":"string"}},"max_file_size":{"type":"string","description":"Max file size in MB when the attribute type is `image`","default":null,"x-warning":"Only for `image` attribute type"},"reference_entity_code":{"type":"string","description":"Code of the linked reference entity when the attribute type is `reference_entity_single_link` or `reference_entity_multiple_links`","default":null,"x-validation-rules":"Required when the attribute type is either `reference_entity_single_link` or `reference_entity_multiple_links`","x-warning":"Only for `reference_entity_single_link` and `reference_entity_multiple_links` attribute type","x-immutable":true},"decimals_allowed":{"type":"boolean","description":"Whether decimals are allowed when the attribute type is `number`","default":false,"x-warning":"Only for `number` attribute type"},"min_value":{"type":"string","description":"Minimum value allowed when the attribute type is `number`","default":null,"x-validation-rules":"The minimum value must be lower than the maximum value","x-warning":"Only for `number` attribute type"},"max_value":{"type":"string","description":"Maximum value allowed when the attribute type is `number`","default":null,"x-validation-rules":"The maximum value must be greater than the minimum value","x-warning":"Only for `number` attribute type"}},"example":{"code":"description","labels":{"en_US":"Description","fr_FR":"Description"},"type":"text","value_per_locale":true,"value_per_channel":false,"is_required_for_completeness":true,"max_characters":null,"is_textarea":true,"is_rich_text_editor":true,"validation_rule":"none","validation_regexp":null}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"204":{"description":"No content to return","x-details":"Means that the update was successful","headers":{"Location":{"description":"URI of the updated resource","type":"string"}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/reference-entities/{reference_entity_code}/attributes/{attribute_code}/options":{"get":{"summary":"Get a list of attribute options of a given attribute for a given reference entity","operationId":"get_reference_entity_attributes__attribute_code__options","description":"This endpoint allows you to get a list of attribute options for a given reference entity.","tags":["Reference entity attribute option"],"x-versions":["3.x","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"parameters":[{"name":"reference_entity_code","in":"path","description":"Code of the reference entity","required":true,"type":"string"},{"name":"attribute_code","in":"path","description":"Code of the attribute","required":true,"type":"string"}],"responses":{"200":{"description":"Return the options of the given attributes of the given reference entity","x-no-entity":true,"schema":{"type":"array","items":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Attribute's option code","x-immutable":true},"labels":{"type":"object","description":"Attribute labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute label for the locale `localeCode`"}}}},"example":{"code":"global_nomad","labels":{"en_US":"Global Nomad","fr_FR":"Nomade du Monde"}}}},"x-examples":[{"code":"woodland_retreat","labels":{"en_US":"Woodland Retreat","fr_FR":"Retraite dans les Bois"}},{"code":"new_nordic","labels":{"en_US":"New Nordic","fr_FR":"Renouveau Scandinave"}},{"code":"global_nomad","labels":{"en_US":"Global Nomad","fr_FR":"Nomade du Monde"}}]},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}}},"/api/rest/v1/reference-entities/{reference_entity_code}/attributes/{attribute_code}/options/{code}":{"get":{"summary":"Get an attribute option for a given attribute of a given reference entity","operationId":"get_reference_entity_attributes__attribute_code__options__code_","description":"This endpoint allows you to get the information about a given attribute option.","tags":["Reference entity attribute option"],"x-versions":["3.x","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"parameters":[{"name":"reference_entity_code","in":"path","description":"Code of the reference entity","required":true,"type":"string"},{"name":"attribute_code","in":"path","description":"Code of the attribute","required":true,"type":"string"},{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the reference entity attribute option in JSON format","schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Attribute's option code","x-immutable":true},"labels":{"type":"object","description":"Attribute labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute label for the locale `localeCode`"}}}},"example":{"code":"global_nomad","labels":{"en_US":"Global Nomad","fr_FR":"Nomade du Monde"}}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"patch":{"summary":"Update/create a reference entity attribute option","operationId":"patch_reference_entity_attributes__attribute_code__options__code_","tags":["Reference entity attribute option"],"x-versions":["3.x","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"description":"This endpoint allows you to update a given option for a given attribute and a given reference entity. Learn more about Update behavior. Note that if the option does not already exist for the given attribute of the given reference entity, it creates it.","parameters":[{"name":"reference_entity_code","in":"path","description":"Code of the reference entity","required":true,"type":"string"},{"name":"attribute_code","in":"path","description":"Code of the attribute","required":true,"type":"string"},{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"},{"name":"body","in":"body","required":true,"schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Attribute's option code","x-immutable":true},"labels":{"type":"object","description":"Attribute labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute label for the locale `localeCode`"}}}},"example":{"code":"global_nomad","labels":{"en_US":"Global Nomad","fr_FR":"Nomade du Monde"}}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"204":{"description":"No content to return","x-details":"Means that the update was successful","headers":{"Location":{"description":"URI of the updated resource","type":"string"}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/reference-entities/{reference_entity_code}/records":{"get":{"summary":"Get the list of the records of a reference entity","operationId":"get_reference_entity_records","tags":["Reference entity record"],"x-versions":["3.x","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"description":"This endpoint allows you to get a list of records of a given reference entity. Records are paginated and can be filtered.","parameters":[{"name":"search","in":"query","description":"Filter records of the reference entity, for more details see the Filters section","required":false,"type":"string"},{"name":"channel","in":"query","type":"string","description":"Filter attribute values to return scopable attributes for the given channel as well as the non localizable/non scopable attributes, for more details see the Filter attribute values by channel section","required":false},{"name":"locales","in":"query","type":"string","description":"Filter attribute values to return localizable attributes for the given locales as well as the non localizable/non scopable attributes, for more details see the Filter attribute values by locale section","required":false},{"name":"reference_entity_code","in":"path","description":"Code of the reference entity","required":true,"type":"string"},{"name":"search_after","in":"query","description":"Cursor when using the `search_after` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"string","default":"cursor to the first page"}],"responses":{"200":{"description":"Return the records of the given reference entity paginated","schema":{"title":"Reference entity record","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Code of the record","x-immutable":true},"values":{"type":"object","description":"Record attributes values, see Reference entity record values section for more details","x-validation-rules":"Validation rules detailed in Reference entity record values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","description":"Channel code of the reference entity record value"},"locale":{"type":"string","description":"Locale code of the reference entity record value"},"data":{"type":"object","description":"Reference entity record value. See the `data` format section for more details."}}}}}},"created":{"type":"string","description":"Date of creation.","format":"dateTime","default":null,"x-immutable":true,"x-read-only":true,"x-from-version":"5.0"},"updated":{"type":"string","description":"Date of the last update.","format":"dateTime","default":null,"x-read-only":true,"x-from-version":"5.0"}},"example":{"code":"kartell","values":{"label":[{"locale":"en_US","channel":null,"data":"Kartell"}],"image":[{"locale":null,"channel":null,"data":"0/c/b/0/0cb0c0e115dedba676f8d1ad8343ec207ab54c7b_image.jpg"}],"description":[{"locale":"en_US","channel":null,"data":"Kartell, the Italian furniture company that sells modern and remarkable pieces of furnitures."},{"locale":"fr_FR","channel":null,"data":"Kartell, l'éditeur de meuble italien spécialisé dans la signature de belle pièces au design contemporain."}],"country":[{"locale":null,"channel":null,"data":"italy"}],"collection_overview":[{"locale":null,"channel":null,"data":"5/1/d/8/51d81dc778ba1501a8f998f3ab5797569f3b9e25_img.png"}],"creation_year":[{"locale":null,"channel":null,"data":"1949"}]},"created":"2021-01-01T01:23:34+00:00","updated":"2021-02-03T23:45:60+00:00"}}]}}}}}}]},"examples":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/reference-entities/brands/records"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/reference-entities/brands/records"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/reference-entities/brands/records?search_after=2x088w%3D%3D"}},"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/reference-entities/brands/records/kartell"}},"code":"kartell","values":{"label":[{"locale":"en_US","channel":null,"data":"Kartell"}],"image":[{"locale":null,"channel":null,"data":"0/c/b/0/0cb0c0e115dedba676f8d1ad8343ec207ab54c7b_image.jpg"}],"description":[{"data":"The contemporary Italian furniture brand","locale":"en_US","channel":null},{"data":"L'éditeur de meubles comtemporain italien","locale":"fr_FR","channel":null}],"country":[{"locale":null,"channel":null,"data":"italy"}]},"created":"2021-01-01T01:23:34+00:00","updated":"2021-02-03T23:45:60+00:00"},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/reference-entities/brands/records/usm"}},"code":"usm","values":{"label":[{"locale":"en_US","channel":null,"data":"USM"}],"image":[{"locale":null,"channel":null,"data":"9/c/g/1/0cb0c0e115dedba76f8d1ad8343ec897abc43bv4_image.jpg"}],"description":[{"data":"Modular furniture from Switzerland for your home and office","locale":"en_US","channel":null},{"data":"L'éditeur de meubles modulaires suisse pour votre intérieur et pour les entreprises","locale":"fr_FR","channel":null}],"country":[{"locale":null,"channel":null,"data":"switzerland"}]},"created":"2021-01-01T01:23:34+00:00","updated":"2021-02-03T23:45:60+00:00"},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/reference-entities/brands/records/ligneroset"}},"code":"ligneroset","values":{"label":[{"locale":"en_US","channel":null,"data":"Ligne Roset"}],"image":[{"locale":null,"channel":null,"data":"4/b/0/1/0cb0c0e115dedde78b8d1ad8343ec980cd5daa54_image.jpg"}],"description":[{"data":"Very well known French brand of modern and luxury furniture","locale":"en_US","channel":null},{"data":"La marque renommée des meubles de luxe à la française","locale":"fr_FR","channel":null}],"country":[{"locale":null,"channel":null,"data":"france"}]},"created":"2021-01-01T01:23:34+00:00","updated":"2021-02-03T23:45:60+00:00"}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"patch":{"summary":"Update/create several reference entity records","operationId":"patch_reference_entity_records","tags":["Reference entity record"],"x-versions":["3.x","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"description":"This endpoint allows you to update and/or create several records of one given reference entity at once. Learn more about Update behavior. Note that if the record does not already exist for the given reference entity, it creates it.","parameters":[{"name":"reference_entity_code","in":"path","description":"Code of the reference entity","required":true,"type":"string"},{"name":"body","in":"body","required":true,"schema":{"type":"array","items":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Code of the record","x-immutable":true},"values":{"type":"object","description":"Record attributes values, see Reference entity record values section for more details","x-validation-rules":"Validation rules detailed in Reference entity record values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","description":"Channel code of the reference entity record value"},"locale":{"type":"string","description":"Locale code of the reference entity record value"},"data":{"type":"object","description":"Reference entity record value. See the `data` format section for more details."}}}}}},"created":{"type":"string","description":"Date of creation.","format":"dateTime","default":null,"x-immutable":true,"x-read-only":true,"x-from-version":"5.0"},"updated":{"type":"string","description":"Date of the last update.","format":"dateTime","default":null,"x-read-only":true,"x-from-version":"5.0"}},"example":{"code":"kartell","values":{"label":[{"locale":"en_US","channel":null,"data":"Kartell"}],"image":[{"locale":null,"channel":null,"data":"0/c/b/0/0cb0c0e115dedba676f8d1ad8343ec207ab54c7b_image.jpg"}],"description":[{"locale":"en_US","channel":null,"data":"Kartell, the Italian furniture company that sells modern and remarkable pieces of furnitures."},{"locale":"fr_FR","channel":null,"data":"Kartell, l'éditeur de meuble italien spécialisé dans la signature de belle pièces au design contemporain."}],"country":[{"locale":null,"channel":null,"data":"italy"}],"collection_overview":[{"locale":null,"channel":null,"data":"5/1/d/8/51d81dc778ba1501a8f998f3ab5797569f3b9e25_img.png"}],"creation_year":[{"locale":null,"channel":null,"data":"1949"}]},"created":"2021-01-01T01:23:34+00:00","updated":"2021-02-03T23:45:60+00:00"}},"example":[{"code":"kartell","values":{"label":[{"locale":"en_US","channel":null,"data":"Kartell"}],"image":[{"locale":null,"channel":null,"data":"0/c/b/0/0cb0c0e115dedba676f8d1ad8343ec207ab54c7b_image.jpg"}],"description":[{"locale":"en_US","channel":null,"data":"Kartell, the Italian furniture company that sells modern and remarkable pieces of furnitures."},{"locale":"fr_FR","channel":null,"data":"Kartell, l'éditeur de meuble italien spécialisé dans la signature de belle pièces au design contemporain."}],"country":[{"locale":null,"channel":null,"data":"italy"}],"collection_overview":[{"locale":null,"channel":null,"data":"5/1/d/8/51d81dc778ba1501a8f998f3ab5797569f3b9e25_img.png"}],"creation_year":[{"locale":null,"channel":null,"data":"1949"}]}},{"code":"ligneroset","values":{"label":[{"locale":"en_US","channel":null,"data":"Ligne Roset"}],"image":[{"locale":null,"channel":null,"data":"4/b/0/1/0cb0c0e115dedde78b8d1ad8343ec980cd5daa54_image.jpg"}],"description":[{"data":"Very well known French brand of modern and luxury furniture","locale":"en_US","channel":null},{"data":"La marque renommée des meubles de luxe à la française","locale":"fr_FR","channel":null}],"country":[{"locale":null,"channel":null,"data":"france"}],"creation_year":[{"locale":null,"channel":null,"data":"1860"}]}},{"code":"usm","values":{"label":[{"locale":"en_US","channel":null,"data":"USM"}],"image":[{"locale":null,"channel":null,"data":"9/c/g/1/0cb0c0e115dedba76f8d1ad8343ec897abc43bv4_image.jpg"}],"description":[{"data":"Modular furniture from Switzerland for your home and office","locale":"en_US","channel":null},{"data":"L'éditeur de meubles modulaires suisse pour votre intérieur et pour les entreprises","locale":"fr_FR","channel":null}],"country":[{"locale":null,"channel":null,"data":"switzerland"}],"creation_year":[{"locale":null,"channel":null,"data":"1885"}]}}]}}],"responses":{"200":{"description":"OK","x-details":"Returns an JSON array in which each object gives you the status of each record creation or update","x-no-entity":true,"schema":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Resource code"},"status_code":{"type":"integer","description":"HTTP status code, see Client errors to understand the meaning of each code"},"message":{"type":"string","description":"Message explaining the error"}}}},"x-examples":[{"code":"kartell","status_code":204},{"code":"ligneroset","status_code":422,"message":"Property 'group' does not exist."},{"code":"usm","status_code":201}]},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"413":{"description":"Request Entity Too Large","x-details":"There are too many resources to process (max 100) or the line of JSON is too long (max 1 000 000 characters)","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":413,"message":"Too many resources to process, 100 is the maximum allowed."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/vnd.akeneo.collection+json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/vnd.akeneo.collection+json’ is allowed."}}}}},"/api/rest/v1/reference-entities/{reference_entity_code}/records/{code}":{"get":{"summary":"Get a record of a given reference entity","operationId":"get_reference_entity_records__code_","tags":["Reference entity record"],"x-versions":["3.x","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"description":"This endpoint allows you to get the information about a given record for a given reference entity.","parameters":[{"name":"reference_entity_code","in":"path","description":"Code of the reference entity","required":true,"type":"string"},{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the product in JSON standard format","schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Code of the record","x-immutable":true},"values":{"type":"object","description":"Record attributes values, see Reference entity record values section for more details","x-validation-rules":"Validation rules detailed in Reference entity record values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","description":"Channel code of the reference entity record value"},"locale":{"type":"string","description":"Locale code of the reference entity record value"},"data":{"type":"object","description":"Reference entity record value. See the `data` format section for more details."}}}}}},"created":{"type":"string","description":"Date of creation.","format":"dateTime","default":null,"x-immutable":true,"x-read-only":true,"x-from-version":"5.0"},"updated":{"type":"string","description":"Date of the last update.","format":"dateTime","default":null,"x-read-only":true,"x-from-version":"5.0"}},"example":{"code":"kartell","values":{"label":[{"locale":"en_US","channel":null,"data":"Kartell"}],"image":[{"locale":null,"channel":null,"data":"0/c/b/0/0cb0c0e115dedba676f8d1ad8343ec207ab54c7b_image.jpg"}],"description":[{"locale":"en_US","channel":null,"data":"Kartell, the Italian furniture company that sells modern and remarkable pieces of furnitures."},{"locale":"fr_FR","channel":null,"data":"Kartell, l'éditeur de meuble italien spécialisé dans la signature de belle pièces au design contemporain."}],"country":[{"locale":null,"channel":null,"data":"italy"}],"collection_overview":[{"locale":null,"channel":null,"data":"5/1/d/8/51d81dc778ba1501a8f998f3ab5797569f3b9e25_img.png"}],"creation_year":[{"locale":null,"channel":null,"data":"1949"}]},"created":"2021-01-01T01:23:34+00:00","updated":"2021-02-03T23:45:60+00:00"}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"patch":{"summary":"Update/create a record of a given reference entity","operationId":"patch_reference_entity_records__code_","tags":["Reference entity record"],"x-versions":["3.x","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"description":"This endpoint allows you to update a given record of a given renference entity. Learn more about Update behavior. Note that if the record does not already exist for the given reference entity, it creates it.","parameters":[{"name":"reference_entity_code","in":"path","description":"Code of the reference entity","required":true,"type":"string"},{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"},{"name":"body","in":"body","required":true,"schema":{"example":{"code":"kartell","values":{"label":[{"locale":"en_US","channel":null,"data":"Kartell"}],"image":[{"locale":null,"channel":null,"data":"0/c/b/0/0cb0c0e115dedba676f8d1ad8343ec207ab54c7b_image.jpg"}],"description":[{"locale":"en_US","channel":null,"data":"Kartell, the Italian furniture company that sells modern and remarkable pieces of furnitures."},{"locale":"fr_FR","channel":null,"data":"Kartell, l'éditeur de meuble italien spécialisé dans la signature de belle pièces au design contemporain."}],"country":[{"locale":null,"channel":null,"data":"italy"}],"collection_overview":[{"locale":null,"channel":null,"data":"5/1/d/8/51d81dc778ba1501a8f998f3ab5797569f3b9e25_img.png"}],"creation_year":[{"locale":null,"channel":null,"data":"1949"}]}},"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Code of the record","x-immutable":true},"values":{"type":"object","description":"Record attributes values, see Reference entity record values section for more details","x-validation-rules":"Validation rules detailed in Reference entity record values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","description":"Channel code of the reference entity record value"},"locale":{"type":"string","description":"Locale code of the reference entity record value"},"data":{"type":"object","description":"Reference entity record value. See the `data` format section for more details."}}}}}},"created":{"type":"string","description":"Date of creation.","format":"dateTime","default":null,"x-immutable":true,"x-read-only":true,"x-from-version":"5.0"},"updated":{"type":"string","description":"Date of the last update.","format":"dateTime","default":null,"x-read-only":true,"x-from-version":"5.0"}}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"204":{"description":"No content to return","x-details":"Means that the update was successful","headers":{"Location":{"description":"URI of the updated resource","type":"string"}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/reference-entities-media-files":{"post":{"summary":"Create a new media file for a reference entity or a record","operationId":"post_reference_entity_media_files","description":"This endpoint allows you to create a new media file and associate it to the image of a reference entity, or to the main image or to an attribute value of a record.","tags":["Reference entity media file"],"x-versions":["3.x","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"parameters":[{"name":"Content-type","in":"header","type":"string","description":"Equal to 'multipart/form-data', no other value allowed","required":true},{"name":"body","in":"body","x-form-data":true,"schema":{"required":["file"],"properties":{"file":{"type":"string","description":"The binary of the media file","format":"binary"}}}}],"responses":{"201":{"description":"Created","x-details":"Means that the media file creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"},"Reference-entities-media-file-code":{"description":"Code of the media file","type":"string"}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `multipart/form-data`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘multipart/form-data’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/reference-entities-media-files/{code}":{"get":{"summary":"Download the media file associated to a reference entity or a record","operationId":"get_reference_entity_media_files__code","description":"This endpoint allows you to download a given media file that is associated with a reference entity or a record.","x-content-type":"Mime-type of the media file","tags":["Reference entity media file"],"x-versions":["3.x","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the binary of the media file","x-content-type":"Mime-type of the media file"},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}}}}},"/api/rest/v1/asset-families":{"get":{"summary":"Get list of asset families","operationId":"get_asset_families","description":"This endpoint allows you to get a list of asset families. Asset families are paginated.","tags":["Asset family"],"x-versions":["3.2","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"parameters":[{"name":"search_after","in":"query","description":"Cursor when using the `search_after` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"string","default":"cursor to the first page"}],"responses":{"200":{"description":"Return asset families paginated","schema":{"title":"Asset families","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Asset family code","x-immutable":true},"labels":{"type":"object","description":"Asset family labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Asset family label for the locale `localeCode`"}}},"attribute_as_main_media":{"type":"string","description":"Attribute code that is used as the main media of the asset family.","x-validation-rules":"It should be the code of an attribute that belongs to this family, and it must be a media file or a media link attribute type.","default":"First media file or media link attribute that was created"},"naming_convention":{"type":"object","description":"The naming convention ran over the asset code or the main media filename upon each asset creation, in order to automatically set several values in asset attributes. To learn more and see the format of this property, take a look at here.","x-validation-rules":"To know more about the validation of this property, take a look at our naming convention format.","default":{},"properties":{"source":{"type":"object","description":"The string on which the naming convention should be applied. More details here."},"pattern":{"type":"string","description":"The regular expression that should be applied on the source. More details here."},"abort_asset_creation_on_error":{"type":"boolean","description":"Whether the asset should be created if the naming convention failed to apply. More details here."}}},"product_link_rules":{"type":"array","description":"The rules that will be run after the asset creation, in order to automatically link the assets of this family to a set of products. To understand the format of this property, see here.","x-validation-rules":"To know more about the validation of this property, take a look at our product link rule format.","default":[],"items":{"type":"object","properties":{"product_selections":{"type":"array","description":"The product selection to which the assets of the asset family to be automatically linked. More details here.","items":{"type":"object","required":["field","operator","value"],"properties":{"field":{"type":"string"},"operator":{"type":"string"},"value":{"type":"string"},"locale":{"type":"string"},"channel":{"type":"string"}}}},"assign_assets_to":{"type":"array","description":"The product value in which your assets will be assigned. More details here.","items":{"type":"object","required":["attribute","mode"],"properties":{"attribute":{"type":"string"},"locale":{"type":"string"},"channel":{"type":"string"},"mode":{"type":"string"}}}}}}},"transformations":{"type":"array","description":"The transformations to perform on source files in order to generate new files into your asset attributes (only available since v4.0). To understand the format of this property, see here.","x-validation-rules":"To know more about the validation of this property, take a look at our transformation format.","x-from-version":"4.0","default":[],"items":{"type":"object","required":["label","target","source","operations"],"properties":{"label":{"type":"string","description":"The name of the transformation"},"filename_suffix":{"type":"string","description":"The suffix that will be appended to the source filename to generate the target filename. More details here."},"filename_prefix":{"type":"string","description":"The prefix that will be prepended to the source filename to generate the target filename. More details here."},"source":{"type":"object","required":["attribute","channel","locale"],"description":"The attribute value in which is stored the media file you want to use as the source file for your transformation. More details here.","properties":{"attribute":{"type":"string"},"channel":{"type":"string"},"locale":{"type":"string"}}},"target":{"type":"object","required":["attribute","channel","locale"],"description":"The attribute value in which the PIM will generate the new transformed file, aka the target file. More details here.","properties":{"attribute":{"type":"string"},"channel":{"type":"string"},"locale":{"type":"string"}}},"operations":{"type":"object","description":"The transformations that should be applied to your source file to generate the target file. More details here.","x-validation-rules":"Should contain at least one operation","properties":{"type":{"type":"string"},"parameters":{"type":"object","properties":{"colorspace":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"},"ratio":{"type":"integer"},"resolution-unit":{"type":"string"},"resolution-x":{"type":"integer"},"resolution-y":{"type":"integer"},"quality":{"type":"integer"}}}}}}}}},"example":{"code":"model_pictures","labels":{"en_US":"Model pictures","fr_FR":"Photographies en pied"},"attribute_as_main_media":"main_image","naming_convention":{"source":{"property":"code","channel":null,"locale":null},"pattern":"/(?P.*)-.*/","abort_asset_creation_on_error":true},"product_link_rules":[{"product_selections":[{"field":"sku","operator":"EQUALS","value":"{{product_ref}}"}],"assign_assets_to":[{"attribute":"model_pictures","mode":"replace"}]}],"transformations":[{"label":"Thumbnail plus black and white transformation","filename_suffix":"_thumbnailBW","source":{"attribute":"main_image","channel":null,"locale":null},"target":{"attribute":"thumbnail","channel":null,"locale":null},"operations":[{"type":"thumbnail","parameters":{"width":150,"height":150}},{"type":"colorspace","parameters":{"colorspace":"grey"}}]}]}}]}}}}}}]},"examples":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/asset-families"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/asset-families"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/asset-families?search_after=2x055w%3D%3D"}},"_embedded":{"_items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/asset-families/packshots"}},"code":"packshots","labels":{"en_US":"Packshots","fr_FR":"Plans produit"},"“naming_convention”":{"source":{"property":"code","channel":null,"locale":null},"pattern":"/(?P.*)\\.jpg/","abort_asset_creation_on_error":true},"product_link_rules":[{"product_selections":[{"field":"sku","operator":"=","value":"{{product_ref}}"}],"assign_assets_to":[{"attribute":"{{my_product_attribute}}","mode":"add"}]}],"transformations":[{"label":"My transformation","filename_suffix":"_thumbnailBW","source":{"attribute":"main_image","locale":null,"channel":null},"target":{"attribute":"thumbnail","locale":null,"channel":null},"operations":[{"type":"thumbnail","parameters":{"width":150,"height":150}},{"type":"colorspace","parameters":{"colorspace":"grey"}}]}]},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/asset-families/videos"}},"code":"videos","labels":{"en_US":"Videos","fr_FR":"Vidéos"},"product_link_rules":[{"product_selections":[{"field":"categories","operator":"IN","value":["{{category}}"]}],"assign_assets_to":[{"attribute":"presentation_video","locale":"{{locale}}","mode":"replace"}]}]},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/asset-families/user_guides"}},"code":"user_guides","labels":{"en_US":"User guides","fr_FR":"Guides utilisateur"},"product_link_rules":[{"product_selections":[{"field":"sku","operator":"=","value":"{{product_ref}}"}],"assign_assets_to":[{"attribute":"user_instructions","locale":"{{locale}}","mode":"replace"}]}]}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}}},"/api/rest/v1/asset-families/{code}":{"get":{"summary":"Get an asset family","operationId":"get_asset_family__code_","tags":["Asset family"],"x-versions":["3.2","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"description":"This endpoint allows you to get the information about a given asset family.","parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the asset family in JSON format.","schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Asset family code","x-immutable":true},"labels":{"type":"object","description":"Asset family labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Asset family label for the locale `localeCode`"}}},"attribute_as_main_media":{"type":"string","description":"Attribute code that is used as the main media of the asset family.","x-validation-rules":"It should be the code of an attribute that belongs to this family, and it must be a media file or a media link attribute type.","default":"First media file or media link attribute that was created"},"naming_convention":{"type":"object","description":"The naming convention ran over the asset code or the main media filename upon each asset creation, in order to automatically set several values in asset attributes. To learn more and see the format of this property, take a look at here.","x-validation-rules":"To know more about the validation of this property, take a look at our naming convention format.","default":{},"properties":{"source":{"type":"object","description":"The string on which the naming convention should be applied. More details here."},"pattern":{"type":"string","description":"The regular expression that should be applied on the source. More details here."},"abort_asset_creation_on_error":{"type":"boolean","description":"Whether the asset should be created if the naming convention failed to apply. More details here."}}},"product_link_rules":{"type":"array","description":"The rules that will be run after the asset creation, in order to automatically link the assets of this family to a set of products. To understand the format of this property, see here.","x-validation-rules":"To know more about the validation of this property, take a look at our product link rule format.","default":[],"items":{"type":"object","properties":{"product_selections":{"type":"array","description":"The product selection to which the assets of the asset family to be automatically linked. More details here.","items":{"type":"object","required":["field","operator","value"],"properties":{"field":{"type":"string"},"operator":{"type":"string"},"value":{"type":"string"},"locale":{"type":"string"},"channel":{"type":"string"}}}},"assign_assets_to":{"type":"array","description":"The product value in which your assets will be assigned. More details here.","items":{"type":"object","required":["attribute","mode"],"properties":{"attribute":{"type":"string"},"locale":{"type":"string"},"channel":{"type":"string"},"mode":{"type":"string"}}}}}}},"transformations":{"type":"array","description":"The transformations to perform on source files in order to generate new files into your asset attributes (only available since v4.0). To understand the format of this property, see here.","x-validation-rules":"To know more about the validation of this property, take a look at our transformation format.","x-from-version":"4.0","default":[],"items":{"type":"object","required":["label","target","source","operations"],"properties":{"label":{"type":"string","description":"The name of the transformation"},"filename_suffix":{"type":"string","description":"The suffix that will be appended to the source filename to generate the target filename. More details here."},"filename_prefix":{"type":"string","description":"The prefix that will be prepended to the source filename to generate the target filename. More details here."},"source":{"type":"object","required":["attribute","channel","locale"],"description":"The attribute value in which is stored the media file you want to use as the source file for your transformation. More details here.","properties":{"attribute":{"type":"string"},"channel":{"type":"string"},"locale":{"type":"string"}}},"target":{"type":"object","required":["attribute","channel","locale"],"description":"The attribute value in which the PIM will generate the new transformed file, aka the target file. More details here.","properties":{"attribute":{"type":"string"},"channel":{"type":"string"},"locale":{"type":"string"}}},"operations":{"type":"object","description":"The transformations that should be applied to your source file to generate the target file. More details here.","x-validation-rules":"Should contain at least one operation","properties":{"type":{"type":"string"},"parameters":{"type":"object","properties":{"colorspace":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"},"ratio":{"type":"integer"},"resolution-unit":{"type":"string"},"resolution-x":{"type":"integer"},"resolution-y":{"type":"integer"},"quality":{"type":"integer"}}}}}}}}},"example":{"code":"model_pictures","labels":{"en_US":"Model pictures","fr_FR":"Photographies en pied"},"attribute_as_main_media":"main_image","naming_convention":{"source":{"property":"code","channel":null,"locale":null},"pattern":"/(?P.*)-.*/","abort_asset_creation_on_error":true},"product_link_rules":[{"product_selections":[{"field":"sku","operator":"EQUALS","value":"{{product_ref}}"}],"assign_assets_to":[{"attribute":"model_pictures","mode":"replace"}]}],"transformations":[{"label":"Thumbnail plus black and white transformation","filename_suffix":"_thumbnailBW","source":{"attribute":"main_image","channel":null,"locale":null},"target":{"attribute":"thumbnail","channel":null,"locale":null},"operations":[{"type":"thumbnail","parameters":{"width":150,"height":150}},{"type":"colorspace","parameters":{"colorspace":"grey"}}]}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"patch":{"summary":"Update/create an asset family","operationId":"patch_asset_family__code_","tags":["Asset family"],"x-versions":["3.2","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"description":"This endpoint allows you to update a given asset family. Note that if the asset family does not already exist, it creates it.","parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"},{"name":"body","in":"body","required":true,"schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Asset family code","x-immutable":true},"labels":{"type":"object","description":"Asset family labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Asset family label for the locale `localeCode`"}}},"attribute_as_main_media":{"type":"string","description":"Attribute code that is used as the main media of the asset family.","x-validation-rules":"It should be the code of an attribute that belongs to this family, and it must be a media file or a media link attribute type.","default":"First media file or media link attribute that was created"},"naming_convention":{"type":"object","description":"The naming convention ran over the asset code or the main media filename upon each asset creation, in order to automatically set several values in asset attributes. To learn more and see the format of this property, take a look at here.","x-validation-rules":"To know more about the validation of this property, take a look at our naming convention format.","default":{},"properties":{"source":{"type":"object","description":"The string on which the naming convention should be applied. More details here."},"pattern":{"type":"string","description":"The regular expression that should be applied on the source. More details here."},"abort_asset_creation_on_error":{"type":"boolean","description":"Whether the asset should be created if the naming convention failed to apply. More details here."}}},"product_link_rules":{"type":"array","description":"The rules that will be run after the asset creation, in order to automatically link the assets of this family to a set of products. To understand the format of this property, see here.","x-validation-rules":"To know more about the validation of this property, take a look at our product link rule format.","default":[],"items":{"type":"object","properties":{"product_selections":{"type":"array","description":"The product selection to which the assets of the asset family to be automatically linked. More details here.","items":{"type":"object","required":["field","operator","value"],"properties":{"field":{"type":"string"},"operator":{"type":"string"},"value":{"type":"string"},"locale":{"type":"string"},"channel":{"type":"string"}}}},"assign_assets_to":{"type":"array","description":"The product value in which your assets will be assigned. More details here.","items":{"type":"object","required":["attribute","mode"],"properties":{"attribute":{"type":"string"},"locale":{"type":"string"},"channel":{"type":"string"},"mode":{"type":"string"}}}}}}},"transformations":{"type":"array","description":"The transformations to perform on source files in order to generate new files into your asset attributes (only available since v4.0). To understand the format of this property, see here.","x-validation-rules":"To know more about the validation of this property, take a look at our transformation format.","x-from-version":"4.0","default":[],"items":{"type":"object","required":["label","target","source","operations"],"properties":{"label":{"type":"string","description":"The name of the transformation"},"filename_suffix":{"type":"string","description":"The suffix that will be appended to the source filename to generate the target filename. More details here."},"filename_prefix":{"type":"string","description":"The prefix that will be prepended to the source filename to generate the target filename. More details here."},"source":{"type":"object","required":["attribute","channel","locale"],"description":"The attribute value in which is stored the media file you want to use as the source file for your transformation. More details here.","properties":{"attribute":{"type":"string"},"channel":{"type":"string"},"locale":{"type":"string"}}},"target":{"type":"object","required":["attribute","channel","locale"],"description":"The attribute value in which the PIM will generate the new transformed file, aka the target file. More details here.","properties":{"attribute":{"type":"string"},"channel":{"type":"string"},"locale":{"type":"string"}}},"operations":{"type":"object","description":"The transformations that should be applied to your source file to generate the target file. More details here.","x-validation-rules":"Should contain at least one operation","properties":{"type":{"type":"string"},"parameters":{"type":"object","properties":{"colorspace":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"},"ratio":{"type":"integer"},"resolution-unit":{"type":"string"},"resolution-x":{"type":"integer"},"resolution-y":{"type":"integer"},"quality":{"type":"integer"}}}}}}}}},"example":{"code":"model_pictures","labels":{"en_US":"Model pictures","fr_FR":"Photographies en pied"},"attribute_as_main_media":"main_image","naming_convention":{"source":{"property":"code","channel":null,"locale":null},"pattern":"/(?P.*)-.*/","abort_asset_creation_on_error":true},"product_link_rules":[{"product_selections":[{"field":"sku","operator":"EQUALS","value":"{{product_ref}}"}],"assign_assets_to":[{"attribute":"model_pictures","mode":"replace"}]}],"transformations":[{"label":"Thumbnail plus black and white transformation","filename_suffix":"_thumbnailBW","source":{"attribute":"main_image","channel":null,"locale":null},"target":{"attribute":"thumbnail","channel":null,"locale":null},"operations":[{"type":"thumbnail","parameters":{"width":150,"height":150}},{"type":"colorspace","parameters":{"colorspace":"grey"}}]}]}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"204":{"description":"No content to return","x-details":"Means that the update was successful","headers":{"Location":{"description":"URI of the updated resource","type":"string"}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/asset-families/{asset_family_code}/attributes":{"get":{"summary":"Get the list of attributes of a given asset family","operationId":"get_asset_families__code__attributes","description":"This endpoint allows you to get the list of attributes of a given asset family.","tags":["Asset attribute"],"x-versions":["3.2","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"parameters":[{"name":"asset_family_code","in":"path","description":"Code of the asset family","required":true,"type":"string"}],"responses":{"200":{"description":"Return the attributes of the given asset family","x-no-entity":true,"schema":{"type":"array","items":{"type":"object","required":["code","type","media_type"],"properties":{"code":{"type":"string","description":"Attribute code","x-immutable":true},"labels":{"type":"object","description":"Attribute labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute label for the locale `localeCode`"}}},"type":{"type":"string","description":"Attribute type. See type section for more details.","enum":["text","media_link","number","media_file","single_option","multiple_options","boolean","date","record"],"x-immutable":true},"value_per_locale":{"type":"boolean","description":"Whether the attribute is localizable, i.e. can have one value by locale","default":false,"x-immutable":true},"value_per_channel":{"type":"boolean","description":"Whether the attribute is scopable, i.e. can have one value by channel","default":false,"x-immutable":true},"is_required_for_completeness":{"type":"boolean","description":"Whether the attribute should be part of the record's completeness calculation","default":false},"is_read_only":{"type":"boolean","description":"Whether the attribute should be in read only mode only in the UI, but you can still update it with the API","default":false},"max_characters":{"type":"integer","description":"Maximum number of characters allowed for the value of the attribute when the attribute type is `text`","x-warning":"Only for `text` attribute type"},"is_textarea":{"type":"boolean","description":"Whether the UI should display a text area instead of a simple field when the attribute type is `text`","default":false,"x-warning":"Only for `text` attribute type"},"is_rich_text_editor":{"type":"boolean","description":"Whether the UI should display a rich text editor instead of a simple text area when the attribute type is `text`","x-validation-rules":"Required when the property `is_textarea` is equal to `true`","x-warning":"Only for `text` attribute type"},"validation_rule":{"type":"string","description":"Validation rule type used to validate the attribute value when the attribute type is `text`","default":"none","x-warning":"Only for `text` attribute type","enum":["email","url","regexp","none"]},"validation_regexp":{"type":"string","description":"Regexp expression used to validate the attribute value when the attribute type is `text`","default":null,"x-validation-rules":"Required when the property `validation_rule` is equal to `regexp`","x-warning":"Only for `text` attribute type"},"allowed_extensions":{"type":"array","description":"Extensions allowed when the attribute type is `media_file`","default":[],"x-warning":"Only for `media_file` attribute type","items":{"type":"string"}},"max_file_size":{"type":"string","description":"Max file size in MB when the attribute type is `media_file`","default":null,"x-warning":"Only for `media_file` attribute type"},"decimals_allowed":{"type":"boolean","description":"Whether decimals are allowed when the attribute type is `number`","default":false,"x-warning":"Only for `number` attribute type"},"min_value":{"type":"string","description":"Minimum value allowed when the attribute type is `number`","default":null,"x-validation-rules":"The minimum value must be lower than the maximum value","x-warning":"Only for `number` attribute type"},"max_value":{"type":"string","description":"Maximum value allowed when the attribute type is `number`","default":null,"x-validation-rules":"The maximum value must be greater than the minimum value","x-warning":"Only for `number` attribute type"},"media_type":{"type":"string","description":"For the `media_link` attribute type, it is the type of the media behind the url, to allow its preview in the PIM. For the `media_file` attribute type, it is the type of the file.","enum":["image","pdf","youtube","vimeo","other"],"x-warning":"Only required for `media_link` and `media_file` attribute types"},"prefix":{"type":"string","description":"Prefix of the `media_link` attribute type. The common url root that prefixes the link to the media","default":null,"x-warning":"Only for `media_link` attribute type"},"suffix":{"type":"string","description":"Suffix of the `media_link` attribute type. The common url suffix for the media","default":null,"x-warning":"Only for `media_link` attribute type"},"reference_entity":{"type":"string","description":"Reference entity code for the `record` attribute type (see Reference entity).","default":null,"x-warning":"Only for `record` attribute type","x-from-version":"SaaS"}},"example":{"code":"model_is_wearing_size","labels":{"en_US":"Model is wearing size","fr_FR":"Le mannequin porte la taille"},"type":"single_option","value_per_locale":false,"value_per_channel":false,"is_required_for_completeness":true}}},"x-examples":[{"code":"model_is_wearing_size","labels":{"en_US":"Model is wearing size","fr_FR":"Le mannequin porte la taille"},"type":"single_option","value_per_locale":false,"value_per_channel":false,"is_required_for_completeness":true},{"code":"media_link","labels":{"en_US":"Media link","fr_FR":"Lien vers le média"},"type":"media_link","value_per_locale":false,"value_per_channel":false,"is_required_for_completeness":true,"prefix":"https://my-dam.com/","suffix":"?height=630&width=485","media_type":"image"},{"code":"warning_mention","labels":{"en_US":"Warning mention","fr_FR":"Phrase d'avertissement"},"type":"text","value_per_locale":true,"value_per_channel":false,"is_required_for_completeness":false,"max_characters":"50","is_textarea":false,"is_rich_text_editor":false,"validation_rule":"none","validation_regexp":null}]},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}}},"/api/rest/v1/asset-families/{asset_family_code}/attributes/{code}":{"get":{"summary":"Get an attribute of a given asset family","operationId":"get_asset_family_attributes__code_","tags":["Asset attribute"],"x-versions":["3.2","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"description":"This endpoint allows you to get the information about a given attribute for a given asset family.","parameters":[{"name":"asset_family_code","in":"path","description":"Code of the asset family","required":true,"type":"string"},{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the asset attribute in JSON format","schema":{"type":"object","required":["code","type","media_type"],"properties":{"code":{"type":"string","description":"Attribute code","x-immutable":true},"labels":{"type":"object","description":"Attribute labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute label for the locale `localeCode`"}}},"type":{"type":"string","description":"Attribute type. See type section for more details.","enum":["text","media_link","number","media_file","single_option","multiple_options","boolean","date","record"],"x-immutable":true},"value_per_locale":{"type":"boolean","description":"Whether the attribute is localizable, i.e. can have one value by locale","default":false,"x-immutable":true},"value_per_channel":{"type":"boolean","description":"Whether the attribute is scopable, i.e. can have one value by channel","default":false,"x-immutable":true},"is_required_for_completeness":{"type":"boolean","description":"Whether the attribute should be part of the record's completeness calculation","default":false},"is_read_only":{"type":"boolean","description":"Whether the attribute should be in read only mode only in the UI, but you can still update it with the API","default":false},"max_characters":{"type":"integer","description":"Maximum number of characters allowed for the value of the attribute when the attribute type is `text`","x-warning":"Only for `text` attribute type"},"is_textarea":{"type":"boolean","description":"Whether the UI should display a text area instead of a simple field when the attribute type is `text`","default":false,"x-warning":"Only for `text` attribute type"},"is_rich_text_editor":{"type":"boolean","description":"Whether the UI should display a rich text editor instead of a simple text area when the attribute type is `text`","x-validation-rules":"Required when the property `is_textarea` is equal to `true`","x-warning":"Only for `text` attribute type"},"validation_rule":{"type":"string","description":"Validation rule type used to validate the attribute value when the attribute type is `text`","default":"none","x-warning":"Only for `text` attribute type","enum":["email","url","regexp","none"]},"validation_regexp":{"type":"string","description":"Regexp expression used to validate the attribute value when the attribute type is `text`","default":null,"x-validation-rules":"Required when the property `validation_rule` is equal to `regexp`","x-warning":"Only for `text` attribute type"},"allowed_extensions":{"type":"array","description":"Extensions allowed when the attribute type is `media_file`","default":[],"x-warning":"Only for `media_file` attribute type","items":{"type":"string"}},"max_file_size":{"type":"string","description":"Max file size in MB when the attribute type is `media_file`","default":null,"x-warning":"Only for `media_file` attribute type"},"decimals_allowed":{"type":"boolean","description":"Whether decimals are allowed when the attribute type is `number`","default":false,"x-warning":"Only for `number` attribute type"},"min_value":{"type":"string","description":"Minimum value allowed when the attribute type is `number`","default":null,"x-validation-rules":"The minimum value must be lower than the maximum value","x-warning":"Only for `number` attribute type"},"max_value":{"type":"string","description":"Maximum value allowed when the attribute type is `number`","default":null,"x-validation-rules":"The maximum value must be greater than the minimum value","x-warning":"Only for `number` attribute type"},"media_type":{"type":"string","description":"For the `media_link` attribute type, it is the type of the media behind the url, to allow its preview in the PIM. For the `media_file` attribute type, it is the type of the file.","enum":["image","pdf","youtube","vimeo","other"],"x-warning":"Only required for `media_link` and `media_file` attribute types"},"prefix":{"type":"string","description":"Prefix of the `media_link` attribute type. The common url root that prefixes the link to the media","default":null,"x-warning":"Only for `media_link` attribute type"},"suffix":{"type":"string","description":"Suffix of the `media_link` attribute type. The common url suffix for the media","default":null,"x-warning":"Only for `media_link` attribute type"},"reference_entity":{"type":"string","description":"Reference entity code for the `record` attribute type (see Reference entity).","default":null,"x-warning":"Only for `record` attribute type","x-from-version":"SaaS"}},"example":{"code":"model_is_wearing_size","labels":{"en_US":"Model is wearing size","fr_FR":"Le mannequin porte la taille"},"type":"single_option","value_per_locale":false,"value_per_channel":false,"is_required_for_completeness":true}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"patch":{"summary":"Update/create an attribute of a given asset family","operationId":"patch_asset_family_attributes__code_","tags":["Asset attribute"],"x-versions":["3.2","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"description":"This endpoint allows you to update a given attribute for a given asset family. Note that if the attribute does not already exist for the given asset family, it creates it.","parameters":[{"name":"asset_family_code","in":"path","description":"Code of the asset family","required":true,"type":"string"},{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"},{"name":"body","in":"body","required":true,"schema":{"type":"object","required":["code","type","media_type"],"properties":{"code":{"type":"string","description":"Attribute code","x-immutable":true},"labels":{"type":"object","description":"Attribute labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute label for the locale `localeCode`"}}},"type":{"type":"string","description":"Attribute type. See type section for more details.","enum":["text","media_link","number","media_file","single_option","multiple_options","boolean","date","record"],"x-immutable":true},"value_per_locale":{"type":"boolean","description":"Whether the attribute is localizable, i.e. can have one value by locale","default":false,"x-immutable":true},"value_per_channel":{"type":"boolean","description":"Whether the attribute is scopable, i.e. can have one value by channel","default":false,"x-immutable":true},"is_required_for_completeness":{"type":"boolean","description":"Whether the attribute should be part of the record's completeness calculation","default":false},"is_read_only":{"type":"boolean","description":"Whether the attribute should be in read only mode only in the UI, but you can still update it with the API","default":false},"max_characters":{"type":"integer","description":"Maximum number of characters allowed for the value of the attribute when the attribute type is `text`","x-warning":"Only for `text` attribute type"},"is_textarea":{"type":"boolean","description":"Whether the UI should display a text area instead of a simple field when the attribute type is `text`","default":false,"x-warning":"Only for `text` attribute type"},"is_rich_text_editor":{"type":"boolean","description":"Whether the UI should display a rich text editor instead of a simple text area when the attribute type is `text`","x-validation-rules":"Required when the property `is_textarea` is equal to `true`","x-warning":"Only for `text` attribute type"},"validation_rule":{"type":"string","description":"Validation rule type used to validate the attribute value when the attribute type is `text`","default":"none","x-warning":"Only for `text` attribute type","enum":["email","url","regexp","none"]},"validation_regexp":{"type":"string","description":"Regexp expression used to validate the attribute value when the attribute type is `text`","default":null,"x-validation-rules":"Required when the property `validation_rule` is equal to `regexp`","x-warning":"Only for `text` attribute type"},"allowed_extensions":{"type":"array","description":"Extensions allowed when the attribute type is `media_file`","default":[],"x-warning":"Only for `media_file` attribute type","items":{"type":"string"}},"max_file_size":{"type":"string","description":"Max file size in MB when the attribute type is `media_file`","default":null,"x-warning":"Only for `media_file` attribute type"},"decimals_allowed":{"type":"boolean","description":"Whether decimals are allowed when the attribute type is `number`","default":false,"x-warning":"Only for `number` attribute type"},"min_value":{"type":"string","description":"Minimum value allowed when the attribute type is `number`","default":null,"x-validation-rules":"The minimum value must be lower than the maximum value","x-warning":"Only for `number` attribute type"},"max_value":{"type":"string","description":"Maximum value allowed when the attribute type is `number`","default":null,"x-validation-rules":"The maximum value must be greater than the minimum value","x-warning":"Only for `number` attribute type"},"media_type":{"type":"string","description":"For the `media_link` attribute type, it is the type of the media behind the url, to allow its preview in the PIM. For the `media_file` attribute type, it is the type of the file.","enum":["image","pdf","youtube","vimeo","other"],"x-warning":"Only required for `media_link` and `media_file` attribute types"},"prefix":{"type":"string","description":"Prefix of the `media_link` attribute type. The common url root that prefixes the link to the media","default":null,"x-warning":"Only for `media_link` attribute type"},"suffix":{"type":"string","description":"Suffix of the `media_link` attribute type. The common url suffix for the media","default":null,"x-warning":"Only for `media_link` attribute type"},"reference_entity":{"type":"string","description":"Reference entity code for the `record` attribute type (see Reference entity).","default":null,"x-warning":"Only for `record` attribute type","x-from-version":"SaaS"}},"example":{"code":"model_is_wearing_size","labels":{"en_US":"Model is wearing size","fr_FR":"Le mannequin porte la taille"},"type":"single_option","value_per_locale":false,"value_per_channel":false,"is_required_for_completeness":true}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"204":{"description":"No content to return","x-details":"Means that the update was successful","headers":{"Location":{"description":"URI of the updated resource","type":"string"}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/asset-families/{asset_family_code}/attributes/{attribute_code}/options":{"get":{"summary":"Get a list of attribute options of a given attribute for a given asset family","operationId":"get_asset_family_attributes__attribute_code__options","description":"This endpoint allows you to get a list of attribute options for a given asset family.","tags":["Asset attribute option"],"x-versions":["3.2","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"parameters":[{"name":"asset_family_code","in":"path","description":"Code of the asset family","required":true,"type":"string"},{"name":"attribute_code","in":"path","description":"Code of the attribute","required":true,"type":"string"}],"responses":{"200":{"description":"Return the options of the given attribute of the given asset family","x-no-entity":true,"schema":{"type":"array","items":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Attribute's option code","x-immutable":true},"labels":{"type":"object","description":"Attribute labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute label for the locale `localeCode`"}}}},"example":{"code":"small","labels":{"en_US":"S","fr_FR":"S"}}}},"x-examples":[{"code":"unique_size","labels":{"en_US":"Unique size","fr_FR":"Taille unique"}},{"code":"size_27","labels":{"en_US":"Size 27","fr_FR":"Taille 36"}},{"code":"small","labels":{"en_US":"S","fr_FR":"S"}}]},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}}},"/api/rest/v1/asset-families/{asset_family_code}/attributes/{attribute_code}/options/{code}":{"get":{"summary":"Get an attribute option for a given attribute of a given asset family","operationId":"get_asset_attributes__attribute_code__options__code_","description":"This endpoint allows you to get the information about a given asset attribute option.","tags":["Asset attribute option"],"x-versions":["3.2","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"parameters":[{"name":"asset_family_code","in":"path","description":"Code of the asset family","required":true,"type":"string"},{"name":"attribute_code","in":"path","description":"Code of the attribute","required":true,"type":"string"},{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the asset attribute option in JSON format","schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Attribute's option code","x-immutable":true},"labels":{"type":"object","description":"Attribute labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute label for the locale `localeCode`"}}}},"example":{"code":"small","labels":{"en_US":"S","fr_FR":"S"}}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"patch":{"summary":"Update/create an asset attribute option for a given asset family","operationId":"patch_asset_attributes__attribute_code__options__code_","tags":["Asset attribute option"],"x-versions":["3.2","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"description":"This endpoint allows you to update a given option for a given attribute and a given asset family. Learn more about the Update behavior. Note that if the option does not already exist for the given attribute of the given asset family, it creates it.","parameters":[{"name":"asset_family_code","in":"path","description":"Code of the asset family","required":true,"type":"string"},{"name":"attribute_code","in":"path","description":"Code of the attribute","required":true,"type":"string"},{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"},{"name":"body","in":"body","required":true,"schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Attribute's option code","x-immutable":true},"labels":{"type":"object","description":"Attribute labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute label for the locale `localeCode`"}}}},"example":{"code":"small","labels":{"en_US":"S","fr_FR":"S"}}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"204":{"description":"No content to return","x-details":"Means that the update was successful","headers":{"Location":{"description":"URI of the updated resource","type":"string"}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/asset-media-files":{"post":{"summary":"Create a new media file for an asset","operationId":"post_asset_media_files","description":"This endpoint allows you to create a new media file and associate it to a media file attribute value of an asset.","tags":["Asset media file"],"x-versions":["3.2","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"parameters":[{"name":"Content-type","in":"header","type":"string","description":"Equal to 'multipart/form-data', no other value allowed","required":true},{"name":"body","in":"body","x-form-data":true,"schema":{"required":["file"],"properties":{"file":{"type":"string","description":"The binary of the media file","format":"binary"}}}}],"responses":{"201":{"description":"Created","x-details":"Means that the media file creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"},"Asset-media-file-code":{"description":"Code of the media file","type":"string"}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `multipart/form-data`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘multipart/form-data’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/asset-media-files/{code}":{"get":{"summary":"Download the media file associated to an asset","operationId":"get_asset_media_files__code","description":"This endpoint allows you to download a given media file that is associated with an asset.","x-content-type":"Mime-type of the media file","tags":["Asset media file"],"x-versions":["3.2","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the binary of the media file","x-content-type":"Mime-type of the media file"},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}}}}},"/api/rest/v1/asset-families/{asset_family_code}/assets":{"get":{"summary":"Get the list of the assets of a given asset family","operationId":"get_assets","tags":["Asset"],"x-versions":["3.2","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"description":"This endpoint allows you to get a list of assets of a given asset family. Assets are paginated. This endpoint is case sensitive on the asset family code.","parameters":[{"name":"search","in":"query","description":"Filter assets, for more details see the Asset filters section","required":false,"type":"string"},{"name":"channel","in":"query","type":"string","description":"Filter asset values to return scopable asset attributes for the given channel as well as the non localizable/non scopable asset attributes, for more details see the Filter asset values by channel section","required":false},{"name":"locales","in":"query","type":"string","description":"Filter asset values to return localizable attributes for the given locales as well as the non localizable/non scopable asset attributes, for more details see the Filter asset values by locale section","required":false},{"name":"asset_family_code","in":"path","description":"Code of the asset family","required":true,"type":"string"},{"name":"search_after","in":"query","description":"Cursor when using the `search_after` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"string","default":"cursor to the first page"}],"responses":{"200":{"description":"Return the assets of the given asset family paginated","schema":{"title":"Asset","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}}}},{"properties":{"_embedded":{"type":"object","properties":{"_items":{"type":"array","items":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Code of the asset","x-immutable":true},"values":{"type":"object","description":"Asset attributes values, see the Focus on the asset values section for more details.","x-validation-rules":"Validation rules detailed in Asset attribute values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","description":"Channel code of the asset attribute value"},"locale":{"type":"string","description":"Locale code of the asset attribute value"},"data":{"type":"object","description":"Asset attribute value. See the `data` format section for more details."},"_links":{"type":"object","description":"Related links for the `media file` attribute values. See the `_links` format section for more details.","x-validation-rules":"The share link is returned for the **main** `media file` attribute when asset sharing is enabled"},"linked_data":{"type":"object","description":"Linked data for the `media link` attribute values. See the `linked_data` format section for more details.","x-from-version":"SaaS"}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true,"x-from-version":"6.0"},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true,"x-from-version":"6.0"}},"example":{"code":"sku_54628_picture1","values":{"media_preview":[{"locale":null,"channel":null,"data":"sku_54628_picture1.jpg"}],"model_wears_size":[{"locale":null,"channel":null,"data":"s"}],"photographer":[{"locale":null,"channel":null,"data":"ben_levy"}],"main_colors":[{"locale":null,"channel":null,"data":["red","purple"]}],"end_of_use_date":[{"locale":null,"channel":null,"data":"02/03/2021"}]},"created":"2021-05-31T09:23:34+00:00","updated":"2021-05-31T09:23:34+00:00"}}]}}}}}}]},"examples":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/asset-families/model_pictures/assets"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/asset-families/model_pictures/assets"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/asset-families/model_pictures/assets?search_after=2x088w%3D%3D"}},"_embedded":{"_items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/asset-families/model_pictures/assets/allie_jean_model_picture"}},"code":"allie_jean_model_picture","values":{"media_file":[{"locale":null,"channel":null,"data":"0/0/9/d/009d38fe8c97e16f6b48bbf8f6cf8a9564401cc9_allie_jean_model_picture.png","_links":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/asset-media-files/0/0/9/d/009d38fe8c97e16f6b48bbf8f6cf8a9564401cc9_allie_jean_model_picture.png"},"share_link":{"href":"https://demo.asset.akeneo.com/model_pictures/allie_jean_model_picture.png"}}}],"media_link":[{"locale":null,"channel":null,"data":"allie_jean_model_picture.png","linked_data":{"full_url":"https://example.com/allie_jean_model_picture.png","prefix":"https://example.com/","suffix":null}}],"model_is_wearing_size":[{"locale":null,"channel":null,"data":"size_27"}],"warning_mention":[{"data":"Photo not retouched","locale":"en_US","channel":null},{"data":"Photo non retouchée","locale":"fr_FR","channel":null}]},"created":"2021-05-31T09:23:34+00:00","updated":"2021-05-31T09:23:34+00:00"},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/asset-families/model_pictures/assets/amy_socks_model_picture"}},"code":"amy_socks_model_picture","values":{"media_file":[{"locale":null,"channel":null,"data":"0/0/9/d/009d38fe8c97e16f6b48bbf8f6cf8a9564401cc9_amy_socks_model_picture.png","_links":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/asset-media-files/0/0/9/d/009d38fe8c97e16f6b48bbf8f6cf8a9564401cc9_amy_socks_model_picture.png"},"share_link":{"href":"https://demo.asset.akeneo.com/model_pictures/amy_socks_model_picture.jpg"}}}],"media_link":[{"locale":null,"channel":null,"data":"amy_socks_model_picture.png","linked_data":{"full_url":"https://example.com/amy_socks_model_picture.png","prefix":"https://example.com/","suffix":null}}],"model_is_wearing_size":[{"locale":null,"channel":null,"data":"unique_size"}],"warning_mention":[{"data":"Photo not retouched","locale":"en_US","channel":null},{"data":"Photo non retouchée","locale":"fr_FR","channel":null}]},"created":"2021-05-31T09:23:34+00:00","updated":"2021-05-31T09:23:34+00:00"},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/asset-families/model_pictures/assets/alice_blouse_model_picture"}},"code":"alice_blouse_model_picture","values":{"media_file":[{"locale":null,"channel":null,"data":"0/0/9/d/009d38fe8c97e16f6b48bbf8f6cf8a9564401cc9_alice_blouse_model_picture.png","_links":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/asset-media-files/0/0/9/d/009d38fe8c97e16f6b48bbf8f6cf8a9564401cc9_alice_blouse_model_picture.png"},"share_link":{"href":"https://demo.asset.akeneo.com/model_pictures/alice_blouse_model_picture.png"}}}],"media_link":[{"locale":null,"channel":null,"data":"alice_blouse_model_picture.png","linked_data":{"full_url":"https://example.com/alice_blouse_model_picture.png","prefix":"https://example.com/","suffix":null}}],"model_is_wearing_size":[{"locale":null,"channel":null,"data":"small"}],"warning_mention":[{"data":"Photo retouched","locale":"en_US","channel":null},{"data":"Photo non retouchée","locale":"fr_FR","channel":null}]},"created":"2021-05-31T09:23:34+00:00","updated":"2021-05-31T09:23:34+00:00"}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"patch":{"summary":"Update/create several assets","operationId":"patch_assets","tags":["Asset"],"x-versions":["3.2","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"description":"This endpoint allows you to update and/or create several assets of one given asset family at once. Learn more about the Update behavior. Note that if the asset does not already exist for the given asset family, it creates it. This endpoint is case sensitive on the asset family code.","parameters":[{"name":"asset_family_code","in":"path","description":"Code of the asset family","required":true,"type":"string"},{"name":"body","in":"body","required":true,"schema":{"type":"array","items":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Code of the asset","x-immutable":true},"values":{"type":"object","description":"Asset attributes values, see the Focus on the asset values section for more details.","x-validation-rules":"Validation rules detailed in Asset attribute values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","description":"Channel code of the asset attribute value"},"locale":{"type":"string","description":"Locale code of the asset attribute value"},"data":{"type":"object","description":"Asset attribute value. See the `data` format section for more details."},"_links":{"type":"object","description":"Related links for the `media file` attribute values. See the `_links` format section for more details.","x-validation-rules":"The share link is returned for the **main** `media file` attribute when asset sharing is enabled"},"linked_data":{"type":"object","description":"Linked data for the `media link` attribute values. See the `linked_data` format section for more details.","x-from-version":"SaaS"}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true,"x-from-version":"6.0"},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true,"x-from-version":"6.0"}},"example":{"code":"sku_54628_picture1","values":{"media_preview":[{"locale":null,"channel":null,"data":"sku_54628_picture1.jpg"}],"model_wears_size":[{"locale":null,"channel":null,"data":"s"}],"photographer":[{"locale":null,"channel":null,"data":"ben_levy"}],"main_colors":[{"locale":null,"channel":null,"data":["red","purple"]}],"end_of_use_date":[{"locale":null,"channel":null,"data":"02/03/2021"}]},"created":"2021-05-31T09:23:34+00:00","updated":"2021-05-31T09:23:34+00:00"}},"example":[{"code":"sku_54628_picture1","values":{"media_preview":[{"locale":null,"channel":null,"data":"sku_54628_picture1.jpg"}],"model_wears_size":[{"locale":null,"channel":null,"data":"s"}],"photographer":[{"locale":null,"channel":null,"data":"ben_levy"}],"main_colors":[{"locale":null,"channel":null,"data":["red","purple"]}],"end_of_use_date":[{"locale":null,"channel":null,"data":"02/03/2021"}]},"created":"2021-05-31T09:23:34+00:00","updated":"2021-05-31T09:23:34+00:00"},{"code":"sku_54628_picture2","values":{"media_preview":[{"locale":null,"channel":null,"data":"sku_54628_picture2.jpg"}],"model_wears_size":[{"locale":null,"channel":null,"data":"s"}],"photographer":[{"locale":null,"channel":null,"data":"ben_levy"}],"main_colors":[{"locale":null,"channel":null,"data":["blue","white"]}],"end_of_use_date":[{"locale":null,"channel":null,"data":"02/03/2021"}]},"created":"2021-05-31T09:23:34+00:00","updated":"2021-05-31T09:23:34+00:00"},{"code":"sku_54628_picture3","values":{"media_preview":[{"locale":null,"channel":null,"data":"sku_54628_picture3.jpg"}],"model_wears_size":[{"locale":null,"channel":null,"data":"s"}],"photographer":[{"locale":null,"channel":null,"data":"ben_levy"}],"main_colors":[{"locale":null,"channel":null,"data":["purple"]}],"end_of_use_date":[{"locale":null,"channel":null,"data":"02/03/2021"}]},"created":"2021-05-31T09:23:34+00:00","updated":"2021-05-31T09:23:34+00:00"}]}}],"responses":{"200":{"description":"OK","x-details":"Returns an JSON array in which each object gives you the status of each asset creation or update","x-no-entity":true,"schema":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Resource code"},"status_code":{"type":"integer","description":"HTTP status code, see Client errors to understand the meaning of each code"},"message":{"type":"string","description":"Message explaining the error"}}}},"x-examples":[{"code":"sku_54628_picture1","status_code":204},{"code":"sku_54628_picture2","status_code":422,"message":"Property 'group' does not exist."},{"code":"sku_54628_picture3","status_code":201}]},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"413":{"description":"Request Entity Too Large","x-details":"There are too many resources to process (max 100) or the line of JSON is too long (max 1 000 000 characters)","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":413,"message":"Too many resources to process, 100 is the maximum allowed."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/vnd.akeneo.collection+json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/vnd.akeneo.collection+json’ is allowed."}}}}},"/api/rest/v1/asset-families/{asset_family_code}/assets/{code}":{"get":{"summary":"Get an asset of a given asset family","operationId":"get_assets__code_","tags":["Asset"],"x-versions":["3.2","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"description":"This endpoint allows you to get the information about a given asset for a given asset family. This endpoint is case sensitive on the asset family code.","parameters":[{"name":"asset_family_code","in":"path","description":"Code of the asset family","required":true,"type":"string"},{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the asset in JSON standard format","schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Code of the asset","x-immutable":true},"values":{"type":"object","description":"Asset attributes values, see the Focus on the asset values section for more details.","x-validation-rules":"Validation rules detailed in Asset attribute values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","description":"Channel code of the asset attribute value"},"locale":{"type":"string","description":"Locale code of the asset attribute value"},"data":{"type":"object","description":"Asset attribute value. See the `data` format section for more details."},"_links":{"type":"object","description":"Related links for the `media file` attribute values. See the `_links` format section for more details.","x-validation-rules":"The share link is returned for the **main** `media file` attribute when asset sharing is enabled"},"linked_data":{"type":"object","description":"Linked data for the `media link` attribute values. See the `linked_data` format section for more details.","x-from-version":"SaaS"}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true,"x-from-version":"6.0"},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true,"x-from-version":"6.0"}},"example":{"code":"sku_54628_picture1","values":{"media_preview":[{"locale":null,"channel":null,"data":"sku_54628_picture1.jpg"}],"model_wears_size":[{"locale":null,"channel":null,"data":"s"}],"photographer":[{"locale":null,"channel":null,"data":"ben_levy"}],"main_colors":[{"locale":null,"channel":null,"data":["red","purple"]}],"end_of_use_date":[{"locale":null,"channel":null,"data":"02/03/2021"}]},"created":"2021-05-31T09:23:34+00:00","updated":"2021-05-31T09:23:34+00:00"}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"patch":{"summary":"Update/create an asset","operationId":"patch_asset__code_","tags":["Asset"],"x-versions":["3.2","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"description":"This endpoint allows you to update a given asset of a given asset family. Learn more about the Update behavior. Note that if the asset does not already exist for the given asset family, it creates it. This endpoint is case sensitive on the asset family code.","parameters":[{"name":"asset_family_code","in":"path","description":"Code of the asset family","required":true,"type":"string"},{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"},{"name":"body","in":"body","required":true,"schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Code of the asset","x-immutable":true},"values":{"type":"object","description":"Asset attributes values, see the Focus on the asset values section for more details.","x-validation-rules":"Validation rules detailed in Asset attribute values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","description":"Channel code of the asset attribute value"},"locale":{"type":"string","description":"Locale code of the asset attribute value"},"data":{"type":"object","description":"Asset attribute value. See the `data` format section for more details."},"_links":{"type":"object","description":"Related links for the `media file` attribute values. See the `_links` format section for more details.","x-validation-rules":"The share link is returned for the **main** `media file` attribute when asset sharing is enabled"},"linked_data":{"type":"object","description":"Linked data for the `media link` attribute values. See the `linked_data` format section for more details.","x-from-version":"SaaS"}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true,"x-from-version":"6.0"},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true,"x-from-version":"6.0"}},"example":{"code":"sku_54628_picture1","values":{"media_preview":[{"locale":null,"channel":null,"data":"sku_54628_picture1.jpg"}],"model_wears_size":[{"locale":null,"channel":null,"data":"s"}],"photographer":[{"locale":null,"channel":null,"data":"ben_levy"}],"main_colors":[{"locale":null,"channel":null,"data":["red","purple"]}],"end_of_use_date":[{"locale":null,"channel":null,"data":"02/03/2021"}]},"created":"2021-05-31T09:23:34+00:00","updated":"2021-05-31T09:23:34+00:00"}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"204":{"description":"No content to return","x-details":"Means that the update was successful","headers":{"Location":{"description":"URI of the updated resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}},"delete":{"summary":"Delete an asset","operationId":"delete_assets__code_","tags":["Asset"],"x-versions":["3.2","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"description":"This endpoint allows you to delete a given asset. This endpoint is case sensitive on the asset family code.","parameters":[{"name":"asset_family_code","in":"path","description":"Code of the asset family","required":true,"type":"string"},{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"204":{"description":"No content to return","x-details":"Means that the deletion was successful"},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}}}}},"/api/rest/v1/assets":{"get":{"summary":"Get list of PAM assets","operationId":"get_pam_assets","description":"This endpoint allows you to get a list of PAM assets. PAM assets are paginated.","tags":["PAM asset"],"x-versions":["2.1","2.2","2.3","3.x"],"x-ee":true,"x-deprecated":true,"parameters":[{"name":"pagination_type","in":"query","description":"Pagination method type, see Pagination section","required":false,"type":"string","default":"page","x-validation-rules":"One of the following values","enum":["page","search_after"]},{"name":"page","in":"query","description":"Number of the page to retrieve when using the `page` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"integer","default":1},{"name":"search_after","in":"query","description":"Cursor when using the `search_after` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"string","default":"cursor to the first page"},{"name":"limit","in":"query","description":"Number of results by page, see Pagination section","required":false,"type":"integer","minimum":1,"maximum":100,"default":10},{"name":"with_count","in":"query","description":"Return the count of items in the response. Be carefull with that, on a big catalog, it can decrease performance in a significative way","default":false,"type":"boolean","required":false}],"responses":{"200":{"description":"Returns PAM assets paginated","schema":{"title":"PAM Assets","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"previous":{"type":"object","properties":{"href":{"type":"string","description":"URI of the previous page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}},"current_page":{"type":"integer","description":"Current page number"}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"PAM asset code","x-immutable":true},"categories":{"type":"array","description":"Codes of the PAM asset categories in which the asset is classified","x-validation-rules":"Each string of the array is equal to an existing asset category code","items":{"type":"string"},"default":[]},"description":{"type":"string","description":"Description of the PAM asset","default":null},"localizable":{"type":"boolean","description":"Whether the asset is localized or not, meaning if you want to have different reference files for each of your locale","default":false,"x-immutable":true},"tags":{"type":"array","description":"Tags of the PAM asset","items":{"type":"string"},"default":[]},"end_of_use":{"type":"string","description":"Date on which the PAM asset expire","format":"dateTime","default":null,"x-validation-rules":"The date follows the ISO 8601 format"},"variation_files":{"type":"array","description":"Variations of the PAM asset","x-read-only":true,"items":{"type":"object","properties":{"_link":{"type":"object","description":"Links to get and download the variation file","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the variation entity"}}},"download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the variation file"}}}}},"locale":{"type":"string","description":"Locale code of the variation"},"scope":{"type":"string","description":"Channel code of the variation"},"code":{"type":"string","description":"Code of the variation"}}}},"reference_files":{"type":"array","description":"Reference files of the PAM asset","x-read-only":true,"items":{"type":"object","properties":{"_link":{"type":"object","description":"Links to get and download the reference file","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the reference file entity"}}},"download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the reference file"}}}}},"locale":{"type":"string","description":"Locale code of the reference file"},"code":{"type":"string","description":"Code of the reference file"}}}}},"example":{"code":"tshirt_artemis_main_picture","categories":["tshirts_assets"],"description":"The main picture of the Artemis t-shirt","localizable":false,"tags":["tshirts","red","summer"],"end_of_use":"2019-09-01T00:00:00+0200","variation_files":[{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/ecommerce/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/ecommerce/no_locale"}},"locale":null,"scope":"e_commerce","code":"7/5/8/e/758e39d48va7b42a55001434fd3d7b6cf3189b7f_tshirt_artemis_main_picture_ecommerce.jpg"},{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/print/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/print/no_locale"}},"locale":null,"scope":"print","code":"7/5/8/e/759e39d48va7b42a55002434fd3d7b6cf3189b7f_tshirt_artemis_main_picture_print.jpg"}],"reference_files":[{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/reference-files/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/reference-files/no_locale"}},"locale":null,"code":"7/5/8/e/759e39d48va7b42a55002434fd3d7b6cf3189b7f_tshirt_artemis_main_picture.jpg"}]}}]}}}}}}]},"examples":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets?page=2&limit=3"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/assets?page=1&limit=3"},"previous":{"href":"https://demo.akeneo.com/api/rest/v1/assets?page=1&limit=3"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/assets?page=3&limit=3"}},"current_page":2,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture"}},"code":"tshirt_artemis_main_picture","categories":["tshirts_assets"],"description":"The main picture of the Artemis t-shirt","localizable":false,"tags":["tshirts","red","summer"],"end_of_use":"2019-09-01T00:00:00+0200","variation_files":[{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/ecommerce/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/ecommerce/no_locale"}},"locale":null,"scope":"e_commerce","code":"7/5/8/e/758e39d48va7b42a55001434fd3d7b6cf3189b7f_tshirt_artemis_main_picture_ecommerce.jpg"},{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/print/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/print/no_locale"}},"locale":null,"scope":"print","code":"7/5/8/e/759e39d48va7b42a55002434fd3d7b6cf3189b7f_tshirt_artemis_main_picture_print.jpg"}],"reference_files":[{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/reference-files/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/reference-files/no_locale"}},"locale":null,"code":"7/5/8/e/759e39d48va7b42a55002434fd3d7b6cf3189b7f_tshirt_artemis_main_picture.jpg"}]},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_profile_picture"}},"code":"tshirt_artemis_profile_picture","categories":["tshirts_assets"],"description":"The profile picture of the Artemis t-shirt","localizable":false,"tags":["tshirts","red","summer","profile_views"],"end_of_use":"2019-09-01T00:00:00+0200","variation_files":[{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_profile_picture/variation-files/ecommerce/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_profile_picture/variation-files/ecommerce/no_locale"}},"locale":null,"scope":"e_commerce","code":"7/5/8/e/758e39d48va7b42a55001434fd3d7b6cf3189b7f_tshirt_artemis_profile_picture_ecommerce.jpg"},{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_profile_picture/variation-files/print/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_profile_picture/variation-files/print/no_locale"}},"locale":null,"scope":"print","code":"7/5/8/e/759e39d48va7b42a55002434fd3d7b6cf3189b7f_tshirt_artemis_profile_picture_print.jpg"}],"reference_files":[{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_profile_picture/reference-files/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_profile_picture/reference-files/no_locale"}},"locale":null,"code":"7/5/8/e/759e39d48va7b42a55002434fd3d7b6cf3189b7f_tshirt_artemis_profile_picture.jpg"}]},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_maintenance_manual"}},"code":"tshirt_artemis_maintenance_manual","categories":["tshirts_assets"],"description":"The maintenance manual of the Artemis t-shirt","localizable":true,"tags":["tshirts","manuals"],"end_of_use":null,"variation_files":[],"reference_files":[{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_maintenance_manual/reference-files/en_US/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_maintenance_manual/reference-files/en_US"}},"locale":"en_US","code":"7/5/8/e/759e39d48va7b42a55002434fd3d7b6cf3189b7f_tshirt_artemis_maintenance_manual_en_US.pdf"},{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_maintenance_manual/reference-files/fr_FR/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_maintenance_manual/reference-files/fr_FR"}},"locale":"fr_FR","code":"7/5/8/e/759e39d48va7b42a55002434fd3d7b6cf3189b7f_tshirt_artemis_maintenance_manual_fr_FR.pdf"}]}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"post":{"summary":"Create a new PAM asset","operationId":"post_pam_assets","description":"This endpoint allows you to create a new PAM asset.","tags":["PAM asset"],"x-versions":["2.1","2.2","2.3","3.x"],"x-ee":true,"x-deprecated":true,"parameters":[{"name":"body","in":"body","schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"PAM asset code","x-immutable":true},"categories":{"type":"array","description":"Codes of the PAM asset categories in which the asset is classified","x-validation-rules":"Each string of the array is equal to an existing asset category code","items":{"type":"string"},"default":[]},"description":{"type":"string","description":"Description of the PAM asset","default":null},"localizable":{"type":"boolean","description":"Whether the asset is localized or not, meaning if you want to have different reference files for each of your locale","default":false,"x-immutable":true},"tags":{"type":"array","description":"Tags of the PAM asset","items":{"type":"string"},"default":[]},"end_of_use":{"type":"string","description":"Date on which the PAM asset expire","format":"dateTime","default":null,"x-validation-rules":"The date follows the ISO 8601 format"},"variation_files":{"type":"array","description":"Variations of the PAM asset","x-read-only":true,"items":{"type":"object","properties":{"_link":{"type":"object","description":"Links to get and download the variation file","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the variation entity"}}},"download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the variation file"}}}}},"locale":{"type":"string","description":"Locale code of the variation"},"scope":{"type":"string","description":"Channel code of the variation"},"code":{"type":"string","description":"Code of the variation"}}}},"reference_files":{"type":"array","description":"Reference files of the PAM asset","x-read-only":true,"items":{"type":"object","properties":{"_link":{"type":"object","description":"Links to get and download the reference file","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the reference file entity"}}},"download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the reference file"}}}}},"locale":{"type":"string","description":"Locale code of the reference file"},"code":{"type":"string","description":"Code of the reference file"}}}}},"example":{"code":"tshirt_artemis_main_picture","categories":["tshirts_assets"],"description":"The main picture of the Artemis t-shirt","localizable":false,"tags":["tshirts","red","summer"],"end_of_use":"2019-09-01T00:00:00+0200","variation_files":[{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/ecommerce/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/ecommerce/no_locale"}},"locale":null,"scope":"e_commerce","code":"7/5/8/e/758e39d48va7b42a55001434fd3d7b6cf3189b7f_tshirt_artemis_main_picture_ecommerce.jpg"},{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/print/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/print/no_locale"}},"locale":null,"scope":"print","code":"7/5/8/e/759e39d48va7b42a55002434fd3d7b6cf3189b7f_tshirt_artemis_main_picture_print.jpg"}],"reference_files":[{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/reference-files/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/reference-files/no_locale"}},"locale":null,"code":"7/5/8/e/759e39d48va7b42a55002434fd3d7b6cf3189b7f_tshirt_artemis_main_picture.jpg"}]}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}},"patch":{"summary":"Update/create several PAM assets","operationId":"patch_pam_assets","tags":["PAM asset"],"x-versions":["2.1","2.2","2.3","3.x"],"x-ee":true,"x-deprecated":true,"description":"This endpoint allows you to update several PAM assets at once.","x-body-by-line":"Contains several lines, each line is a PAM asset in JSON format","parameters":[{"name":"body","in":"body","schema":{"x-examples":{"x-example-1":"{\"code\":\"tshirt_aria_main_picture\",\"categories\":[\"tshirts_assets\"],\"tags\":[\"tshirts\", \"red\", \"summer\"]}","x-example-2":"{\"code\":\"tshirt_artemis_maintenance_manual\",\"categories\":[\"tshirts_assets\",\"short_sleeve\"]}","x-example-3":"{\"code\":\"tshirt_artemis_main_picture\",\"tags\":[\"tshirts\", \"red\", \"summer\",\"short_sleeve\"]}"},"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"PAM asset code","x-immutable":true},"categories":{"type":"array","description":"Codes of the PAM asset categories in which the asset is classified","x-validation-rules":"Each string of the array is equal to an existing asset category code","items":{"type":"string"},"default":[]},"description":{"type":"string","description":"Description of the PAM asset","default":null},"localizable":{"type":"boolean","description":"Whether the asset is localized or not, meaning if you want to have different reference files for each of your locale","default":false,"x-immutable":true},"tags":{"type":"array","description":"Tags of the PAM asset","items":{"type":"string"},"default":[]},"end_of_use":{"type":"string","description":"Date on which the PAM asset expire","format":"dateTime","default":null,"x-validation-rules":"The date follows the ISO 8601 format"},"variation_files":{"type":"array","description":"Variations of the PAM asset","x-read-only":true,"items":{"type":"object","properties":{"_link":{"type":"object","description":"Links to get and download the variation file","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the variation entity"}}},"download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the variation file"}}}}},"locale":{"type":"string","description":"Locale code of the variation"},"scope":{"type":"string","description":"Channel code of the variation"},"code":{"type":"string","description":"Code of the variation"}}}},"reference_files":{"type":"array","description":"Reference files of the PAM asset","x-read-only":true,"items":{"type":"object","properties":{"_link":{"type":"object","description":"Links to get and download the reference file","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the reference file entity"}}},"download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the reference file"}}}}},"locale":{"type":"string","description":"Locale code of the reference file"},"code":{"type":"string","description":"Code of the reference file"}}}}},"example":{"code":"tshirt_artemis_main_picture","categories":["tshirts_assets"],"description":"The main picture of the Artemis t-shirt","localizable":false,"tags":["tshirts","red","summer"],"end_of_use":"2019-09-01T00:00:00+0200","variation_files":[{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/ecommerce/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/ecommerce/no_locale"}},"locale":null,"scope":"e_commerce","code":"7/5/8/e/758e39d48va7b42a55001434fd3d7b6cf3189b7f_tshirt_artemis_main_picture_ecommerce.jpg"},{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/print/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/print/no_locale"}},"locale":null,"scope":"print","code":"7/5/8/e/759e39d48va7b42a55002434fd3d7b6cf3189b7f_tshirt_artemis_main_picture_print.jpg"}],"reference_files":[{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/reference-files/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/reference-files/no_locale"}},"locale":null,"code":"7/5/8/e/759e39d48va7b42a55002434fd3d7b6cf3189b7f_tshirt_artemis_main_picture.jpg"}]}}}],"responses":{"200":{"description":"OK","x-details":"Returns a plain text response whose lines are JSON containing the status of each update or creation","x-no-entity":true,"schema":{"type":"object","properties":{"line":{"type":"integer","description":"Line number"},"identifier":{"type":"string","description":"Resource identifier, only filled when the resource is a product"},"code":{"type":"string","description":"Resource code, only filled when the resource is not a product"},"status_code":{"type":"integer","description":"HTTP status code, see Client errors to understand the meaning of each code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"x-example-1":"{\"line\":1,\"code\":\"tshirt_aria_main_picture\",\"status_code\":201}","x-example-2":"{\"line\":2,\"code\":\"tshirt_artemis_maintenance_manual\",\"status_code\":422,\"message\":\"Category \"short_sleeve\" does not exist.\"}","x-example-3":"{\"line\":3,\"code\":\"tshirt_artemis_main_picture\",\"status_code\":204}"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"413":{"description":"Request Entity Too Large","x-details":"There are too many resources to process (max 100) or the line of JSON is too long (max 1 000 000 characters)","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":413,"message":"Too many resources to process, 100 is the maximum allowed."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/vnd.akeneo.collection+json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/vnd.akeneo.collection+json’ is allowed."}}}}},"/api/rest/v1/assets/{code}":{"get":{"summary":"Get a PAM asset","operationId":"get_pam_assets__code_","description":"This endpoint allows you to get the information about a given PAM asset.","tags":["PAM asset"],"x-versions":["2.1","2.2","2.3","3.x"],"x-ee":true,"x-deprecated":true,"parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the PAM asset in JSON format","schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"PAM asset code","x-immutable":true},"categories":{"type":"array","description":"Codes of the PAM asset categories in which the asset is classified","x-validation-rules":"Each string of the array is equal to an existing asset category code","items":{"type":"string"},"default":[]},"description":{"type":"string","description":"Description of the PAM asset","default":null},"localizable":{"type":"boolean","description":"Whether the asset is localized or not, meaning if you want to have different reference files for each of your locale","default":false,"x-immutable":true},"tags":{"type":"array","description":"Tags of the PAM asset","items":{"type":"string"},"default":[]},"end_of_use":{"type":"string","description":"Date on which the PAM asset expire","format":"dateTime","default":null,"x-validation-rules":"The date follows the ISO 8601 format"},"variation_files":{"type":"array","description":"Variations of the PAM asset","x-read-only":true,"items":{"type":"object","properties":{"_link":{"type":"object","description":"Links to get and download the variation file","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the variation entity"}}},"download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the variation file"}}}}},"locale":{"type":"string","description":"Locale code of the variation"},"scope":{"type":"string","description":"Channel code of the variation"},"code":{"type":"string","description":"Code of the variation"}}}},"reference_files":{"type":"array","description":"Reference files of the PAM asset","x-read-only":true,"items":{"type":"object","properties":{"_link":{"type":"object","description":"Links to get and download the reference file","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the reference file entity"}}},"download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the reference file"}}}}},"locale":{"type":"string","description":"Locale code of the reference file"},"code":{"type":"string","description":"Code of the reference file"}}}}},"example":{"code":"tshirt_artemis_main_picture","categories":["tshirts_assets"],"description":"The main picture of the Artemis t-shirt","localizable":false,"tags":["tshirts","red","summer"],"end_of_use":"2019-09-01T00:00:00+0200","variation_files":[{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/ecommerce/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/ecommerce/no_locale"}},"locale":null,"scope":"e_commerce","code":"7/5/8/e/758e39d48va7b42a55001434fd3d7b6cf3189b7f_tshirt_artemis_main_picture_ecommerce.jpg"},{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/print/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/print/no_locale"}},"locale":null,"scope":"print","code":"7/5/8/e/759e39d48va7b42a55002434fd3d7b6cf3189b7f_tshirt_artemis_main_picture_print.jpg"}],"reference_files":[{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/reference-files/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/reference-files/no_locale"}},"locale":null,"code":"7/5/8/e/759e39d48va7b42a55002434fd3d7b6cf3189b7f_tshirt_artemis_main_picture.jpg"}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"patch":{"summary":"Update/create a PAM asset","operationId":"patch_pam_assets__code_","tags":["PAM asset"],"x-versions":["2.1","2.2","2.3","3.x"],"x-ee":true,"x-deprecated":true,"description":"This endpoint allows you to update a given PAM asset. Know more about Update behavior. Note that if no asset exists for the given code, it creates it.","parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"},{"name":"body","in":"body","required":true,"schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"PAM asset code","x-immutable":true},"categories":{"type":"array","description":"Codes of the PAM asset categories in which the asset is classified","x-validation-rules":"Each string of the array is equal to an existing asset category code","items":{"type":"string"},"default":[]},"description":{"type":"string","description":"Description of the PAM asset","default":null},"localizable":{"type":"boolean","description":"Whether the asset is localized or not, meaning if you want to have different reference files for each of your locale","default":false,"x-immutable":true},"tags":{"type":"array","description":"Tags of the PAM asset","items":{"type":"string"},"default":[]},"end_of_use":{"type":"string","description":"Date on which the PAM asset expire","format":"dateTime","default":null,"x-validation-rules":"The date follows the ISO 8601 format"},"variation_files":{"type":"array","description":"Variations of the PAM asset","x-read-only":true,"items":{"type":"object","properties":{"_link":{"type":"object","description":"Links to get and download the variation file","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the variation entity"}}},"download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the variation file"}}}}},"locale":{"type":"string","description":"Locale code of the variation"},"scope":{"type":"string","description":"Channel code of the variation"},"code":{"type":"string","description":"Code of the variation"}}}},"reference_files":{"type":"array","description":"Reference files of the PAM asset","x-read-only":true,"items":{"type":"object","properties":{"_link":{"type":"object","description":"Links to get and download the reference file","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the reference file entity"}}},"download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the reference file"}}}}},"locale":{"type":"string","description":"Locale code of the reference file"},"code":{"type":"string","description":"Code of the reference file"}}}}},"example":{"code":"tshirt_artemis_main_picture","categories":["tshirts_assets"],"description":"The main picture of the Artemis t-shirt","localizable":false,"tags":["tshirts","red","summer"],"end_of_use":"2019-09-01T00:00:00+0200","variation_files":[{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/ecommerce/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/ecommerce/no_locale"}},"locale":null,"scope":"e_commerce","code":"7/5/8/e/758e39d48va7b42a55001434fd3d7b6cf3189b7f_tshirt_artemis_main_picture_ecommerce.jpg"},{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/print/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/print/no_locale"}},"locale":null,"scope":"print","code":"7/5/8/e/759e39d48va7b42a55002434fd3d7b6cf3189b7f_tshirt_artemis_main_picture_print.jpg"}],"reference_files":[{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/reference-files/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/reference-files/no_locale"}},"locale":null,"code":"7/5/8/e/759e39d48va7b42a55002434fd3d7b6cf3189b7f_tshirt_artemis_main_picture.jpg"}]}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"204":{"description":"No content to return","x-details":"Means that the update was successful","headers":{"Location":{"description":"URI of the updated resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/assets/{asset_code}/reference-files/{locale_code}":{"get":{"summary":"Get a reference file","operationId":"get_reference_files__locale_code_","description":"This endpoint allows you to get the information about a reference file of a given PAM asset.","tags":["PAM asset reference file"],"x-versions":["2.1","2.2","2.3","3.x"],"x-ee":true,"x-deprecated":true,"parameters":[{"name":"asset_code","in":"path","description":"Code of the asset","required":true,"type":"string"},{"name":"locale_code","in":"path","description":"Code of the locale if the asset is localizable or equal to `no-locale` if the asset is not localizable","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the reference file in JSON format","schema":{"type":"object","properties":{"code":{"type":"string","description":"Code of the PAM asset reference file","x-immutable":true},"locale":{"type":"string","description":"Locale of the PAM asset reference file, equal to `null` if the asset is not localizable"},"_link":{"type":"object","description":"Links to get and download the reference file","properties":{"download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the reference file"}}}}}},"example":{"code":"7/5/8/e/759e39d48va7b42a55002434fd3d7b6cf3189b7f_tshirt_artemis_main_picture.jpg","locale":null,"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/reference-files/no_locale/download"}}}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"post":{"summary":"Upload a new reference file","operationId":"post_reference_files__locale_code_","description":"This endpoint allows you to upload a new reference file for a given PAM asset and locale. It will also automatically generate all the variation files corresponding to this reference file.","tags":["PAM asset reference file"],"x-versions":["2.1","2.2","2.3","3.x"],"x-ee":true,"x-deprecated":true,"parameters":[{"name":"asset_code","in":"path","description":"Code of the asset","required":true,"type":"string"},{"name":"locale_code","in":"path","description":"Code of the locale if the asset is localizable or equal to `no-locale` if the asset is not localizable","required":true,"type":"string"},{"name":"Content-type","in":"header","type":"string","description":"Equal to 'multipart/form-data', no other value allowed","required":true},{"name":"body","in":"body","x-form-data":true,"schema":{"required":["file"],"properties":{"file":{"type":"string","description":"The binaries of the file","format":"binary"}}}}],"responses":{"201":{"description":"Uploaded","x-details":"Means that the reference file upload was successful. Beware that even if the reference file upload is complete, some variation files generations could have failed. If so, you will see a warning message in the response body.","headers":{"Location":{"description":"URI of the created resource","type":"string"}},"x-no-entity":true,"schema":{"type":"object","properties":{"message":{"type":"string","description":"Message explaining the warning"},"errors":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","description":"Channel for which the variation file generation failed"},"locale":{"type":"string","description":"Locale for which the variation file generation failed"},"message":{"type":"string","description":"Message explaining why the variation file generation failed"}}}}}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `multipart/form-data`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘multipart/form-data’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/assets/{asset_code}/reference-files/{locale_code}/download":{"get":{"summary":"Download a reference file","operationId":"get_reference_files__channel_code__locale_code__download","description":"This endpoint allows you to download a given reference file.","x-content-type":"Mime-type of the reference file","tags":["PAM asset reference file"],"x-versions":["2.1","2.2","2.3","3.x"],"x-ee":true,"x-deprecated":true,"parameters":[{"name":"asset_code","in":"path","description":"Code of the asset","required":true,"type":"string"},{"name":"locale_code","in":"path","description":"Code of the locale if the asset is localizable or equal to `no-locale` if the asset is not localizable","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the binary of the reference file","x-content-type":"Mime-type of the reference file"},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}}}}},"/api/rest/v1/assets/{asset_code}/variation-files/{channel_code}/{locale_code}":{"get":{"summary":"Get a variation file","operationId":"get_variation_files__channel_code__locale_code","description":"This endpoint allows you to get the information about a variation file of a given PAM asset.","tags":["PAM asset variation file"],"x-versions":["2.1","2.2","2.3","3.x"],"x-ee":true,"x-deprecated":true,"parameters":[{"name":"asset_code","in":"path","description":"Code of the asset","required":true,"type":"string"},{"name":"channel_code","in":"path","description":"Code of the channel","required":true,"type":"string"},{"name":"locale_code","in":"path","description":"Code of the locale if the asset is localizable or equal to `no-locale` if the asset is not localizable","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the variation file in JSON format","schema":{"type":"object","properties":{"code":{"type":"string","description":"Code of the PAM asset variation file","x-immutable":true},"locale":{"type":"string","description":"Locale of the PAM asset variation file, equal to `null` if the asset is not localizable"},"scope":{"type":"string","description":"Channel of the PAM asset variation file"},"_link":{"type":"object","description":"Links to get and download the reference file","properties":{"download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the variation file"}}}}}},"example":{"code":"7/5/8/e/758e39d48va7b42a55001434fd3d7b6cf3189b7f_tshirt_artemis_main_picture_ecommerce.jpg","locale":null,"scope":"ecommerce","_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/ecommerce/no_locale/download"}}}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"post":{"summary":"Upload a new variation file","operationId":"post_variation_files__channel_code__locale_code_","description":"This endpoint allows you to upload a new variation file for a given PAM asset, channel and locale.","tags":["PAM asset variation file"],"x-versions":["2.1","2.2","2.3","3.x"],"x-ee":true,"x-deprecated":true,"parameters":[{"name":"asset_code","in":"path","description":"Code of the asset","required":true,"type":"string"},{"name":"channel_code","in":"path","description":"Code of the channel","required":true,"type":"string"},{"name":"locale_code","in":"path","description":"Code of the locale if the asset is localizable or equal to `no-locale` if the asset is not localizable","required":true,"type":"string"},{"name":"Content-type","in":"header","type":"string","description":"Equal to 'multipart/form-data', no other value allowed","required":true},{"name":"body","in":"body","x-form-data":true,"schema":{"required":["file"],"properties":{"file":{"type":"string","description":"The binaries of the file","format":"binary"}}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `multipart/form-data`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘multipart/form-data’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/assets/{asset_code}/variation-files/{channel_code}/{locale_code}/download":{"get":{"summary":"Download a variation file","operationId":"get_variation_files__channel_code__locale_code__download","description":"This endpoint allows you to download a given variation file.","x-content-type":"Mime-type of the variation file","tags":["PAM asset variation file"],"x-versions":["2.1","2.2","2.3","3.x"],"x-ee":true,"x-deprecated":true,"parameters":[{"name":"asset_code","in":"path","description":"Code of the asset","required":true,"type":"string"},{"name":"channel_code","in":"path","description":"Code of the channel","required":true,"type":"string"},{"name":"locale_code","in":"path","description":"Code of the locale if the asset is localizable or equal to `no-locale` if the asset is not localizable","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the binary of the variation file","x-content-type":"Mime-type of the variation file"},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}}}}},"/api/rest/v1/asset-categories":{"get":{"summary":"Get list of PAM asset categories","operationId":"get_asset_categories","description":"This endpoint allows you to get a list of PAM asset categories. PAM asset categories are paginated and sorted by `root/left`.","tags":["PAM asset category"],"x-versions":["2.1","2.2","2.3","3.x"],"x-ee":true,"x-deprecated":true,"parameters":[{"name":"page","in":"query","description":"Number of the page to retrieve when using the `page` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"integer","default":1},{"name":"limit","in":"query","description":"Number of results by page, see Pagination section","required":false,"type":"integer","minimum":1,"maximum":100,"default":10},{"name":"with_count","in":"query","description":"Return the count of items in the response. Be carefull with that, on a big catalog, it can decrease performance in a significative way","default":false,"type":"boolean","required":false}],"responses":{"200":{"description":"Returns PAM asset categories paginated","schema":{"title":"PAM Asset Categories","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"previous":{"type":"object","properties":{"href":{"type":"string","description":"URI of the previous page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}},"current_page":{"type":"integer","description":"Current page number"}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"PAM asset category code","x-immutable":true},"parent":{"type":"string","description":"PAM ssset category code of the parent's asset category","x-validation-rules":"• It is either equal to `null` or to an existing asset category code. • If equal to an existing asset category code, it cannot reference itself.","default":"null"},"labels":{"type":"object","description":"PAM asset category labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"PAM asset category label for the locale `localeCode`"}}}},"example":{"code":"front_views","parent":"pictures","labels":{"en_US":"Front views","fr_FR":"Vues de face"}}}]}}}}}}]},"examples":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/asset-categories?page=2&limit=3"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/asset-categories?page=1&limit=3"},"previous":{"href":"https://demo.akeneo.com/api/rest/v1/asset-categories?page=1&limit=3"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/asset-categories?page=3&limit=3"}},"current_page":2,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/asset-categories/pictures"}},"code":"pictures","parent":null,"labels":{"en_US":"Pictures","fr_FR":"Images","de_DE":"Bilder"}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/asset-categories/front_views"}},"code":"front_views","parent":"pictures","labels":{"en_US":"Front views","fr_FR":"Vues de face","de_DE":"Vorderansichten"}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/asset-categories/side_views"}},"code":"side_views","parent":"pictures","labels":{"en_US":"Side views","fr_FR":"Vues de profil","de_DE":"Profilansichten"}}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"post":{"summary":"Create a new PAM asset category","operationId":"post_asset_categories","description":"This endpoint allows you to create a new PAM asset category.","tags":["PAM asset category"],"x-versions":["2.1","2.2","2.3","3.x"],"x-ee":true,"x-deprecated":true,"parameters":[{"name":"body","in":"body","schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"PAM asset category code","x-immutable":true},"parent":{"type":"string","description":"PAM ssset category code of the parent's asset category","x-validation-rules":"• It is either equal to `null` or to an existing asset category code. • If equal to an existing asset category code, it cannot reference itself.","default":"null"},"labels":{"type":"object","description":"PAM asset category labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"PAM asset category label for the locale `localeCode`"}}}},"example":{"code":"front_views","parent":"pictures","labels":{"en_US":"Front views","fr_FR":"Vues de face"}}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}},"patch":{"summary":"Update/create several PAM asset categories","operationId":"patch_asset_categories","tags":["PAM asset category"],"x-versions":["2.1","2.2","2.3","3.x"],"x-ee":true,"x-deprecated":true,"description":"This endpoint allows you to update several PAM asset categories at once.","x-body-by-line":"Contains several lines, each line is a category in JSON standard format","parameters":[{"name":"body","in":"body","schema":{"x-examples":{"x-example-1":"{\"code\":\"pictures\",\"parent\":null}","x-example-2":"{\"code\":\"front_views\",\"parent\":\"pitures\"}","x-example-3":"{\"code\":\"other_views\",\"parent\":\"pictures\"}"},"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"PAM asset category code","x-immutable":true},"parent":{"type":"string","description":"PAM ssset category code of the parent's asset category","x-validation-rules":"• It is either equal to `null` or to an existing asset category code. • If equal to an existing asset category code, it cannot reference itself.","default":"null"},"labels":{"type":"object","description":"PAM asset category labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"PAM asset category label for the locale `localeCode`"}}}},"example":{"code":"front_views","parent":"pictures","labels":{"en_US":"Front views","fr_FR":"Vues de face"}}}}],"responses":{"200":{"description":"OK","x-details":"Returns a plain text response whose lines are JSON containing the status of each update or creation","x-no-entity":true,"schema":{"type":"object","properties":{"line":{"type":"integer","description":"Line number"},"identifier":{"type":"string","description":"Resource identifier, only filled when the resource is a product"},"code":{"type":"string","description":"Resource code, only filled when the resource is not a product"},"status_code":{"type":"integer","description":"HTTP status code, see Client errors to understand the meaning of each code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"x-example-1":"{\"line\":1,\"code\":\"spring_collection\",\"status_code\":201}","x-example-2":"{\"line\":2,\"code\":\"front_views\",\"status_code\":422,\"message\":\"Asset category \"pitures\" does not exist.\"}","x-example-3":"{\"line\":3,\"code\":\"other_views\",\"status_code\":204}"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"413":{"description":"Request Entity Too Large","x-details":"There are too many resources to process (max 100) or the line of JSON is too long (max 1 000 000 characters)","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":413,"message":"Too many resources to process, 100 is the maximum allowed."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/vnd.akeneo.collection+json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/vnd.akeneo.collection+json’ is allowed."}}}}},"/api/rest/v1/asset-categories/{code}":{"get":{"summary":"Get a PAM asset category","operationId":"get_asset_categories__code_","description":"This endpoint allows you to get the information about a given PAM asset category.","tags":["PAM asset category"],"x-versions":["2.1","2.2","2.3","3.x"],"x-ee":true,"x-deprecated":true,"parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the asset category in JSON standard format","schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"PAM asset category code","x-immutable":true},"parent":{"type":"string","description":"PAM ssset category code of the parent's asset category","x-validation-rules":"• It is either equal to `null` or to an existing asset category code. • If equal to an existing asset category code, it cannot reference itself.","default":"null"},"labels":{"type":"object","description":"PAM asset category labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"PAM asset category label for the locale `localeCode`"}}}},"example":{"code":"front_views","parent":"pictures","labels":{"en_US":"Front views","fr_FR":"Vues de face"}}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"patch":{"summary":"Update/create a PAM asset category","operationId":"patch_asset_categories__code_","tags":["PAM asset category"],"x-versions":["2.1","2.2","2.3","3.x"],"x-ee":true,"x-deprecated":true,"description":"This endpoint allows you to update a given PAM asset category. Know more about Update behavior. Note that if no category exists for the given code, it creates it.","parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"},{"name":"body","in":"body","required":true,"schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"PAM asset category code","x-immutable":true},"parent":{"type":"string","description":"PAM ssset category code of the parent's asset category","x-validation-rules":"• It is either equal to `null` or to an existing asset category code. • If equal to an existing asset category code, it cannot reference itself.","default":"null"},"labels":{"type":"object","description":"PAM asset category labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"PAM asset category label for the locale `localeCode`"}}}},"example":{"code":"front_views","parent":"pictures","labels":{"en_US":"Front views","fr_FR":"Vues de face"}}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"204":{"description":"No content to return","x-details":"Means that the update was successful","headers":{"Location":{"description":"URI of the updated resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/asset-tags":{"get":{"summary":"Get list of PAM asset tags","operationId":"get_asset_tags","description":"This endpoint allows you to get a list of PAM asset tags. PAM asset tags are paginated.","tags":["PAM asset tag"],"x-versions":["2.1","2.2","2.3","3.x"],"x-ee":true,"x-deprecated":true,"parameters":[{"name":"page","in":"query","description":"Number of the page to retrieve when using the `page` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"integer","default":1},{"name":"limit","in":"query","description":"Number of results by page, see Pagination section","required":false,"type":"integer","minimum":1,"maximum":100,"default":10},{"name":"with_count","in":"query","description":"Return the count of items in the response. Be carefull with that, on a big catalog, it can decrease performance in a significative way","default":false,"type":"boolean","required":false}],"responses":{"200":{"description":"Returns PAM asset tags paginated","schema":{"title":"PAM Asset Tags","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"previous":{"type":"object","properties":{"href":{"type":"string","description":"URI of the previous page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}},"current_page":{"type":"integer","description":"Current page number"}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"PAM asset tag code","x-immutable":true}},"example":{"code":"tshirt"}}]}}}}}}]},"examples":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/asset-tags?page=2&limit=3"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/asset-tags?page=1&limit=3"},"previous":{"href":"https://demo.akeneo.com/api/rest/v1/asset-tags?page=1&limit=3"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/asset-tags?page=3&limit=3"}},"current_page":2,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/asset-tags/tshirt"}},"code":"tshirt"},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/asset-tags/belt"}},"code":"belt"},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/asset-tags/red"}},"code":"red"}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}}},"/api/rest/v1/asset-tags/{code}":{"get":{"summary":"Get a PAM asset tag","operationId":"get_asset_tags__code_","description":"This endpoint allows you to get the information about a given PAM asset tag.","tags":["PAM asset tag"],"x-versions":["2.1","2.2","2.3","3.x"],"x-ee":true,"x-deprecated":true,"parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the asset tag in JSON format","schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"PAM asset tag code","x-immutable":true}},"example":{"code":"tshirt"}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"patch":{"summary":"Update/create a PAM asset tag","operationId":"patch_asset_tags__code_","tags":["PAM asset tag"],"x-versions":["2.1","2.2","2.3","3.x"],"x-ee":true,"x-deprecated":true,"description":"This endpoint allows you to update a given PAM asset tag. Know more about Update behavior. Note that if no tag exists for the given code, it creates it.","parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"},{"name":"body","in":"body","required":true,"schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"PAM asset tag code","x-immutable":true}},"example":{"code":"tshirt"}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"204":{"description":"No content to return","x-details":"Means that the update was successful","headers":{"Location":{"description":"URI of the updated resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/catalogs":{"get":{"summary":"Get the list of owned catalogs","operationId":"get_app_catalogs","description":"This endpoint allows you to get the list of catalogs you owned.","tags":["Catalogs"],"x-versions":["SaaS"],"x-app-token":true,"parameters":[{"name":"page","in":"query","description":"Number of the page to retrieve when using the `page` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"integer","default":1},{"name":"limit","in":"query","description":"Number of results by page, see Pagination section","required":false,"type":"integer","minimum":1,"maximum":100,"default":100}],"responses":{"200":{"description":"Return the paginated catalogs owned by the user making the request","schema":{"title":"Catalogs","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"previous":{"type":"object","properties":{"href":{"type":"string","description":"URI of the previous page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}},"current_page":{"type":"integer","description":"Current page number"}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","properties":{"id":{"type":"string","description":"Catalog id","x-immutable":true},"name":{"type":"string","description":"Catalog name"},"enabled":{"type":"boolean","description":"Whether the catalog is enabled or not","default":false},"managed_currencies":{"type":"array","description":"List of currency codes","items":{"type":"string"}},"managed_locales":{"type":"array","description":"List of locale codes","items":{"type":"string"}}},"example":{"_links":{"self":{"href":"http://demo.akeneo.com/api/rest/v1/catalogs/3af8e091-6df5-4ed1-a9aa-090de12e5be5"}},"id":"12351d98-200e-4bbc-aa19-7fdda1bd14f2","name":"My app catalog","enabled":false,"managed_currencies":["EUR","USD","GBP"],"managed_locales":["fr_FR","en_US"]}}]}}}}}}]},"x-examples":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/catalogs?page=3&limit=2"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/catalogs?page=1&limit=2"},"previous":{"href":"https://demo.akeneo.com/api/rest/v1/catalogs?page=2&limit=2"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/catalogs?page=4&limit=2"}},"current_page":3,"_embedded":{"items":[{"id":"12351d98-200e-4bbc-aa19-7fdda1bd14f2","name":"Store EUROPE","enabled":false,"managed_currencies":["EUR","GBP"],"managed_locales":["fr_FR","en_UK","de_DE","it_IT","es_ES"]},{"id":"092c5f22-ecd8-485f-97e9-3b78098e1386","name":"Store US","enabled":true,"managed_currencies":["USD"],"managed_locales":["en_US","es_ES"]}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The app does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list catalogs."}}}},"post":{"summary":"Create a new catalog","operationId":"post_app_catalog","tags":["Catalogs"],"x-versions":["SaaS"],"x-app-token":true,"description":"This endpoint allows you to create a new catalog.","parameters":[{"name":"body","in":"body","schema":{"type":"object","required":["name"],"properties":{"name":{"type":"string","description":"Catalog name"},"managed_currencies":{"type":"array","description":"List of currency codes","items":{"type":"string"}},"managed_locales":{"type":"array","description":"List of locale codes","items":{"type":"string"}}},"example":{"name":"My app catalog","managed_currencies":["EUR","USD","GBP"],"managed_locales":["fr_FR","en_US"]}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","schema":{"type":"object","properties":{"id":{"type":"string","description":"Catalog id","x-immutable":true},"name":{"type":"string","description":"Catalog name"},"enabled":{"type":"boolean","description":"Whether the catalog is enabled or not","default":false},"managed_currencies":{"type":"array","description":"List of currency codes","items":{"type":"string"}},"managed_locales":{"type":"array","description":"List of locale codes","items":{"type":"string"}}},"example":{"_links":{"self":{"href":"http://demo.akeneo.com/api/rest/v1/catalogs/3af8e091-6df5-4ed1-a9aa-090de12e5be5"}},"id":"12351d98-200e-4bbc-aa19-7fdda1bd14f2","name":"My app catalog","enabled":false,"managed_currencies":["EUR","USD","GBP"],"managed_locales":["fr_FR","en_US"]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The app does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list catalogs."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"x-examples-per-version":[{"x-version":"SaaS","x-example":{"code":422,"message":"Validation failed.","errors":[{"property":"name","message":"This value should not be blank."},{"property":"name","message":"This value is too short. It should have 1 character or more."}]}}]}}}},"/api/rest/v1/catalogs/{id}":{"get":{"summary":"Get a catalog","operationId":"get_app_catalog","description":"This endpoint allows you to get the information about a catalog.","tags":["Catalogs"],"x-versions":["SaaS"],"x-app-token":true,"parameters":[{"name":"id","in":"path","description":"Catalog ID","required":true,"type":"string","format":"uuid"}],"responses":{"200":{"description":"Return the catalog","schema":{"type":"object","properties":{"id":{"type":"string","description":"Catalog id","x-immutable":true},"name":{"type":"string","description":"Catalog name"},"enabled":{"type":"boolean","description":"Whether the catalog is enabled or not","default":false},"managed_currencies":{"type":"array","description":"List of currency codes","items":{"type":"string"}},"managed_locales":{"type":"array","description":"List of locale codes","items":{"type":"string"}}},"example":{"_links":{"self":{"href":"http://demo.akeneo.com/api/rest/v1/catalogs/3af8e091-6df5-4ed1-a9aa-090de12e5be5"}},"id":"12351d98-200e-4bbc-aa19-7fdda1bd14f2","name":"My app catalog","enabled":false,"managed_currencies":["EUR","USD","GBP"],"managed_locales":["fr_FR","en_US"]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The app does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list catalogs."}},"404":{"description":"Catalog not found","x-details":"The catalog id given in the URI does not exist","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Catalog \"65f5a521-e65c-4d7b-8be8-1f267fa2729c\" does not exist or you can't access it."}}}},"patch":{"summary":"Update a catalog","operationId":"patch_app_catalog","tags":["Catalogs"],"x-versions":["SaaS"],"x-app-token":true,"description":"This endpoint allows you to update a catalog.","parameters":[{"name":"id","in":"path","description":"Catalog ID","required":true,"type":"string","format":"uuid"},{"name":"body","in":"body","schema":{"type":"object","required":["name"],"properties":{"name":{"type":"string","description":"Catalog name"},"managed_currencies":{"type":"array","description":"List of currency codes","items":{"type":"string"}},"managed_locales":{"type":"array","description":"List of locale codes","items":{"type":"string"}}},"example":{"name":"My app catalog","managed_currencies":["EUR","USD","GBP"],"managed_locales":["fr_FR","en_US"]}}}],"responses":{"200":{"description":"Updated","schema":{"type":"object","properties":{"id":{"type":"string","description":"Catalog id","x-immutable":true},"name":{"type":"string","description":"Catalog name"},"enabled":{"type":"boolean","description":"Whether the catalog is enabled or not","default":false},"managed_currencies":{"type":"array","description":"List of currency codes","items":{"type":"string"}},"managed_locales":{"type":"array","description":"List of locale codes","items":{"type":"string"}}},"example":{"_links":{"self":{"href":"http://demo.akeneo.com/api/rest/v1/catalogs/3af8e091-6df5-4ed1-a9aa-090de12e5be5"}},"id":"12351d98-200e-4bbc-aa19-7fdda1bd14f2","name":"My app catalog","enabled":false,"managed_currencies":["EUR","USD","GBP"],"managed_locales":["fr_FR","en_US"]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The app does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list catalogs."}},"404":{"description":"Catalog not found","x-details":"The catalog id given in the URI does not exist","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Catalog \"65f5a521-e65c-4d7b-8be8-1f267fa2729c\" does not exist or you can't access it."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"x-examples-per-version":[{"x-version":"SaaS","x-example":{"code":422,"message":"Validation failed.","errors":[{"property":"name","message":"This value should not be blank."},{"property":"name","message":"This value is too short. It should have 1 character or more."}]}}]}}},"delete":{"summary":"Delete a catalog","operationId":"delete_app_catalog","tags":["Catalogs"],"x-versions":["SaaS"],"x-app-token":true,"description":"This endpoint allows you to delete a catalog.","parameters":[{"name":"id","in":"path","description":"Catalog ID","required":true,"type":"string","format":"uuid"}],"responses":{"204":{"description":"Deleted"},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The app does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list catalogs."}},"404":{"description":"Catalog not found","x-details":"The catalog id given in the URI does not exist","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Catalog \"65f5a521-e65c-4d7b-8be8-1f267fa2729c\" does not exist or you can't access it."}}}}},"/api/rest/v1/catalogs/{id}/product-uuids":{"get":{"summary":"Get the list of product uuids","operationId":"get_app_catalog_product_uuids","description":"This endpoint allows you to get the list of uuids of products contained in a catalog. Please, note that a disabled catalog can return an HTTP 200 with a payload containing an error message, for more details see the App Catalog section.","tags":["Catalog products"],"x-versions":["SaaS"],"x-app-token":true,"parameters":[{"name":"id","in":"path","description":"Id of the catalog","required":true,"type":"string","format":"uuid"},{"name":"search_after","in":"query","description":"Cursor when using the `search_after` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"string","default":"cursor to the first page"},{"name":"limit","in":"query","description":"Number of results by page, see Pagination section","required":false,"type":"integer","minimum":1,"maximum":1000,"default":100},{"name":"updated_before","in":"query","description":"Filter products that have been updated BEFORE the provided date (Only available on Catalogs endpoints). This filter uses the PIM products updated date.","type":"string","format":"date","required":false,"x-from-version":"SaaS"},{"name":"updated_after","in":"query","description":"Filter products that have been updated AFTER the provided date (Only available on Catalogs endpoints). This filter uses the PIM products updated date.","type":"string","format":"date","required":false,"x-from-version":"SaaS"},{"name":"with_count","in":"query","description":"Return the count of items in the response.","default":false,"type":"boolean","required":false}],"responses":{"200":{"description":"Return the paginated product uuids","schema":{"title":"Product uuids","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"string","format":"uuid"}}}}}}]},"x-examples":{"_links":{"self":{"href":"http://demo.akeneo.com/api/rest/v1/catalogs/12351d98-200e-4bbc-aa19-7fdda1bd14f2/product-uuids"},"first":{"href":"http://demo.akeneo.com/api/rest/v1/catalogs/12351d98-200e-4bbc-aa19-7fdda1bd14f2/product-uuids"},"next":{"href":"http://demo.akeneo.com/api/rest/v1/catalogs/12351d98-200e-4bbc-aa19-7fdda1bd14f2/product-uuids?search_after=eddfbd2a-abc7-488d-b9e3-41289c824f80"}},"_embedded":{"items":["844c736b-a19b-48a6-a354-6056044729f0","b2a683ef-4a91-4ed3-b3fa-76dab065a8d5","eddfbd2a-abc7-488d-b9e3-41289c824f80"]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The app does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list catalogs."}},"404":{"description":"Catalog not found","x-details":"The catalog id given in the URI does not exist","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Catalog \"65f5a521-e65c-4d7b-8be8-1f267fa2729c\" does not exist or you can't access it."}}}}},"/api/rest/v1/catalogs/{id}/products":{"get":{"summary":"Get the list of products related to a catalog","operationId":"get_app_catalog_products","tags":["Catalog products"],"x-versions":["SaaS"],"description":"This endpoint allows you to get the list of products related to a catalog. Products are paginated and they can be filtered. In the Enterprise Edition, permissions based on your app settings are applied to the set of products you request. Please, note that a disabled catalog can return an HTTP 200 with a payload containing an error message, for more details see the App Catalog section.","parameters":[{"name":"id","in":"path","description":"Catalog ID","required":true,"type":"string","format":"uuid"},{"name":"search_after","in":"query","description":"Cursor when using the `search_after` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"string","default":"cursor to the first page"},{"name":"limit","in":"query","description":"Number of results by page, see Pagination section","required":false,"type":"integer","minimum":1,"maximum":1000,"default":100},{"name":"updated_before","in":"query","description":"Filter products that have been updated BEFORE the provided date (Only available on Catalogs endpoints). This filter uses the PIM products updated date.","type":"string","format":"date","required":false,"x-from-version":"SaaS"},{"name":"updated_after","in":"query","description":"Filter products that have been updated AFTER the provided date (Only available on Catalogs endpoints). This filter uses the PIM products updated date.","type":"string","format":"date","required":false,"x-from-version":"SaaS"}],"responses":{"200":{"description":"Return the paginated products","schema":{"title":"Products","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"string","format":"uuid"}}}}}}]},"x-examples-per-version":[{"x-version":"SaaS","x-example":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/catalogs/65f5a521-e65c-4d7b-8be8-1f267fa2729c/products?limit=3"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/catalogs/65f5a521-e65c-4d7b-8be8-1f267fa2729c/products?limit=3"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/catalogs/65f5a521-e65c-4d7b-8be8-1f267fa2729c/products?search_after=0059d30f-6874-4277-81ed-3b3657c83f5e&limit=3"}},"_embedded":{"items":[{"uuid":"00073089-1310-4340-bcf0-9e33e4019b79","enabled":true,"family":"mens_clothing","categories":["Cloths"],"groups":[],"parent":null,"values":{"Default_Price":[{"locale":null,"scope":null,"data":[{"amount":"10.00","currency":"USD"}]}],"sku":[{"locale":null,"scope":null,"data":"product_416"}],"Name":[{"locale":null,"scope":null,"data":"Product 416"}],"Weight":[{"locale":null,"scope":null,"data":{"amount":10,"unit":"KILOGRAM"}}]},"created":"2022-03-14T15:25:45+00:00","updated":"2022-06-24T12:54:58+00:00","associations":{"PACK":{"products":[],"product_models":[],"groups":[]},"UPSELL":{"products":[],"product_models":[],"groups":[]},"X_SELL":{"products":[],"product_models":[],"groups":[]},"SUBSTITUTION":{"products":[],"product_models":[],"groups":[]}},"quantified_associations":{}},{"uuid":"00248acf-f1f7-45cb-b409-c8c4b9a17a86","enabled":true,"family":"mens_clothing","categories":["Cloths"],"groups":[],"parent":null,"values":{"Default_Price":[{"locale":null,"scope":null,"data":[{"amount":"10.00","currency":"USD"}]}],"sku":[{"locale":null,"scope":null,"data":"product_470"}],"Name":[{"locale":null,"scope":null,"data":"Product 470"}],"Weight":[{"locale":null,"scope":null,"data":{"amount":10,"unit":"KILOGRAM"}}]},"created":"2022-03-14T15:25:45+00:00","updated":"2022-06-24T12:55:01+00:00","associations":{"PACK":{"products":[],"product_models":[],"groups":[]},"UPSELL":{"products":[],"product_models":[],"groups":[]},"X_SELL":{"products":[],"product_models":[],"groups":[]},"SUBSTITUTION":{"products":[],"product_models":[],"groups":[]}},"quantified_associations":{}}]}}}]},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The app does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list catalogs."}},"404":{"description":"Catalog not found","x-details":"The catalog id given in the URI does not exist","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Catalog \"65f5a521-e65c-4d7b-8be8-1f267fa2729c\" does not exist or you can't access it."}}}}},"/api/rest/v1/catalogs/{id}/products/{uuid}":{"get":{"summary":"Get a product related to a catalog","operationId":"get_app_catalog_products_uuid","tags":["Catalog products"],"x-versions":["SaaS"],"description":"This endpoint allows you to get a specific product related to a catalog. In the Enterprise Edition, permissions based on your app settings are applied on the product you request. Please, note that a disabled catalog can return an HTTP 200 with a payload containing an error message, for more details see the App Catalog section.","parameters":[{"name":"id","in":"path","description":"Catalog ID","required":true,"type":"string","format":"uuid"},{"name":"uuid","in":"path","description":"Product UUID","required":true,"type":"string","format":"uuid"}],"responses":{"200":{"description":"Return the product","x-examples-per-version":[{"x-version":"SaaS","x-example":{"uuid":"a5eed606-4f98-4d8c-b926-5b59f8fb0ee7","family":"tshirt","groups":[],"parent":null,"categories":[],"enabled":true,"values":{"name":[{"data":"Top","locale":"en_US","scope":null}]}}}]},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The app does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list catalogs."}},"404":{"description":"Catalog not found","x-details":"The catalog id given in the URI does not exist","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Catalog \"65f5a521-e65c-4d7b-8be8-1f267fa2729c\" does not exist or you can't access it."}}}}},"/api/rest/v1/catalogs/{id}/mapping-schemas/product":{"put":{"summary":"Create or update the product mapping schema related to a catalog","operationId":"put_app_catalogs_mapping_schema_product","description":"This endpoint allows you to create or update the product mapping schema related to a catalog. See documentation to define your JSON schema.","tags":["Mapping schema for products"],"x-versions":["SaaS"],"x-app-token":true,"parameters":[{"name":"id","in":"path","description":"Catalog ID","required":true,"type":"string","format":"uuid"},{"name":"body","in":"body","schema":{"type":"object","required":["$schema","properties"],"properties":{"$id":{"type":"string","description":"id of your schema"},"$schema":{"type":"string","description":"$schema indicates which product mapping schema version your app uses"},"$comment":{"type":"string","description":"allows you to add a comment"},"title":{"type":"string","description":"allows you to add a title to your mapping schema"},"description":{"type":"string","description":"allows you to add a description of your mapping schema"},"type":{"type":"string","description":"should always be \"object\""},"properties":{"type":"object","description":"list and describe the targets your app expects"}},"example":{"$id":"https://example.com/product","$schema":"https://api.akeneo.com/mapping/product/1.0.0/schema","type":"object","properties":{"code":{"title":"Model ID","type":"string"},"brand":{"title":"Brand name","type":"string"},"description":{"title":"Product description","type":"string"},"fabrics":{"title":"Fabrics","type":"array","items":{"type":"string"}},"localized_names":{"title":"Name with multiple locales","type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"value":{"type":"string"}},"required":["locale","value"]}},"localized_number":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"value":{"type":"number"}},"required":["locale","value"]}},"localized_link":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"value":{"type":"string","format":"uri"}},"required":["locale","value"]}},"localized_datetime":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"value":{"type":"string","format":"date-time"}},"required":["locale","value"]}},"localized_boolean":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"value":{"type":"boolean"}},"required":["locale","value"]}},"variation_axes":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"label":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"value":{"type":"string"}}}}}}},"variants":{"oneOf":[{"type":"string","format":"uri"},{"type":"array","items":{"type":"object","properties":{"variation_axes_values":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"value":{"oneOf":[{"type":["string","boolean"]},{"type":"object","properties":{"amount":{"type":"number"},"unit":{"type":"string"}}}]},"label":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"value":{"type":"string"}}}}}}},"uuid":{"title":"uuid","type":"string"},"sku":{"title":"SKU","type":"string"},"position":{"title":"Position","type":"number"},"price":{"title":"Price","type":"string"},"response_time":{"title":"Response time","type":"string"},"localized_product_photos_media_file":{"title":"Photos with value per locale(links)","type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"value":{"type":"array","items":{"type":"string","format":"uri"}}},"required":["locale","value"]}},"localized_prices":{"title":"Price in multiple currencies with value per locale","type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"value":{"type":"array","items":{"type":"object","properties":{"amount":{"type":"number"},"currency":{"type":"string"}},"required":["amount","currency"]}}},"required":["locale","value"]}}},"required":["uuid"]}}]}}}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The app does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list catalogs."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"x-examples-per-version":[{"x-version":"SaaS","x-example":{"code":422,"message":"Validation failed.","errors":[{"property":"product_mapping_schema","message":"You must provide a valid schema."}]}}]}}},"get":{"summary":"Get the product mapping schema related to a catalog","operationId":"get_app_catalogs_mapping_schema_product","description":"This endpoint allows you to retrieve the product mapping schema related to a catalog","tags":["Mapping schema for products"],"x-versions":["SaaS"],"x-app-token":true,"parameters":[{"name":"id","in":"path","description":"Catalog ID","required":true,"type":"string","format":"uuid"}],"responses":{"200":{"description":"Return product mapping schema related to a catalog","schema":{"type":"object","required":["$schema","properties"],"properties":{"$id":{"type":"string","description":"id of your schema"},"$schema":{"type":"string","description":"$schema indicates which product mapping schema version your app uses"},"$comment":{"type":"string","description":"allows you to add a comment"},"title":{"type":"string","description":"allows you to add a title to your mapping schema"},"description":{"type":"string","description":"allows you to add a description of your mapping schema"},"type":{"type":"string","description":"should always be \"object\""},"properties":{"type":"object","description":"list and describe the targets your app expects"}},"example":{"$id":"https://example.com/product","$schema":"https://api.akeneo.com/mapping/product/1.0.0/schema","type":"object","properties":{"code":{"title":"Model ID","type":"string"},"brand":{"title":"Brand name","type":"string"},"description":{"title":"Product description","type":"string"},"fabrics":{"title":"Fabrics","type":"array","items":{"type":"string"}},"localized_names":{"title":"Name with multiple locales","type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"value":{"type":"string"}},"required":["locale","value"]}},"localized_number":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"value":{"type":"number"}},"required":["locale","value"]}},"localized_link":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"value":{"type":"string","format":"uri"}},"required":["locale","value"]}},"localized_datetime":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"value":{"type":"string","format":"date-time"}},"required":["locale","value"]}},"localized_boolean":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"value":{"type":"boolean"}},"required":["locale","value"]}},"variation_axes":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"label":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"value":{"type":"string"}}}}}}},"variants":{"oneOf":[{"type":"string","format":"uri"},{"type":"array","items":{"type":"object","properties":{"variation_axes_values":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"value":{"oneOf":[{"type":["string","boolean"]},{"type":"object","properties":{"amount":{"type":"number"},"unit":{"type":"string"}}}]},"label":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"value":{"type":"string"}}}}}}},"uuid":{"title":"uuid","type":"string"},"sku":{"title":"SKU","type":"string"},"position":{"title":"Position","type":"number"},"price":{"title":"Price","type":"string"},"response_time":{"title":"Response time","type":"string"},"localized_product_photos_media_file":{"title":"Photos with value per locale(links)","type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"value":{"type":"array","items":{"type":"string","format":"uri"}}},"required":["locale","value"]}},"localized_prices":{"title":"Price in multiple currencies with value per locale","type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"value":{"type":"array","items":{"type":"object","properties":{"amount":{"type":"number"},"currency":{"type":"string"}},"required":["amount","currency"]}}},"required":["locale","value"]}}},"required":["uuid"]}}]}}}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The app does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list catalogs."}},"404":{"description":"Catalog not found","x-details":"The catalog id given in the URI does not exist","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Catalog \"65f5a521-e65c-4d7b-8be8-1f267fa2729c\" does not exist or you can't access it."}}}},"delete":{"summary":"Delete the product mapping schema related to a catalog","operationId":"delete_app_catalogs_mapping_schema_product","description":"This endpoint allows you to delete the product mapping schema related to a catalog","tags":["Mapping schema for products"],"x-versions":["SaaS"],"x-app-token":true,"parameters":[{"name":"id","in":"path","description":"Catalog ID","required":true,"type":"string","format":"uuid"}],"responses":{"204":{"description":"Deleted"},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The app does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list catalogs."}},"404":{"description":"Catalog not found","x-details":"The catalog id given in the URI does not exist","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Catalog \"65f5a521-e65c-4d7b-8be8-1f267fa2729c\" does not exist or you can't access it."}}}}},"/api/rest/v1/catalogs/{id}/mapped-products":{"get":{"summary":"Get the list of mapped flattened products or simple products related to a catalog","operationId":"get_app_catalog_mapped_products","tags":["Catalog products"],"x-versions":["SaaS"],"description":"This endpoint is available when the mapping is enabled on a specified catalog. When the mapping is in a basic mode, this endpoint allows you to get the list of all flattened products related to the catalog. When it's in models/variants mode, this endpoint allows you to get the list of simple products with all specified targets in the two levels of the mapping schema. Please, note that a disabled catalog can return an HTTP 200 with a payload containing an error message, for more details see the App Catalog section.","parameters":[{"name":"id","in":"path","description":"Catalog ID","required":true,"type":"string","format":"uuid"},{"name":"search_after","in":"query","description":"Cursor when using the `search_after` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"string","default":"cursor to the first page"},{"name":"limit","in":"query","description":"Number of results by page, see Pagination section","required":false,"type":"integer","minimum":1,"maximum":100,"default":100},{"name":"updated_before","in":"query","description":"Filter products that have been updated BEFORE the provided date (Only available on Catalogs endpoints). This filter uses the PIM products updated date.","type":"string","format":"date","required":false,"x-from-version":"SaaS"},{"name":"updated_after","in":"query","description":"Filter products that have been updated AFTER the provided date (Only available on Catalogs endpoints). This filter uses the PIM products updated date.","type":"string","format":"date","required":false,"x-from-version":"SaaS"}],"responses":{"200":{"description":"Return the paginated **mapped** products","schema":{"title":"Products","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"string","format":"uuid"}}}}}}]},"x-examples-per-version":[{"x-version":"SaaS","x-example":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/catalogs/d259aecf-3ec1-4b07-ae0f-ce234b86c025/mapped-products?limit=100"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/catalogs/d259aecf-3ec1-4b07-ae0f-ce234b86c025/mapped-products?limit=100"}},"_embedded":{"items":[{"uuid":"04f47a54-8cc9-4c51-90e9-eb9aace0865f","title":"Canon Video Visualiser RE-455X","code":"sku-1234"},{"uuid":"06dc8c5b-9e2f-4423-b9dd-31a3aaa0a048","title":"Trust Cuby Pro","code":"sku-1235"},{"uuid":"0c3635f9-fedc-4bbd-96ab-856f69746b56","title":"Trust Urban Revolt","code":"sku-1236"},{"uuid":"0e957ed4-fa44-48de-b6c7-7149d890fb3a","title":"Microsoft LifeCam Studio","code":"sku-1237"}]}}}]},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The app does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list catalogs."}},"404":{"description":"Catalog not found","x-details":"The catalog id given in the URI does not exist","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Catalog \"65f5a521-e65c-4d7b-8be8-1f267fa2729c\" does not exist or you can't access it."}}}}},"/api/rest/v1/catalogs/{id}/mapped-models":{"get":{"summary":"Get the list of mapped models related to a catalog","operationId":"get_app_catalog_mapped_models","tags":["Catalog products"],"x-versions":["SaaS"],"description":"This endpoint allows you to get the list of models related to a catalog when the mapping is enabled with a models/variants schema. Please, note that a disabled catalog can return an HTTP 200 with a payload containing an error message, for more details see the App Catalog section.","parameters":[{"name":"id","in":"path","description":"Catalog ID","required":true,"type":"string","format":"uuid"},{"name":"search_after","in":"query","description":"Cursor when using the `search_after` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"string","default":"cursor to the first page"},{"name":"limit","in":"query","description":"Number of results by page, see Pagination section","required":false,"type":"integer","minimum":1,"maximum":100,"default":100},{"name":"updated_before","in":"query","description":"Filter products that have been updated BEFORE the provided date (Only available on Catalogs endpoints). This filter uses the PIM products updated date.","type":"string","format":"date","required":false,"x-from-version":"SaaS"},{"name":"updated_after","in":"query","description":"Filter products that have been updated AFTER the provided date (Only available on Catalogs endpoints). This filter uses the PIM products updated date.","type":"string","format":"date","required":false,"x-from-version":"SaaS"}],"responses":{"200":{"description":"Return the paginated **mapped** models","schema":{"title":"Products","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"string","format":"uuid"}}}}}}]},"x-examples-per-version":[{"x-version":"SaaS","x-example":{"_links":{"first":{"href":"https://demo.akeneo.com/api/rest/v1/catalogs/232be0b2-093c-4591-a506-2a2ed5176721/mapped-models?limit=3"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/catalogs/232be0b2-093c-4591-a506-2a2ed5176721/mapped-models?search_after=apollon&limit=3"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/catalogs/232be0b2-093c-4591-a506-2a2ed5176721/mapped-models?limit=3"}},"_embedded":{"items":[{"code":"tshirt_akeneo","title":"Beautiful t-shirt with Akeneo logo","variants":"https://demo.akeneo.com/api/rest/v1/catalogs/232be0b2-093c-4591-a506-2a2ed5176721/mapped-models/tshirt_akeneo/variants","variation_axes":[{"code":"color","label":[{"locale":"en_US","value":"Color"},{"locale":"fr_FR","value":"Couleur"}]},{"code":"size","label":[{"locale":"en_US","value":"Size"},{"locale":"fr_FR","value":"Taille"}]}]},{"code":"tshirt_pim","title":"Beautiful t-shirt with PIM logo","variants":"https://demo.akeneo.com/api/rest/v1/catalogs/232be0b2-093c-4591-a506-2a2ed5176721/mapped-models/tshirt_pim/variants","variation_axes":[{"code":"color","label":[{"locale":"en_US","value":"Color"},{"locale":"fr_FR","value":"Couleur"}]},{"code":"size","label":[{"locale":"en_US","value":"Size"},{"locale":"fr_FR","value":"Taille"}]}]}]}}}]},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The app does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list catalogs."}},"404":{"description":"Catalog not found","x-details":"The catalog id given in the URI does not exist","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Catalog \"65f5a521-e65c-4d7b-8be8-1f267fa2729c\" does not exist or you can't access it."}}}}},"/api/rest/v1/catalogs/{id}/mapped-models/{model_code}/variants":{"get":{"summary":"Get the list of mapped variants of a model related to a catalog","operationId":"get_app_catalog_mapped_variants","tags":["Catalog products"],"x-versions":["SaaS"],"description":"This endpoint allows you to get the list of variants of a model related to a catalog when the mapping is enabled. Please, note that a disabled catalog can return an HTTP 200 with a payload containing an error message, for more details see the App Catalog section.","parameters":[{"name":"id","in":"path","description":"Catalog ID","required":true,"type":"string","format":"uuid"},{"name":"search_after","in":"query","description":"Cursor when using the `search_after` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"string","default":"cursor to the first page"},{"name":"limit","in":"query","description":"Number of results by page, see Pagination section","required":false,"type":"integer","minimum":1,"maximum":100,"default":100},{"name":"model_code","in":"path","description":"Model code","required":true,"type":"string"},{"name":"updated_before","in":"query","description":"Filter products that have been updated BEFORE the provided date (Only available on Catalogs endpoints). This filter uses the PIM products updated date.","type":"string","format":"date","required":false,"x-from-version":"SaaS"},{"name":"updated_after","in":"query","description":"Filter products that have been updated AFTER the provided date (Only available on Catalogs endpoints). This filter uses the PIM products updated date.","type":"string","format":"date","required":false,"x-from-version":"SaaS"}],"responses":{"200":{"description":"Return the paginated **mapped** variants","schema":{"title":"Products","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"string","format":"uuid"}}}}}}]},"x-examples-per-version":[{"x-version":"SaaS","x-example":{"_links":{"first":{"href":"https://demo.akeneo.com/api/rest/v1/catalogs/232be0b2-093c-4591-a506-2a2ed5176721/mapped-models/tshirt_akeneo/variants?limit=100"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/catalogs/232be0b2-093c-4591-a506-2a2ed5176721/mapped-models/tshirt_akeneo/variants?limit=100"}},"_embedded":{"items":[{"is_published":true,"sku":"AK10BLXL","uuid":"6b025a71-537f-48d4-aa26-a6617d6199e9","variant_axes_values":[{"code":"color","label":[{"locale":"en_US","value":"Blue"},{"locale":"fr_FR","value":"Bleu"}],"value":"blue"},{"code":"size","label":[{"locale":"en_US","value":"XL"},{"locale":"fr_FR","value":"XL"}],"value":"xl"}]},{"is_published":true,"sku":"AK10YEXL","uuid":"6b025a71-537f-48d4-aa26-a6617d6199e9","variant_axes_values":[{"code":"color","label":[{"locale":"en_US","value":"Yellow"},{"locale":"fr_FR","value":"Jaune"}],"value":"yellow"},{"code":"size","label":[{"locale":"en_US","value":"XL"},{"locale":"fr_FR","value":"XL"}],"value":"xl"}]}]}}}]},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The app does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list catalogs."}},"404":{"description":"Catalog not found","x-details":"The catalog id given in the URI does not exist","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Catalog \"65f5a521-e65c-4d7b-8be8-1f267fa2729c\" does not exist or you can't access it."}}}}},"/api/rest/v1":{"get":{"summary":"Get list of all endpoints","operationId":"get_endpoints","description":"This endpoint allows you to get the list of all the available endpoints. No need to be authenticated to use this endpoint.","tags":["Overview"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"x-no-token":true,"responses":{"200":{"description":"Return the list of all available endpoints","x-no-entity":true,"schema":{"type":"object","properties":{"host":{"type":"string","description":"Host name"},"authentication":{"type":"object","description":"Endpoint to get the authentication token"},"routes":{"type":"object","description":"All the availables endpoints"}}},"examples":{"host":"https://demo.akeneo.com","authentication":{"fos_oauth_server_token":{"route":"/api/oauth/v1/token","methods":["POST"]}},"routes":{"pim_api_category_list":{"route":"/api/rest/v1/categories","methods":["GET"]},"pim_api_category_get":{"route":"/api/rest/v1/categories/{code}","methods":["GET"]},"pim_api_category_create":{"route":"/api/rest/v1/categories","methods":["POST"]},"pim_api_category_partial_update":{"route":"/api/rest/v1/categories/{code}","methods":["PATCH"]}}}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}}},"/api/oauth/v1/token":{"post":{"summary":"Get authentication token","operationId":"post_token","description":"This endpoint allows you to get an authentication token. No need to be authenticated to use this endpoint.","tags":["Authentication"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"x-no-token":true,"parameters":[{"name":"Content-type","in":"header","type":"string","description":"Equal to 'application/json' or 'application/x-www-form-urlencoded', no other value allowed","required":true},{"name":"Authorization","in":"header","type":"string","required":true,"description":"Equal to 'Basic xx', where 'xx' is the base 64 encoding of the client id and secret. Find out how to generate them in the Client ID/secret generation section."},{"name":"body","in":"body","x-form-data":true,"schema":{"type":"object","required":["username","password","grant_type"],"properties":{"username":{"type":"string","description":"Your PIM username"},"password":{"type":"string","description":"Your PIM password"},"grant_type":{"type":"string","description":"Always equal to \"password\""}},"example":{"username":"admin","password":"admin","grant_type":"password"}}}],"responses":{"200":{"description":"Return an authentication token","x-no-entity":true,"schema":{"type":"object","properties":{"access_token":{"type":"string","description":"Authentication token that should be given in every authenticated request to the API"},"expires_in":{"type":"integer","description":"Validity of the token given in seconds, 3600s = 1h by default"},"token_type":{"type":"string","description":"Token type, always equal to \"bearer\""},"scope":{"type":"string","description":"Unused, always equal to \"null\""},"refresh_token":{"type":"string","description":"Use this token when your access token has expired. See Refresh an expired token section for more details."}}},"examples":{"access_token":"ZTZmYjU4ZmQxZWNmMzk1M2NlYzA5NmFhNmIzVjExMzE4NmJmODBkZGIyYTliYmQyNjk2ZDQwZThmNjdiZDQzOQ","expires_in":3600,"token_type":"bearer","scope":null,"refresh_token":"M2FlODI0OTE3ODMyNjViMzRiOWE5ODMyNWViMThkNDU5YzJjNjFiZjNkZWFjMzIyYjc4YTgzZWY1MjE5ZTY5Mw"}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/system-information":{"get":{"summary":"Get system information","operationId":"get_system_information","description":"This endpoint allows you to get the version and the edition of the PIM. Example of what you can get
Environment Edition Version
SaaS EE Serenity v20230112013744
SaaS CE GE v20210526040645
PaaS or onPrem EE EE 6.0.28
PaaS or onPrem CE CE 6.0.28
","tags":["System"],"x-versions":["6.0","7.0","SaaS"],"x-no-token":true,"responses":{"200":{"description":"Return the version and the edition of the PIM.","x-no-entity":true,"schema":{"type":"object","properties":{"version":{"type":"string","description":"Version of the PIM"},"edition":{"type":"string","description":"Edition of the PIM"}}},"examples":{"version":"20210521041041","edition":"Serenity"}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}}}},"definitions":{"Product":{"type":"object","required":["identifier"],"properties":{"uuid":{"type":"string","description":"Product UUID","x-from-version":"7.0"},"identifier":{"type":"string","description":"Product identifier, i.e. the value of the only `pim_catalog_identifier` attribute"},"enabled":{"type":"boolean","description":"Whether the product is enabled","default":true},"family":{"type":"string","description":"Family code from which the product inherits its attributes and attributes requirements.","x-validation-rules":"It is equal to an existing family code. In the case of variant product, the given family should be the same as the product model family.","default":"null only in the case of a non variant product"},"categories":{"type":"array","description":"Codes of the categories in which the product is classified","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"groups":{"type":"array","description":"Codes of the groups to which the product belong","x-validation-rules":"Each string of the array is equal to an existing group code","items":{"type":"string"},"default":[]},"parent":{"type":"string","description":"Code of the parent product model when the product is a variant (only available since the 2.0). This parent can be modified since the 2.3.","x-validation-rules":"It is equal to an existing product model code only if the product is variant otherwise it's equal to null","default":"null","x-from-version":"2.0"},"values":{"type":"object","description":"Product attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value. See the `data` format section for more details."},"linked_data":{"type":"object","x-read-only":true,"description":"Object containing additional data when a related query parameter is enabled. See the `linked_data` format section for more details. (only available since the 5.0)","x-from-version":"5.0","properties":{"attribute":{"type":"string"},"code":{"type":"string"},"labels":{"type":"object"}}},"attribute_type":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"The type of the value's attribute. See type section for more details."},"reference_data_name":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"Reference entity code when the attribute type is `akeneo_reference_entity` or `akeneo_reference_entity_collection` OR Asset family code when the attribute type is `pim_catalog_asset_collection`","x-warning":"Only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types"}}}}}},"associations":{"type":"object","description":"Several associations related to groups, product models and/or other products, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the identifier of an existing product. • Each string in the array of the property `product_models` is the code of an existing product model.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of product identifiers with which the product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Several quantified associations related to products and/or product models, grouped by quantified association types (only available since the 5.0)","x-validation-rules":"• The `quantifiedAssociationTypeCode` is the code of an existing association type which provides quantity information. • Each object in the array of the property `products` contains the identifier of an existing product and the quantity of it.","x-from-version":"5.0","properties":{"quantifiedAssociationTypeCode":{"type":"object","properties":{"products":{"type":"array","description":"Array of objects containing product identifiers and quantities with which the product is in relation","items":{"type":"object","properties":{"identifier":{"type":"string"},"quantity":{"type":"integer"}}}},"product_models":{"type":"array","description":"Array of objects containing product model codes and quantities with which the product is in relation","items":{"type":"object","properties":{"code":{"type":"string"},"quantity":{"type":"integer"}}}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"metadata":{"type":"object","description":"More information around the product (only available since the v2.0 in the Enterprise Edition)","x-immutable":true,"x-read-only":true,"x-from-version":"2.0","properties":{"workflow_status":{"description":"Status of the product regarding the user permissions","type":"string","enum":["read_only","draft_in_progress","proposal_waiting_for_approval","working_copy"]}}},"quality_scores":{"type":"object","description":"Product quality scores for each channel/locale combination (only available since the 5.0 and when the \"with_quality_scores\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"5.0"},"completenesses":{"type":"array","description":"Product completenesses for each channel/locale combination (only available since the 7.0 version, and when the \"with_completenesses\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"7.0","items":{"type":"object","properties":{"scope":{"type":"string"},"locale":{"type":"string"},"data":{"type":"integer"}}}}},"example":{"identifier":"top","enabled":true,"family":"tshirt","categories":["summer_collection"],"groups":[],"parent":null,"values":{"name":[{"data":"Top","locale":"en_US","scope":null,"attribute_type":"pim_catalog_text"},{"data":"Débardeur","locale":"fr_FR","scope":null,"attribute_type":"pim_catalog_text"}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce","attribute_type":"pim_catalog_textarea"},{"data":"Top","locale":"en_US","scope":"tablet","attribute_type":"pim_catalog_textarea"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce","attribute_type":"pim_catalog_textarea"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet","attribute_type":"pim_catalog_textarea"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}],"attribute_type":"pim_catalog_price_collection"}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}},"attribute_type":"pim_catalog_simpleselect"}],"size":[{"locale":null,"scope":null,"data":"m","linked_data":{"attribute":"size","code":"m","labels":{"en_US":"M","fr_FR":"M"}},"attribute_type":"pim_catalog_simpleselect"}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"],"linked_data":{"winter_2016":{"attribute":"collection","code":"winter_2016","labels":{"en_US":"Winter 2016","fr_FR":"Hiver 2016"}}},"attribute_type":"pim_catalog_multiselect"}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglass"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"cap","quantity":2},{"identifier":"shoes","quantity":1}],"product_models":[{"identifier":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"completenesses":[{"scope":"ecommerce","locale":"en_US","data":10},{"scope":"ecommerce","locale":"fr_FR","data":20},{"scope":"tablet","locale":"en_US","data":30},{"scope":"tablet","locale":"fr_FR","data":40}]}},"ProductExamples":{"x-1.7":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=3&limit=3"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=1&limit=3"},"previous":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=2&limit=3"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=4&limit=3"}},"current_page":3,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/top"}},"identifier":"top","family":"tshirt","groups":[],"categories":["summer_collection"],"enabled":true,"values":{"name":[{"data":"Top","locale":"en_US","scope":null},{"data":"Débardeur","locale":"fr_FR","scope":null}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce"},{"data":"Top","locale":"en_US","scope":"tablet"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black"}],"size":[{"locale":null,"scope":null,"data":"m"}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"]}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglasses"],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"cap","quantity":2},{"identifier":"shoes","quantity":1}]}}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/cap"}},"identifier":"cap","family":"caps","groups":[],"categories":["summer_collection"],"enabled":true,"values":{"name":[{"data":"Cap","locale":"en_US","scope":null},{"data":"Casquette","locale":"fr_FR","scope":null}],"description":[{"data":"Cap unisex","locale":"en_US","scope":"ecommerce"},{"data":"Cap unisex","locale":"en_US","scope":"tablet"},{"data":"Casquette unisexe","locale":"fr_FR","scope":"ecommerce"},{"data":"Casquette unisexe","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"20","currency":"EUR"},{"amount":"20","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black"}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglasses"],"groups":[]}},"quantified_associations":{}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/sweat"}},"identifier":"sweat","family":null,"groups":[],"categories":["winter_collection"],"enabled":true,"values":{},"created":"2016-06-23T11:24:44+02:00","updated":"2016-06-23T11:24:44+02:00","associations":{},"quantified_associations":{}}]}},"x-2.0":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=3&limit=3"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=1&limit=3"},"previous":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=2&limit=3"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=4&limit=3"}},"current_page":3,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/top"}},"identifier":"top","family":"tshirt","groups":[],"parent":null,"categories":["summer_collection"],"enabled":true,"values":{"name":[{"data":"Top","locale":"en_US","scope":null},{"data":"Débardeur","locale":"fr_FR","scope":null}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce"},{"data":"Top","locale":"en_US","scope":"tablet"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black"}],"size":[{"locale":null,"scope":null,"data":"m"}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"]}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglasses"],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"cap","quantity":2},{"identifier":"shoes","quantity":1}]}}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/cap"}},"identifier":"cap","family":"caps","groups":[],"parent":null,"categories":["summer_collection"],"enabled":true,"values":{"name":[{"data":"Cap","locale":"en_US","scope":null},{"data":"Casquette","locale":"fr_FR","scope":null}],"description":[{"data":"Cap unisex","locale":"en_US","scope":"ecommerce"},{"data":"Cap unisex","locale":"en_US","scope":"tablet"},{"data":"Casquette unisexe","locale":"fr_FR","scope":"ecommerce"},{"data":"Casquette unisexe","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"20","currency":"EUR"},{"amount":"20","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black"}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglasses"],"groups":[]}},"quantified_associations":{}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/sweat"}},"identifier":"sweat","family":null,"groups":[],"parent":null,"categories":["winter_collection"],"enabled":true,"values":{},"created":"2016-06-23T11:24:44+02:00","updated":"2016-06-23T11:24:44+02:00","associations":{},"quantified_associations":{}}]}},"x-2.1":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=3&limit=3"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=1&limit=3"},"previous":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=2&limit=3"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=4&limit=3"}},"current_page":3,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/top"}},"identifier":"top","family":"tshirt","groups":[],"parent":null,"categories":["summer_collection"],"enabled":true,"values":{"name":[{"data":"Top","locale":"en_US","scope":null},{"data":"Débardeur","locale":"fr_FR","scope":null}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce"},{"data":"Top","locale":"en_US","scope":"tablet"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black"}],"size":[{"locale":null,"scope":null,"data":"m"}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"]}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglasses"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"cap","quantity":2},{"identifier":"shoes","quantity":1}],"product_models":[{"identifier":"model-biker-jacket-leather","quantity":2}]}}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/cap"}},"identifier":"cap","family":"caps","groups":[],"parent":null,"categories":["summer_collection"],"enabled":true,"values":{"name":[{"data":"Cap","locale":"en_US","scope":null},{"data":"Casquette","locale":"fr_FR","scope":null}],"description":[{"data":"Cap unisex","locale":"en_US","scope":"ecommerce"},{"data":"Cap unisex","locale":"en_US","scope":"tablet"},{"data":"Casquette unisexe","locale":"fr_FR","scope":"ecommerce"},{"data":"Casquette unisexe","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"20","currency":"EUR"},{"amount":"20","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black"}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglasses"],"product_models":[],"groups":[]}},"quantified_associations":{}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/sweat"}},"identifier":"sweat","family":null,"groups":[],"parent":null,"categories":["winter_collection"],"enabled":true,"values":{},"created":"2016-06-23T11:24:44+02:00","updated":"2016-06-23T11:24:44+02:00","associations":{},"quantified_associations":{}}]}},"x-5.0":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=3&limit=3&with_quality_scores=true&with_attribute_options=true"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=1&limit=3&with_quality_scores=true&with_attribute_options=true"},"previous":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=2&limit=3&with_quality_scores=true&with_attribute_options=true"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=4&limit=3&with_quality_scores=true&with_attribute_options=true"}},"current_page":3,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/top"}},"identifier":"top","family":"tshirt","groups":[],"parent":null,"categories":["summer_collection"],"enabled":true,"values":{"name":[{"data":"Top","locale":"en_US","scope":null},{"data":"Débardeur","locale":"fr_FR","scope":null}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce"},{"data":"Top","locale":"en_US","scope":"tablet"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}}}],"size":[{"locale":null,"scope":null,"data":"m","linked_data":{"attribute":"size","code":"m","labels":{"en_US":"M","fr_FR":"M"}}}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"],"linked_data":{"winter_2016":{"attribute":"collection","code":"winter_2016","labels":{"en_US":"Winter 2016","fr_FR":"Hiver 2016"}}}}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglasses"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"cap","quantity":2},{"identifier":"shoes","quantity":1}],"product_models":[{"identifier":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}]},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/cap"}},"identifier":"cap","family":"caps","groups":[],"parent":null,"categories":["summer_collection"],"enabled":true,"values":{"name":[{"data":"Cap","locale":"en_US","scope":null},{"data":"Casquette","locale":"fr_FR","scope":null}],"description":[{"data":"Cap unisex","locale":"en_US","scope":"ecommerce"},{"data":"Cap unisex","locale":"en_US","scope":"tablet"},{"data":"Casquette unisexe","locale":"fr_FR","scope":"ecommerce"},{"data":"Casquette unisexe","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"20","currency":"EUR"},{"amount":"20","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}}}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglasses"],"product_models":[],"groups":[]}},"quantified_associations":{},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}]},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/sweat"}},"identifier":"sweat","family":null,"groups":[],"parent":null,"categories":["winter_collection"],"enabled":true,"values":{},"created":"2016-06-23T11:24:44+02:00","updated":"2016-06-23T11:24:44+02:00","associations":{},"quantified_associations":{},"quality_scores":{}}]}},"x-SaaS":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=3&limit=3&with_quality_scores=true&with_completenesses=true&with_attribute_options=true"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=1&limit=3&with_quality_scores=true&with_completenesses=true&with_attribute_options=true"},"previous":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=2&limit=3&with_quality_scores=true&with_completenesses=true&with_attribute_options=true"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=4&limit=3&with_quality_scores=true&with_completenesses=true&with_attribute_options=true"}},"current_page":3,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/top"}},"uuid":"aaf518b2-f91e-40f1-a53a-78ce5e81a6f9","identifier":"top","family":"tshirt","groups":[],"parent":null,"categories":["summer_collection"],"enabled":true,"values":{"name":[{"data":"Top","locale":"en_US","scope":null,"attribute_type":"pim_catalog_text"},{"data":"Débardeur","locale":"fr_FR","scope":null,"attribute_type":"pim_catalog_text"}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce","attribute_type":"pim_catalog_textarea"},{"data":"Top","locale":"en_US","scope":"tablet","attribute_type":"pim_catalog_textarea"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce","attribute_type":"pim_catalog_textarea"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet","attribute_type":"pim_catalog_textarea"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}],"attribute_type":"pim_catalog_price_collection"}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}},"attribute_type":"pim_catalog_simpleselect"}],"size":[{"locale":null,"scope":null,"data":"m","linked_data":{"attribute":"size","code":"m","labels":{"en_US":"M","fr_FR":"M"}},"attribute_type":"pim_catalog_simpleselect"}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"],"linked_data":{"winter_2016":{"attribute":"collection","code":"winter_2016","labels":{"en_US":"Winter 2016","fr_FR":"Hiver 2016"}}},"attribute_type":"pim_catalog_multiselect"}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglasses"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"cap","quantity":2},{"identifier":"shoes","quantity":1}],"product_models":[{"identifier":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"completenesses":[{"scope":"ecommerce","locale":"en_US","data":20},{"scope":"ecommerce","locale":"fr_FR","data":30},{"scope":"tablet","locale":"en_US","data":55},{"scope":"tablet","locale":"fr_FR","data":70}]},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/cap"}},"uuid":"aec6780b-c813-4bd7-8e24-1a8574471576","identifier":"cap","family":"caps","groups":[],"parent":null,"categories":["summer_collection"],"enabled":true,"values":{"name":[{"data":"Cap","locale":"en_US","scope":null},{"data":"Casquette","locale":"fr_FR","scope":null}],"description":[{"data":"Cap unisex","locale":"en_US","scope":"ecommerce"},{"data":"Cap unisex","locale":"en_US","scope":"tablet"},{"data":"Casquette unisexe","locale":"fr_FR","scope":"ecommerce"},{"data":"Casquette unisexe","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"20","currency":"EUR"},{"amount":"20","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}}}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglasses"],"product_models":[],"groups":[]}},"quantified_associations":{},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"completenesses":[{"scope":"ecommerce","locale":"en_US","data":20},{"scope":"ecommerce","locale":"fr_FR","data":30},{"scope":"tablet","locale":"en_US","data":55},{"scope":"tablet","locale":"fr_FR","data":70}]},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/sweat"}},"uuid":"93f14b03-5ed3-4f23-87c6-ae3806041b6a","identifier":"sweat","family":null,"groups":[],"parent":null,"categories":["winter_collection"],"enabled":true,"values":{},"created":"2016-06-23T11:24:44+02:00","updated":"2016-06-23T11:24:44+02:00","associations":{},"quantified_associations":{},"quality_scores":{},"completenesses":[]}]}}},"ProductList":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["identifier"],"properties":{"uuid":{"type":"string","description":"Product UUID","x-from-version":"7.0"},"identifier":{"type":"string","description":"Product identifier, i.e. the value of the only `pim_catalog_identifier` attribute"},"enabled":{"type":"boolean","description":"Whether the product is enabled","default":true},"family":{"type":"string","description":"Family code from which the product inherits its attributes and attributes requirements.","x-validation-rules":"It is equal to an existing family code. In the case of variant product, the given family should be the same as the product model family.","default":"null only in the case of a non variant product"},"categories":{"type":"array","description":"Codes of the categories in which the product is classified","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"groups":{"type":"array","description":"Codes of the groups to which the product belong","x-validation-rules":"Each string of the array is equal to an existing group code","items":{"type":"string"},"default":[]},"parent":{"type":"string","description":"Code of the parent product model when the product is a variant (only available since the 2.0). This parent can be modified since the 2.3.","x-validation-rules":"It is equal to an existing product model code only if the product is variant otherwise it's equal to null","default":"null","x-from-version":"2.0"},"values":{"type":"object","description":"Product attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value. See the `data` format section for more details."},"linked_data":{"type":"object","x-read-only":true,"description":"Object containing additional data when a related query parameter is enabled. See the `linked_data` format section for more details. (only available since the 5.0)","x-from-version":"5.0","properties":{"attribute":{"type":"string"},"code":{"type":"string"},"labels":{"type":"object"}}},"attribute_type":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"The type of the value's attribute. See type section for more details."},"reference_data_name":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"Reference entity code when the attribute type is `akeneo_reference_entity` or `akeneo_reference_entity_collection` OR Asset family code when the attribute type is `pim_catalog_asset_collection`","x-warning":"Only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types"}}}}}},"associations":{"type":"object","description":"Several associations related to groups, product models and/or other products, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the identifier of an existing product. • Each string in the array of the property `product_models` is the code of an existing product model.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of product identifiers with which the product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Several quantified associations related to products and/or product models, grouped by quantified association types (only available since the 5.0)","x-validation-rules":"• The `quantifiedAssociationTypeCode` is the code of an existing association type which provides quantity information. • Each object in the array of the property `products` contains the identifier of an existing product and the quantity of it.","x-from-version":"5.0","properties":{"quantifiedAssociationTypeCode":{"type":"object","properties":{"products":{"type":"array","description":"Array of objects containing product identifiers and quantities with which the product is in relation","items":{"type":"object","properties":{"identifier":{"type":"string"},"quantity":{"type":"integer"}}}},"product_models":{"type":"array","description":"Array of objects containing product model codes and quantities with which the product is in relation","items":{"type":"object","properties":{"code":{"type":"string"},"quantity":{"type":"integer"}}}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"metadata":{"type":"object","description":"More information around the product (only available since the v2.0 in the Enterprise Edition)","x-immutable":true,"x-read-only":true,"x-from-version":"2.0","properties":{"workflow_status":{"description":"Status of the product regarding the user permissions","type":"string","enum":["read_only","draft_in_progress","proposal_waiting_for_approval","working_copy"]}}},"quality_scores":{"type":"object","description":"Product quality scores for each channel/locale combination (only available since the 5.0 and when the \"with_quality_scores\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"5.0"},"completenesses":{"type":"array","description":"Product completenesses for each channel/locale combination (only available since the 7.0 version, and when the \"with_completenesses\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"7.0","items":{"type":"object","properties":{"scope":{"type":"string"},"locale":{"type":"string"},"data":{"type":"integer"}}}}},"example":{"identifier":"top","enabled":true,"family":"tshirt","categories":["summer_collection"],"groups":[],"parent":null,"values":{"name":[{"data":"Top","locale":"en_US","scope":null,"attribute_type":"pim_catalog_text"},{"data":"Débardeur","locale":"fr_FR","scope":null,"attribute_type":"pim_catalog_text"}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce","attribute_type":"pim_catalog_textarea"},{"data":"Top","locale":"en_US","scope":"tablet","attribute_type":"pim_catalog_textarea"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce","attribute_type":"pim_catalog_textarea"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet","attribute_type":"pim_catalog_textarea"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}],"attribute_type":"pim_catalog_price_collection"}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}},"attribute_type":"pim_catalog_simpleselect"}],"size":[{"locale":null,"scope":null,"data":"m","linked_data":{"attribute":"size","code":"m","labels":{"en_US":"M","fr_FR":"M"}},"attribute_type":"pim_catalog_simpleselect"}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"],"linked_data":{"winter_2016":{"attribute":"collection","code":"winter_2016","labels":{"en_US":"Winter 2016","fr_FR":"Hiver 2016"}}},"attribute_type":"pim_catalog_multiselect"}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglass"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"cap","quantity":2},{"identifier":"shoes","quantity":1}],"product_models":[{"identifier":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"completenesses":[{"scope":"ecommerce","locale":"en_US","data":10},{"scope":"ecommerce","locale":"fr_FR","data":20},{"scope":"tablet","locale":"en_US","data":30},{"scope":"tablet","locale":"fr_FR","data":40}]}}]},"ProductUuid":{"type":"object","properties":{"uuid":{"type":"string","description":"Product uuid"},"enabled":{"type":"boolean","description":"Whether the product is enabled","default":true},"family":{"type":"string","description":"Family code from which the product inherits its attributes and attributes requirements.","x-validation-rules":"It is equal to an existing family code. In the case of variant product, the given family should be the same as the product model family.","default":"null only in the case of a non variant product"},"categories":{"type":"array","description":"Codes of the categories in which the product is classified","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"groups":{"type":"array","description":"Codes of the groups to which the product belong","x-validation-rules":"Each string of the array is equal to an existing group code","items":{"type":"string"},"default":[]},"parent":{"type":"string","description":"Code of the parent product model when the product is a variant (only available since the 2.0). This parent can be modified since the 2.3.","x-validation-rules":"It is equal to an existing product model code only if the product is variant otherwise it's equal to null","default":"null","x-from-version":"2.0"},"values":{"type":"object","description":"Product attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value. See the `data` format section for more details."},"linked_data":{"type":"object","x-read-only":true,"description":"Object containing additional data when a related query parameter is enabled. See the `linked_data` format section for more details. (only available since the 5.0)","x-from-version":"5.0","properties":{"attribute":{"type":"string"},"code":{"type":"string"},"labels":{"type":"object"}}},"attribute_type":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"The type of the value's attribute. See type section for more details."},"reference_data_name":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"Reference entity code when the attribute type is `akeneo_reference_entity` or `akeneo_reference_entity_collection` OR Asset family code when the attribute type is `pim_catalog_asset_collection`","x-warning":"Only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types"}}}}}},"associations":{"type":"object","description":"Several associations related to groups, product models and/or other products, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the uuid of an existing product. • Each string in the array of the property `product_models` is the code of an existing product model.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of product uuids with which the product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Several quantified associations related to products and/or product models, grouped by quantified association types (only available since the 5.0)","x-validation-rules":"• The `quantifiedAssociationTypeCode` is the code of an existing association type which provides quantity information. • Each object in the array of the property `products` contains the uuid of an existing product and the quantity of it.","x-from-version":"5.0","properties":{"quantifiedAssociationTypeCode":{"type":"object","properties":{"products":{"type":"array","description":"Array of objects containing product uuids and quantities with which the product is in relation","items":{"type":"object","properties":{"uuid":{"type":"string"},"quantity":{"type":"integer"}}}},"product_models":{"type":"array","description":"Array of objects containing product model codes and quantities with which the product is in relation","items":{"type":"object","properties":{"code":{"type":"string"},"quantity":{"type":"integer"}}}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"metadata":{"type":"object","description":"More information around the product (only available since the v2.0 in the Enterprise Edition)","x-immutable":true,"x-read-only":true,"x-from-version":"2.0","properties":{"workflow_status":{"description":"Status of the product regarding the user permissions","type":"string","enum":["read_only","draft_in_progress","proposal_waiting_for_approval","working_copy"]}}},"quality_scores":{"type":"object","description":"Product quality scores for each channel/locale combination (only available since the 5.0 and when the \"with_quality_scores\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"5.0"},"completenesses":{"type":"array","description":"Product completenesses for each channel/locale combination (only available since the 7.0 version, and when the \"with_completenesses\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"7.0","items":{"type":"object","properties":{"scope":{"type":"string"},"locale":{"type":"string"},"data":{"type":"integer"}}}}},"example":{"uuid":"25566245-55c3-42ce-86d9-8610ac459fa8","enabled":true,"family":"tshirt","categories":["summer_collection"],"groups":[],"parent":null,"values":{"sku":[{"data":"top","locale":null,"scope":null}],"name":[{"data":"Top","locale":"en_US","scope":null},{"data":"Débardeur","locale":"fr_FR","scope":null}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce"},{"data":"Top","locale":"en_US","scope":"tablet"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}}}],"size":[{"locale":null,"scope":null,"data":"m","linked_data":{"attribute":"size","code":"m","labels":{"en_US":"M","fr_FR":"M"}}}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"],"linked_data":{"winter_2016":{"attribute":"collection","code":"winter_2016","labels":{"en_US":"Winter 2016","fr_FR":"Hiver 2016"}}}}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["d055527c-0698-4967-8f16-8a5f23f4e5cf"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"uuid":"fc24e6c3-933c-4a93-8a81-e5c703d134d5","quantity":2},{"uuid":"a9b69002-a0b1-4ead-85c2-f8dbf59c6cfc","quantity":1}],"product_models":[{"identifier":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"completenesses":[{"scope":"ecommerce","locale":"en_US","data":10},{"scope":"ecommerce","locale":"fr_FR","data":20},{"scope":"tablet","locale":"en_US","data":30},{"scope":"tablet","locale":"fr_FR","data":40}]}},"ProductUuidExamples":{"x-SaaS":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/products-uuid?page=3&limit=3&with_quality_scores=true&with_completenesses=true&with_attribute_options=true"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/products-uuid?page=1&limit=3&with_quality_scores=true&with_completenesses=true&with_attribute_options=true"},"previous":{"href":"https://demo.akeneo.com/api/rest/v1/products-uuid?page=2&limit=3&with_quality_scores=true&with_completenesses=true&with_attribute_options=true"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/products-uuid?page=4&limit=3&with_quality_scores=true&with_completenesses=true&with_attribute_options=true"}},"current_page":3,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product-uuid/25566245-55c3-42ce-86d9-8610ac459fa8"}},"uuid":"25566245-55c3-42ce-86d9-8610ac459fa8","family":"tshirt","groups":[],"parent":null,"categories":["summer_collection"],"enabled":true,"values":{"sku":[{"data":"top","locale":null,"scope":null,"attribute_type":"pim_catalog_identifier"}],"name":[{"data":"Top","locale":"en_US","scope":null,"attribute_type":"pim_catalog_text"},{"data":"Débardeur","locale":"fr_FR","scope":null,"attribute_type":"pim_catalog_text"}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce","attribute_type":"pim_catalog_textarea"},{"data":"Top","locale":"en_US","scope":"tablet","attribute_type":"pim_catalog_textarea"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce","attribute_type":"pim_catalog_textarea"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet","attribute_type":"pim_catalog_textarea"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}],"attribute_type":"pim_catalog_price_collection"}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}},"attribute_type":"pim_catalog_simpleselect"}],"size":[{"locale":null,"scope":null,"data":"m","linked_data":{"attribute":"size","code":"m","labels":{"en_US":"M","fr_FR":"M"}},"attribute_type":"pim_catalog_simpleselect"}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"],"linked_data":{"winter_2016":{"attribute":"collection","code":"winter_2016","labels":{"en_US":"Winter 2016","fr_FR":"Hiver 2016"}}},"attribute_type":"pim_catalog_multiselect"}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["d055527c-0698-4967-8f16-8a5f23f4e5cf"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"uuid":"fc24e6c3-933c-4a93-8a81-e5c703d134d5","quantity":2},{"uuid":"a9b69002-a0b1-4ead-85c2-f8dbf59c6cfc","quantity":1}],"product_models":[{"identifier":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"completenesses":[{"scope":"ecommerce","locale":"en_US","data":20},{"scope":"ecommerce","locale":"fr_FR","data":30},{"scope":"tablet","locale":"en_US","data":55},{"scope":"tablet","locale":"fr_FR","data":70}]},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/fc24e6c3-933c-4a93-8a81-e5c703d134d5"}},"uuid":"fc24e6c3-933c-4a93-8a81-e5c703d134d5","family":"caps","groups":[],"parent":null,"categories":["summer_collection"],"enabled":true,"values":{"sku":[{"data":"cap","locale":null,"scope":null}],"name":[{"data":"Cap","locale":"en_US","scope":null},{"data":"Casquette","locale":"fr_FR","scope":null}],"description":[{"data":"Cap unisex","locale":"en_US","scope":"ecommerce"},{"data":"Cap unisex","locale":"en_US","scope":"tablet"},{"data":"Casquette unisexe","locale":"fr_FR","scope":"ecommerce"},{"data":"Casquette unisexe","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"20","currency":"EUR"},{"amount":"20","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}}}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["d055527c-0698-4967-8f16-8a5f23f4e5cf"],"product_models":[],"groups":[]}},"quantified_associations":{},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"completenesses":[{"scope":"ecommerce","locale":"en_US","data":20},{"scope":"ecommerce","locale":"fr_FR","data":30},{"scope":"tablet","locale":"en_US","data":55},{"scope":"tablet","locale":"fr_FR","data":70}]},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product-uuid/fa0b115e-46ec-4527-beab-7207452f1b47"}},"uuid":"fa0b115e-46ec-4527-beab-7207452f1b47","family":null,"groups":[],"parent":null,"categories":["winter_collection"],"enabled":true,"values":{"sku":[{"data":"sweat","locale":null,"scope":null}]},"created":"2016-06-23T11:24:44+02:00","updated":"2016-06-23T11:24:44+02:00","associations":{},"quantified_associations":{},"quality_scores":{},"completenesses":[]}]}}},"ProductUuidList":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","properties":{"uuid":{"type":"string","description":"Product uuid"},"enabled":{"type":"boolean","description":"Whether the product is enabled","default":true},"family":{"type":"string","description":"Family code from which the product inherits its attributes and attributes requirements.","x-validation-rules":"It is equal to an existing family code. In the case of variant product, the given family should be the same as the product model family.","default":"null only in the case of a non variant product"},"categories":{"type":"array","description":"Codes of the categories in which the product is classified","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"groups":{"type":"array","description":"Codes of the groups to which the product belong","x-validation-rules":"Each string of the array is equal to an existing group code","items":{"type":"string"},"default":[]},"parent":{"type":"string","description":"Code of the parent product model when the product is a variant (only available since the 2.0). This parent can be modified since the 2.3.","x-validation-rules":"It is equal to an existing product model code only if the product is variant otherwise it's equal to null","default":"null","x-from-version":"2.0"},"values":{"type":"object","description":"Product attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value. See the `data` format section for more details."},"linked_data":{"type":"object","x-read-only":true,"description":"Object containing additional data when a related query parameter is enabled. See the `linked_data` format section for more details. (only available since the 5.0)","x-from-version":"5.0","properties":{"attribute":{"type":"string"},"code":{"type":"string"},"labels":{"type":"object"}}},"attribute_type":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"The type of the value's attribute. See type section for more details."},"reference_data_name":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"Reference entity code when the attribute type is `akeneo_reference_entity` or `akeneo_reference_entity_collection` OR Asset family code when the attribute type is `pim_catalog_asset_collection`","x-warning":"Only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types"}}}}}},"associations":{"type":"object","description":"Several associations related to groups, product models and/or other products, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the uuid of an existing product. • Each string in the array of the property `product_models` is the code of an existing product model.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of product uuids with which the product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Several quantified associations related to products and/or product models, grouped by quantified association types (only available since the 5.0)","x-validation-rules":"• The `quantifiedAssociationTypeCode` is the code of an existing association type which provides quantity information. • Each object in the array of the property `products` contains the uuid of an existing product and the quantity of it.","x-from-version":"5.0","properties":{"quantifiedAssociationTypeCode":{"type":"object","properties":{"products":{"type":"array","description":"Array of objects containing product uuids and quantities with which the product is in relation","items":{"type":"object","properties":{"uuid":{"type":"string"},"quantity":{"type":"integer"}}}},"product_models":{"type":"array","description":"Array of objects containing product model codes and quantities with which the product is in relation","items":{"type":"object","properties":{"code":{"type":"string"},"quantity":{"type":"integer"}}}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"metadata":{"type":"object","description":"More information around the product (only available since the v2.0 in the Enterprise Edition)","x-immutable":true,"x-read-only":true,"x-from-version":"2.0","properties":{"workflow_status":{"description":"Status of the product regarding the user permissions","type":"string","enum":["read_only","draft_in_progress","proposal_waiting_for_approval","working_copy"]}}},"quality_scores":{"type":"object","description":"Product quality scores for each channel/locale combination (only available since the 5.0 and when the \"with_quality_scores\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"5.0"},"completenesses":{"type":"array","description":"Product completenesses for each channel/locale combination (only available since the 7.0 version, and when the \"with_completenesses\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"7.0","items":{"type":"object","properties":{"scope":{"type":"string"},"locale":{"type":"string"},"data":{"type":"integer"}}}}},"example":{"uuid":"25566245-55c3-42ce-86d9-8610ac459fa8","enabled":true,"family":"tshirt","categories":["summer_collection"],"groups":[],"parent":null,"values":{"sku":[{"data":"top","locale":null,"scope":null}],"name":[{"data":"Top","locale":"en_US","scope":null},{"data":"Débardeur","locale":"fr_FR","scope":null}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce"},{"data":"Top","locale":"en_US","scope":"tablet"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}}}],"size":[{"locale":null,"scope":null,"data":"m","linked_data":{"attribute":"size","code":"m","labels":{"en_US":"M","fr_FR":"M"}}}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"],"linked_data":{"winter_2016":{"attribute":"collection","code":"winter_2016","labels":{"en_US":"Winter 2016","fr_FR":"Hiver 2016"}}}}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["d055527c-0698-4967-8f16-8a5f23f4e5cf"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"uuid":"fc24e6c3-933c-4a93-8a81-e5c703d134d5","quantity":2},{"uuid":"a9b69002-a0b1-4ead-85c2-f8dbf59c6cfc","quantity":1}],"product_models":[{"identifier":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"completenesses":[{"scope":"ecommerce","locale":"en_US","data":10},{"scope":"ecommerce","locale":"fr_FR","data":20},{"scope":"tablet","locale":"en_US","data":30},{"scope":"tablet","locale":"fr_FR","data":40}]}}]},"ProductModel":{"type":"object","required":["code","family_variant"],"properties":{"code":{"type":"string","description":"Product model code","x-immutable":true},"family":{"type":"string","description":"Family code from which the product inherits its attributes and attributes requirements (since the 3.2)","x-validation-rules":"It is equal to an existing family code","x-immutable":true,"x-from-version":"3.2"},"family_variant":{"type":"string","description":"Family variant code from which the product model inherits its attributes and variant attributes","x-validation-rules":"It is equal to an existing family variant code that belong to the family given in the `family` field","x-immutable":true},"parent":{"type":"string","description":"Code of the parent product model. This parent can be modified since the 2.3.","x-validation-rules":"• It is equal to an existing product model code • This product model has the same family variant as the one given in the `family_variant field`","default":"null","x-from-version":"2.3"},"categories":{"type":"array","description":"Codes of the categories in which the product model is categorized","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"values":{"type":"object","description":"Product model attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value"},"linked_data":{"type":"object","x-read-only":true,"description":"Object containing additional data when a related query parameter is enabled. See the `linked_data` format section for more details. (only available since the 5.0)","x-from-version":"SaaS","properties":{"attribute":{"type":"string"},"code":{"type":"string"},"labels":{"type":"object"}}}}}}}},"associations":{"type":"object","description":"Several associations related to groups, product and/or other product models, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the identifier of an existing product. • Each string in the array of the property `product_models` is the code of an existing product model.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of product identifiers with which the product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Several quantified associations related to products and/or product models, grouped by quantified association types (only available since the 5.0)","x-validation-rules":"• The `quantifiedAssociationTypeCode` is the code of an existing association type which provides quantity information. • Each object in the array of the property `products` contains the identifier of an existing product and the quantity of it. • Each object in the array of the property `product_models` contains the code of an existing product model and the quantity of it.","x-from-version":"5.0","properties":{"quantifiedAssociationTypeCode":{"type":"object","properties":{"products":{"type":"array","description":"Array of objects containing product identifiers and quantities with which the product model is in relation","items":{"type":"object","properties":{"identifier":{"type":"string"},"quantity":{"type":"integer"}}}},"product_models":{"type":"array","description":"Array of objects containing product model codes and quantities with which the product model is in relation","items":{"type":"object","properties":{"code":{"type":"string"},"quantity":{"type":"integer"}}}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"metadata":{"type":"object","description":"More information around the product model (only available since the v2.3 in the Enterprise Edition)","x-immutable":true,"x-read-only":true,"x-from-version":"2.3","properties":{"workflow_status":{"description":"Status of the product model regarding the user permissions","type":"string","enum":["read_only","draft_in_progress","proposal_waiting_for_approval","working_copy"]}}},"quality_scores":{"type":"object","description":"Product model quality scores for each channel/locale combination (only available since the 7.0 version and when the \"with_quality_scores\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"7.0"}},"example":{"code":"model-biker-jacket-leather","family":"clothing","family_variant":"clothing_material_size","parent":"model-biker-jacket","categories":["summer_collection"],"values":{"color":[{"locale":null,"scope":null,"data":"antique_white"}],"material":[{"locale":null,"scope":null,"data":"leather"}],"variation_name":[{"locale":"en_US","scope":null,"data":"Biker jacket leather"}],"name":[{"locale":"en_US","scope":null,"data":"Biker jacket"}],"collection":[{"locale":null,"scope":null,"data":["summer_2017"]}],"description":[{"locale":"en_US","scope":"ecommerce","data":"Biker jacket"}]},"associations":{"PACK":{"products":["sunglass"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"top","quantity":2},{"identifier":"cap","quantity":1}],"product_models":[{"code":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"created":"2017-10-02T15:03:55+02:00","updated":"2017-10-02T15:03:55+02:00"}},"ProductModelList":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code","family_variant"],"properties":{"code":{"type":"string","description":"Product model code","x-immutable":true},"family":{"type":"string","description":"Family code from which the product inherits its attributes and attributes requirements (since the 3.2)","x-validation-rules":"It is equal to an existing family code","x-immutable":true,"x-from-version":"3.2"},"family_variant":{"type":"string","description":"Family variant code from which the product model inherits its attributes and variant attributes","x-validation-rules":"It is equal to an existing family variant code that belong to the family given in the `family` field","x-immutable":true},"parent":{"type":"string","description":"Code of the parent product model. This parent can be modified since the 2.3.","x-validation-rules":"• It is equal to an existing product model code • This product model has the same family variant as the one given in the `family_variant field`","default":"null","x-from-version":"2.3"},"categories":{"type":"array","description":"Codes of the categories in which the product model is categorized","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"values":{"type":"object","description":"Product model attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value"},"linked_data":{"type":"object","x-read-only":true,"description":"Object containing additional data when a related query parameter is enabled. See the `linked_data` format section for more details. (only available since the 5.0)","x-from-version":"SaaS","properties":{"attribute":{"type":"string"},"code":{"type":"string"},"labels":{"type":"object"}}}}}}}},"associations":{"type":"object","description":"Several associations related to groups, product and/or other product models, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the identifier of an existing product. • Each string in the array of the property `product_models` is the code of an existing product model.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of product identifiers with which the product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Several quantified associations related to products and/or product models, grouped by quantified association types (only available since the 5.0)","x-validation-rules":"• The `quantifiedAssociationTypeCode` is the code of an existing association type which provides quantity information. • Each object in the array of the property `products` contains the identifier of an existing product and the quantity of it. • Each object in the array of the property `product_models` contains the code of an existing product model and the quantity of it.","x-from-version":"5.0","properties":{"quantifiedAssociationTypeCode":{"type":"object","properties":{"products":{"type":"array","description":"Array of objects containing product identifiers and quantities with which the product model is in relation","items":{"type":"object","properties":{"identifier":{"type":"string"},"quantity":{"type":"integer"}}}},"product_models":{"type":"array","description":"Array of objects containing product model codes and quantities with which the product model is in relation","items":{"type":"object","properties":{"code":{"type":"string"},"quantity":{"type":"integer"}}}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"metadata":{"type":"object","description":"More information around the product model (only available since the v2.3 in the Enterprise Edition)","x-immutable":true,"x-read-only":true,"x-from-version":"2.3","properties":{"workflow_status":{"description":"Status of the product model regarding the user permissions","type":"string","enum":["read_only","draft_in_progress","proposal_waiting_for_approval","working_copy"]}}},"quality_scores":{"type":"object","description":"Product model quality scores for each channel/locale combination (only available since the 7.0 version and when the \"with_quality_scores\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"7.0"}},"example":{"code":"model-biker-jacket-leather","family":"clothing","family_variant":"clothing_material_size","parent":"model-biker-jacket","categories":["summer_collection"],"values":{"color":[{"locale":null,"scope":null,"data":"antique_white"}],"material":[{"locale":null,"scope":null,"data":"leather"}],"variation_name":[{"locale":"en_US","scope":null,"data":"Biker jacket leather"}],"name":[{"locale":"en_US","scope":null,"data":"Biker jacket"}],"collection":[{"locale":null,"scope":null,"data":["summer_2017"]}],"description":[{"locale":"en_US","scope":"ecommerce","data":"Biker jacket"}]},"associations":{"PACK":{"products":["sunglass"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"top","quantity":2},{"identifier":"cap","quantity":1}],"product_models":[{"code":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"created":"2017-10-02T15:03:55+02:00","updated":"2017-10-02T15:03:55+02:00"}}]},"PublishedProduct":{"type":"object","required":["identifier"],"properties":{"identifier":{"type":"string","description":"Published product identifier, i.e. the value of the only `pim_catalog_identifier` attribute"},"enabled":{"type":"boolean","description":"Whether the published product is enable","default":true},"family":{"type":"string","description":"Family code from which the published product inherits its attributes and attributes requirements","x-validation-rules":"It is equal to an existing family code","default":"null"},"categories":{"type":"array","description":"Codes of the categories in which the published product is classified","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"groups":{"type":"array","description":"Codes of the groups to which the published product belong","x-validation-rules":"Each string of the array is equal to an existing group code","items":{"type":"string"},"default":[]},"values":{"type":"object","description":"Published product attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value"}}}}}},"associations":{"type":"object","description":"Several associations related to groups and/or other published products, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the identifier of an existing product. • Identifiers used in the array of the property `products` cannot be equal to the published product identifier.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the published product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of published product identifiers with which the published product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Warning: associations with quantities are not compatible with the published products. The response will always be empty."},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true}},"example":{"identifier":"top","enabled":true,"family":"tshirt","categories":["summer_collection"],"groups":[],"values":{"name":[{"data":"Top","locale":"en_US","scope":null},{"data":"Débardeur","locale":"fr_FR","scope":null}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce"},{"data":"Top","locale":"en_US","scope":"tablet"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black"}],"size":[{"locale":null,"scope":null,"data":"m"}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglass"],"product_models":[],"groups":[]}}}},"PublishedProductList":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["identifier"],"properties":{"identifier":{"type":"string","description":"Published product identifier, i.e. the value of the only `pim_catalog_identifier` attribute"},"enabled":{"type":"boolean","description":"Whether the published product is enable","default":true},"family":{"type":"string","description":"Family code from which the published product inherits its attributes and attributes requirements","x-validation-rules":"It is equal to an existing family code","default":"null"},"categories":{"type":"array","description":"Codes of the categories in which the published product is classified","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"groups":{"type":"array","description":"Codes of the groups to which the published product belong","x-validation-rules":"Each string of the array is equal to an existing group code","items":{"type":"string"},"default":[]},"values":{"type":"object","description":"Published product attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value"}}}}}},"associations":{"type":"object","description":"Several associations related to groups and/or other published products, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the identifier of an existing product. • Identifiers used in the array of the property `products` cannot be equal to the published product identifier.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the published product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of published product identifiers with which the published product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Warning: associations with quantities are not compatible with the published products. The response will always be empty."},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true}},"example":{"identifier":"top","enabled":true,"family":"tshirt","categories":["summer_collection"],"groups":[],"values":{"name":[{"data":"Top","locale":"en_US","scope":null},{"data":"Débardeur","locale":"fr_FR","scope":null}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce"},{"data":"Top","locale":"en_US","scope":"tablet"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black"}],"size":[{"locale":null,"scope":null,"data":"m"}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglass"],"product_models":[],"groups":[]}}}}]},"ReferenceEntity":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","x-read-only":true,"properties":{"image_download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the binaries of the reference entity image file"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Reference entity code","x-immutable":true},"labels":{"type":"object","description":"Reference entity labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Reference entity label for the locale `localeCode`"}}},"image":{"type":"string","description":"Code of the reference entity image","default":null}},"example":{"code":"brands","labels":{"en_US":"Brands","fr_FR":"Marques"},"image":"0/2/d/6/54d81dc888ba1501a8g765f3ab5797569f3bv756c_ref_img.png"}}],"example":{"_links":{"image_download":{"href":"https://demo.akeneo.com/api/rest/v1/reference-entities-media-files/0/2/d/6/54d81dc888ba1501a8g765f3ab5797569f3bv756c_ref_img.png"}},"code":"brands","labels":{"en_US":"Brands","fr_FR":"Marques"},"image":"0/2/d/6/54d81dc888ba1501a8g765f3ab5797569f3bv756c_ref_img.png"}},"ReferenceEntityList":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}},"image_download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the binaries of the reference entity image file"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Reference entity code","x-immutable":true},"labels":{"type":"object","description":"Reference entity labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Reference entity label for the locale `localeCode`"}}},"image":{"type":"string","description":"Code of the reference entity image","default":null}},"example":{"code":"brands","labels":{"en_US":"Brands","fr_FR":"Marques"},"image":"0/2/d/6/54d81dc888ba1501a8g765f3ab5797569f3bv756c_ref_img.png"}}]},"ReferenceEntityAttribute":{"type":"object","required":["code","type"],"properties":{"code":{"type":"string","description":"Attribute code","x-immutable":true},"labels":{"type":"object","description":"Attribute labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute label for the locale `localeCode`"}}},"type":{"type":"string","description":"Attribute type. See type section for more details.","enum":["text","image","number","single_option","multiple_options","reference_entity_single_link","reference_entity_multiple_links"],"x-immutable":true},"value_per_locale":{"type":"boolean","description":"Whether the attribute is localizable, i.e. can have one value by locale","default":false,"x-immutable":true},"value_per_channel":{"type":"boolean","description":"Whether the attribute is scopable, i.e. can have one value by channel","default":false,"x-immutable":true},"is_required_for_completeness":{"type":"boolean","description":"Whether the attribute should be part of the record's completeness calculation","default":false},"max_characters":{"type":"integer","description":"Maximum number of characters allowed for the value of the attribute when the attribute type is `text`","x-warning":"Only for `text` attribute type"},"is_textarea":{"type":"boolean","description":"Whether the UI should display a text area instead of a simple field when the attribute type is `text`","default":false,"x-warning":"Only for `text` attribute type"},"is_rich_text_editor":{"type":"boolean","description":"Whether the UI should display a rich text editor instead of a simple text area when the attribute type is `text`","x-validation-rules":"Required when the property `is_textarea` is equal to `true`","x-warning":"Only for `text` attribute type"},"validation_rule":{"type":"string","description":"Validation rule type used to validate the attribute value when the attribute type is `text`","default":"none","x-warning":"Only for `text` attribute type","enum":["email","url","regexp","none"]},"validation_regexp":{"type":"string","description":"Regexp expression used to validate the attribute value when the attribute type is `text`","default":null,"x-validation-rules":"Required when the property `validation_rule` is equal to `regexp`","x-warning":"Only for `text` attribute type"},"allowed_extensions":{"type":"array","description":"Extensions allowed when the attribute type is `image`","default":[],"x-warning":"Only for `image` attribute type","items":{"type":"string"}},"max_file_size":{"type":"string","description":"Max file size in MB when the attribute type is `image`","default":null,"x-warning":"Only for `image` attribute type"},"reference_entity_code":{"type":"string","description":"Code of the linked reference entity when the attribute type is `reference_entity_single_link` or `reference_entity_multiple_links`","default":null,"x-validation-rules":"Required when the attribute type is either `reference_entity_single_link` or `reference_entity_multiple_links`","x-warning":"Only for `reference_entity_single_link` and `reference_entity_multiple_links` attribute type","x-immutable":true},"decimals_allowed":{"type":"boolean","description":"Whether decimals are allowed when the attribute type is `number`","default":false,"x-warning":"Only for `number` attribute type"},"min_value":{"type":"string","description":"Minimum value allowed when the attribute type is `number`","default":null,"x-validation-rules":"The minimum value must be lower than the maximum value","x-warning":"Only for `number` attribute type"},"max_value":{"type":"string","description":"Maximum value allowed when the attribute type is `number`","default":null,"x-validation-rules":"The maximum value must be greater than the minimum value","x-warning":"Only for `number` attribute type"}},"example":{"code":"description","labels":{"en_US":"Description","fr_FR":"Description"},"type":"text","value_per_locale":true,"value_per_channel":false,"is_required_for_completeness":true,"max_characters":null,"is_textarea":true,"is_rich_text_editor":true,"validation_rule":"none","validation_regexp":null}},"ReferenceEntityAttributeList":{"type":"array","items":{"type":"object","required":["code","type"],"properties":{"code":{"type":"string","description":"Attribute code","x-immutable":true},"labels":{"type":"object","description":"Attribute labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute label for the locale `localeCode`"}}},"type":{"type":"string","description":"Attribute type. See type section for more details.","enum":["text","image","number","single_option","multiple_options","reference_entity_single_link","reference_entity_multiple_links"],"x-immutable":true},"value_per_locale":{"type":"boolean","description":"Whether the attribute is localizable, i.e. can have one value by locale","default":false,"x-immutable":true},"value_per_channel":{"type":"boolean","description":"Whether the attribute is scopable, i.e. can have one value by channel","default":false,"x-immutable":true},"is_required_for_completeness":{"type":"boolean","description":"Whether the attribute should be part of the record's completeness calculation","default":false},"max_characters":{"type":"integer","description":"Maximum number of characters allowed for the value of the attribute when the attribute type is `text`","x-warning":"Only for `text` attribute type"},"is_textarea":{"type":"boolean","description":"Whether the UI should display a text area instead of a simple field when the attribute type is `text`","default":false,"x-warning":"Only for `text` attribute type"},"is_rich_text_editor":{"type":"boolean","description":"Whether the UI should display a rich text editor instead of a simple text area when the attribute type is `text`","x-validation-rules":"Required when the property `is_textarea` is equal to `true`","x-warning":"Only for `text` attribute type"},"validation_rule":{"type":"string","description":"Validation rule type used to validate the attribute value when the attribute type is `text`","default":"none","x-warning":"Only for `text` attribute type","enum":["email","url","regexp","none"]},"validation_regexp":{"type":"string","description":"Regexp expression used to validate the attribute value when the attribute type is `text`","default":null,"x-validation-rules":"Required when the property `validation_rule` is equal to `regexp`","x-warning":"Only for `text` attribute type"},"allowed_extensions":{"type":"array","description":"Extensions allowed when the attribute type is `image`","default":[],"x-warning":"Only for `image` attribute type","items":{"type":"string"}},"max_file_size":{"type":"string","description":"Max file size in MB when the attribute type is `image`","default":null,"x-warning":"Only for `image` attribute type"},"reference_entity_code":{"type":"string","description":"Code of the linked reference entity when the attribute type is `reference_entity_single_link` or `reference_entity_multiple_links`","default":null,"x-validation-rules":"Required when the attribute type is either `reference_entity_single_link` or `reference_entity_multiple_links`","x-warning":"Only for `reference_entity_single_link` and `reference_entity_multiple_links` attribute type","x-immutable":true},"decimals_allowed":{"type":"boolean","description":"Whether decimals are allowed when the attribute type is `number`","default":false,"x-warning":"Only for `number` attribute type"},"min_value":{"type":"string","description":"Minimum value allowed when the attribute type is `number`","default":null,"x-validation-rules":"The minimum value must be lower than the maximum value","x-warning":"Only for `number` attribute type"},"max_value":{"type":"string","description":"Maximum value allowed when the attribute type is `number`","default":null,"x-validation-rules":"The maximum value must be greater than the minimum value","x-warning":"Only for `number` attribute type"}},"example":{"code":"description","labels":{"en_US":"Description","fr_FR":"Description"},"type":"text","value_per_locale":true,"value_per_channel":false,"is_required_for_completeness":true,"max_characters":null,"is_textarea":true,"is_rich_text_editor":true,"validation_rule":"none","validation_regexp":null}}},"ReferenceEntityAttributeOption":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Attribute's option code","x-immutable":true},"labels":{"type":"object","description":"Attribute labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute label for the locale `localeCode`"}}}},"example":{"code":"global_nomad","labels":{"en_US":"Global Nomad","fr_FR":"Nomade du Monde"}}},"ReferenceEntityAttributeOptionList":{"type":"array","items":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Attribute's option code","x-immutable":true},"labels":{"type":"object","description":"Attribute labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute label for the locale `localeCode`"}}}},"example":{"code":"global_nomad","labels":{"en_US":"Global Nomad","fr_FR":"Nomade du Monde"}}}},"ReferenceEntityRecord":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Code of the record","x-immutable":true},"values":{"type":"object","description":"Record attributes values, see Reference entity record values section for more details","x-validation-rules":"Validation rules detailed in Reference entity record values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","description":"Channel code of the reference entity record value"},"locale":{"type":"string","description":"Locale code of the reference entity record value"},"data":{"type":"object","description":"Reference entity record value. See the `data` format section for more details."}}}}}},"created":{"type":"string","description":"Date of creation.","format":"dateTime","default":null,"x-immutable":true,"x-read-only":true,"x-from-version":"5.0"},"updated":{"type":"string","description":"Date of the last update.","format":"dateTime","default":null,"x-read-only":true,"x-from-version":"5.0"}},"example":{"code":"kartell","values":{"label":[{"locale":"en_US","channel":null,"data":"Kartell"}],"image":[{"locale":null,"channel":null,"data":"0/c/b/0/0cb0c0e115dedba676f8d1ad8343ec207ab54c7b_image.jpg"}],"description":[{"locale":"en_US","channel":null,"data":"Kartell, the Italian furniture company that sells modern and remarkable pieces of furnitures."},{"locale":"fr_FR","channel":null,"data":"Kartell, l'éditeur de meuble italien spécialisé dans la signature de belle pièces au design contemporain."}],"country":[{"locale":null,"channel":null,"data":"italy"}],"collection_overview":[{"locale":null,"channel":null,"data":"5/1/d/8/51d81dc778ba1501a8f998f3ab5797569f3b9e25_img.png"}],"creation_year":[{"locale":null,"channel":null,"data":"1949"}]},"created":"2021-01-01T01:23:34+00:00","updated":"2021-02-03T23:45:60+00:00"}},"ReferenceEntityRecordList":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Code of the record","x-immutable":true},"values":{"type":"object","description":"Record attributes values, see Reference entity record values section for more details","x-validation-rules":"Validation rules detailed in Reference entity record values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","description":"Channel code of the reference entity record value"},"locale":{"type":"string","description":"Locale code of the reference entity record value"},"data":{"type":"object","description":"Reference entity record value. See the `data` format section for more details."}}}}}},"created":{"type":"string","description":"Date of creation.","format":"dateTime","default":null,"x-immutable":true,"x-read-only":true,"x-from-version":"5.0"},"updated":{"type":"string","description":"Date of the last update.","format":"dateTime","default":null,"x-read-only":true,"x-from-version":"5.0"}},"example":{"code":"kartell","values":{"label":[{"locale":"en_US","channel":null,"data":"Kartell"}],"image":[{"locale":null,"channel":null,"data":"0/c/b/0/0cb0c0e115dedba676f8d1ad8343ec207ab54c7b_image.jpg"}],"description":[{"locale":"en_US","channel":null,"data":"Kartell, the Italian furniture company that sells modern and remarkable pieces of furnitures."},{"locale":"fr_FR","channel":null,"data":"Kartell, l'éditeur de meuble italien spécialisé dans la signature de belle pièces au design contemporain."}],"country":[{"locale":null,"channel":null,"data":"italy"}],"collection_overview":[{"locale":null,"channel":null,"data":"5/1/d/8/51d81dc778ba1501a8f998f3ab5797569f3b9e25_img.png"}],"creation_year":[{"locale":null,"channel":null,"data":"1949"}]},"created":"2021-01-01T01:23:34+00:00","updated":"2021-02-03T23:45:60+00:00"}}]},"Category":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Category code","x-immutable":true},"parent":{"type":"string","description":"Category code of the parent's category","x-validation-rules":"• It is either equal to `null` or to an existing category code. • If equal to an existing category code, it cannot reference itself.","default":"null"},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"position":{"type":"integer","description":"Position of the category in its level, start from 1 (only available since the 7.0 version and when query parameter \"with_position\" is set to \"true\")","x-read-only":true},"labels":{"type":"object","description":"Category labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Category label for the locale `localeCode`"}}},"values":{"type":"object","description":"Attribute values","default":null,"properties":{"attributeCode|attributeUuid|channelCode|localeCode":{"type":"array","items":{"type":"object","properties":{"data":{"type":"object","description":"Attribute value"},"type":{"type":"string","description":"The attribute type"},"locale":{"type":"string","description":"Locale code of the attribute value"},"channel":{"type":"string","description":"Channel code of the attribute value"},"attribute_code":{"type":"string","description":"The attribute code with its uuid (attributeCode|attributeUuid)"}}}}}}},"example":{"code":"winter_collection","parent":null,"updated":"2021-05-22T12:48:00+02:00","position":1,"labels":{"en_US":"Winter collection","fr_FR":"Collection hiver"},"values":{"description|96b88bf4-c2b7-4b64-a1f9-5d4876c02c26|ecommerce|en_US":{"data":"

Winter collection description

\n","type":"textarea","channel":"ecommerce","locale":"en_US","attribute_code":"description|96b88bf4-c2b7-4b64-a1f9-5d4876c02c26"},"image_1|871b8686-79b5-415c-9c6f-a38f8732dfb7|ecommerce|en_US":{"data":{"size":1401359,"extension":"jpg","file_path":"2/d/c/7/2dc791671d726e7438219d5dc7fd51a53d6bf2bb_IMG_7860.jpg","mime_type":"image/jpeg","original_filename":"IMG_7860.jpg"},"type":"image","channel":"ecommerce","locale":"en_US","attribute_code":"image_1|871b8686-79b5-415c-9c6f-a38f8732dfb7"}}}},"CategoryUpdate":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Category code","x-immutable":true},"parent":{"type":"string","description":"Category code of the parent's category","x-validation-rules":"• It is either equal to `null` or to an existing category code. • If equal to an existing category code, it cannot reference itself.","default":"null"},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"position":{"type":"integer","description":"Position of the category in its level, start from 1 (only available since the 7.0 version and when query parameter \"with_position\" is set to \"true\")","x-read-only":true},"labels":{"type":"object","description":"Category labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Category label for the locale `localeCode`"}}},"values":{"type":"array","description":"Attribute values (only available on SaaS).","default":[],"items":{"type":"object","properties":{"data":{"type":"string","description":"Attribute value. It should be a `string` for Text and Text Area attributes, a `boolean` for Yes/No attribute and for Image attribute use the create category media file endpoint. It can also be `null` to remove the value."},"locale":{"type":"string","description":"Locale code of the attribute value."},"channel":{"type":"string","description":"Channel code of the attribute value."},"attribute_code":{"type":"string","description":"The attribute code."}}}}},"example":{"code":"winter_collection","parent":null,"labels":{"en_US":"Winter collection","fr_FR":"Collection hiver"},"values":[{"data":"

Winter collection description

","channel":"ecommerce","locale":"en_US","attribute_code":"a_text_area_attribute"},{"data":false,"channel":"ecommerce","locale":null,"attribute_code":"a_boolean_attribute"},{"data":null,"channel":null,"locale":null,"attribute_code":"an_image_attribute"}]}},"CategoryList":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Category code","x-immutable":true},"parent":{"type":"string","description":"Category code of the parent's category","x-validation-rules":"• It is either equal to `null` or to an existing category code. • If equal to an existing category code, it cannot reference itself.","default":"null"},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"position":{"type":"integer","description":"Position of the category in its level, start from 1 (only available since the 7.0 version and when query parameter \"with_position\" is set to \"true\")","x-read-only":true},"labels":{"type":"object","description":"Category labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Category label for the locale `localeCode`"}}},"values":{"type":"object","description":"Attribute values","default":null,"properties":{"attributeCode|attributeUuid|channelCode|localeCode":{"type":"array","items":{"type":"object","properties":{"data":{"type":"object","description":"Attribute value"},"type":{"type":"string","description":"The attribute type"},"locale":{"type":"string","description":"Locale code of the attribute value"},"channel":{"type":"string","description":"Channel code of the attribute value"},"attribute_code":{"type":"string","description":"The attribute code with its uuid (attributeCode|attributeUuid)"}}}}}}},"example":{"code":"winter_collection","parent":null,"updated":"2021-05-22T12:48:00+02:00","position":1,"labels":{"en_US":"Winter collection","fr_FR":"Collection hiver"},"values":{"description|96b88bf4-c2b7-4b64-a1f9-5d4876c02c26|ecommerce|en_US":{"data":"

Winter collection description

\n","type":"textarea","channel":"ecommerce","locale":"en_US","attribute_code":"description|96b88bf4-c2b7-4b64-a1f9-5d4876c02c26"},"image_1|871b8686-79b5-415c-9c6f-a38f8732dfb7|ecommerce|en_US":{"data":{"size":1401359,"extension":"jpg","file_path":"2/d/c/7/2dc791671d726e7438219d5dc7fd51a53d6bf2bb_IMG_7860.jpg","mime_type":"image/jpeg","original_filename":"IMG_7860.jpg"},"type":"image","channel":"ecommerce","locale":"en_US","attribute_code":"image_1|871b8686-79b5-415c-9c6f-a38f8732dfb7"}}}}]},"MeasureFamily":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Measure family code","x-immutable":true},"standard":{"type":"string","description":"Measure family standard","x-immutable":true},"units":{"type":"array","description":"Family units","items":{"type":"object","properties":{"code":{"type":"string","description":"Measure code","x-immutable":true},"convert":{"type":"object","description":"Mathematic operation to convert the unit into the standard unit"},"symbol":{"type":"string","description":"Measure symbol","x-immutable":true}}}}},"example":{"code":"Area","standard":"SQUARE_METER","units":[{"code":"SQUARE_MILLIMETER","convert":{"mul":"0.001"},"symbol":"mm²"},{"code":"SQUARE_CENTIMETER","convert":{"mul":"0.001"},"symbol":"cm²"}]}},"MeasureFamilyList":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Measure family code","x-immutable":true},"standard":{"type":"string","description":"Measure family standard","x-immutable":true},"units":{"type":"array","description":"Family units","items":{"type":"object","properties":{"code":{"type":"string","description":"Measure code","x-immutable":true},"convert":{"type":"object","description":"Mathematic operation to convert the unit into the standard unit"},"symbol":{"type":"string","description":"Measure symbol","x-immutable":true}}}}},"example":{"code":"Area","standard":"SQUARE_METER","units":[{"code":"SQUARE_MILLIMETER","convert":{"mul":"0.001"},"symbol":"mm²"},{"code":"SQUARE_CENTIMETER","convert":{"mul":"0.001"},"symbol":"cm²"}]}}]},"MeasurementFamily":{"type":"object","required":["code","standard_unit_code","units"],"properties":{"code":{"type":"string","description":"Measurement family code","x-immutable":true},"labels":{"type":"object","description":"Measurement family labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Measurement family label for the locale `localeCode`"}}},"standard_unit_code":{"type":"string","description":"Unit code used as the standard unit for this measurement family","x-immutable":true,"x-validation-rules":"The unit code exists in the list of the property `units`"},"units":{"type":"object","description":"Measurement units for this family with their conversion operations. More details here.","x-validation-rules":"A unit can't be added when a product attribute is linked to this measurement family","properties":{"unitCode":{"type":"object","properties":{"code":{"type":"string","description":"Measurement unit code. More details here.","x-immutable":true},"labels":{"type":"object","description":"Unit labels for each locale. More details here.","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Unit label for the locale `localeCode`"}}},"convert_from_standard":{"type":"array","description":"Calculation to convert the unit from the standard unit. More details here.","x-validation-rules":"• The conversion operations can't be updated when a product attribute is linked to this measurement family • At least one conversion operation per unit is required","items":{"type":"object","properties":{"operator":{"type":"string","description":"Operator for a conversion operation to convert the unit in the standard unit","x-validation-rules":"The operator is one of the following values","enum":["mul","div","add","sub"]},"value":{"type":"string","description":"Value for a conversion operation to convert the unit in the standard unit"}}}},"symbol":{"type":"string","description":"Measurement unit symbol. More details here."}}}}}},"example":{"code":"AREA","labels":{"en_US":"Area","fr_FR":"Surface"},"standard_unit_code":"SQUARE_METER","units":{"SQUARE_MILLIMETER":{"code":"SQUARE_MILLIMETER","labels":{"en_US":"Square millimeter","fr_FR":"Millimètre carré"},"convert_from_standard":[{"operator":"mul","value":"0.000001"}],"symbol":"mm²"},"SQUARE_CENTIMETER":{"code":"SQUARE_CENTIMETER","labels":{"en_US":"Square centimeter","fr_FR":"Centimètre carré"},"convert_from_standard":[{"operator":"mul","value":"0.0001"}],"symbol":"cm²"},"SQUARE_METER":{"code":"SQUARE_METER","labels":{"en_US":"Square meter","fr_FR":"Mètre carré"},"convert_from_standard":[{"operator":"mul","value":"1"}],"symbol":"m²"}}}},"MeasurementFamilyList":{"type":"object","required":["code","standard_unit_code","units"],"properties":{"code":{"type":"string","description":"Measurement family code","x-immutable":true},"labels":{"type":"object","description":"Measurement family labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Measurement family label for the locale `localeCode`"}}},"standard_unit_code":{"type":"string","description":"Unit code used as the standard unit for this measurement family","x-immutable":true,"x-validation-rules":"The unit code exists in the list of the property `units`"},"units":{"type":"object","description":"Measurement units for this family with their conversion operations. More details here.","x-validation-rules":"A unit can't be added when a product attribute is linked to this measurement family","properties":{"unitCode":{"type":"object","properties":{"code":{"type":"string","description":"Measurement unit code. More details here.","x-immutable":true},"labels":{"type":"object","description":"Unit labels for each locale. More details here.","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Unit label for the locale `localeCode`"}}},"convert_from_standard":{"type":"array","description":"Calculation to convert the unit from the standard unit. More details here.","x-validation-rules":"• The conversion operations can't be updated when a product attribute is linked to this measurement family • At least one conversion operation per unit is required","items":{"type":"object","properties":{"operator":{"type":"string","description":"Operator for a conversion operation to convert the unit in the standard unit","x-validation-rules":"The operator is one of the following values","enum":["mul","div","add","sub"]},"value":{"type":"string","description":"Value for a conversion operation to convert the unit in the standard unit"}}}},"symbol":{"type":"string","description":"Measurement unit symbol. More details here."}}}}}},"example":{"code":"AREA","labels":{"en_US":"Area","fr_FR":"Surface"},"standard_unit_code":"SQUARE_METER","units":{"SQUARE_MILLIMETER":{"code":"SQUARE_MILLIMETER","labels":{"en_US":"Square millimeter","fr_FR":"Millimètre carré"},"convert_from_standard":[{"operator":"mul","value":"0.000001"}],"symbol":"mm²"},"SQUARE_CENTIMETER":{"code":"SQUARE_CENTIMETER","labels":{"en_US":"Square centimeter","fr_FR":"Centimètre carré"},"convert_from_standard":[{"operator":"mul","value":"0.0001"}],"symbol":"cm²"},"SQUARE_METER":{"code":"SQUARE_METER","labels":{"en_US":"Square meter","fr_FR":"Mètre carré"},"convert_from_standard":[{"operator":"mul","value":"1"}],"symbol":"m²"}}}},"Family":{"type":"object","required":["code","attribute_as_label"],"properties":{"code":{"type":"string","description":"Family code","x-immutable":true},"attribute_as_label":{"type":"string","description":"Attribute code used as label","x-validation-rules":"• It is equal to an existing attribute code • This attribute code is in the array of the property `attributes` • The type of this attribute is either `pim_catalog_identifier` or `pim_catalog_text`"},"attribute_as_image":{"type":"string","description":"Attribute code used as the main picture in the user interface (only since v2.0)","x-validation-rules":"• It is equal to an existing attribute code • This attribute code is in the array of the property `attributes` • The type of this attribute is `pim_catalog_image`. Since v2.1, you can also use a `pim_assets_collection` attribute type","default":"null","x-from-version":"2.0"},"attributes":{"type":"array","description":"Attributes codes that compose the family","x-validation-rules":"Each string of the array is an existing attribute code","items":{"type":"string"},"default":[]},"attribute_requirements":{"type":"object","description":"Attributes codes of the family that are required for the completeness calculation for each channel","x-validation-rules":"• Each string of these arrays is an existing attribute code • These attribute codes are in the array of the property `attributes` • The `channelCode` is the code of an existing and activated channel","properties":{"channelCode":{"type":"array","items":{"type":"string","description":"Attributes codes of the family that are required for the completeness calculation for the channel `channelCode`"}}}},"labels":{"type":"object","description":"Family labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Family label for the locale `localeCode`"}}}},"example":{"code":"caps","attributes":["sku","name","description","price","color","picture"],"attribute_as_label":"name","attribute_as_image":"picture","attribute_requirements":{"ecommerce":["sku","name","description","price","color"],"tablet":["sku","name","description","price"]},"labels":{"en_US":"Caps","fr_FR":"Casquettes"}}},"FamilyList":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code","attribute_as_label"],"properties":{"code":{"type":"string","description":"Family code","x-immutable":true},"attribute_as_label":{"type":"string","description":"Attribute code used as label","x-validation-rules":"• It is equal to an existing attribute code • This attribute code is in the array of the property `attributes` • The type of this attribute is either `pim_catalog_identifier` or `pim_catalog_text`"},"attribute_as_image":{"type":"string","description":"Attribute code used as the main picture in the user interface (only since v2.0)","x-validation-rules":"• It is equal to an existing attribute code • This attribute code is in the array of the property `attributes` • The type of this attribute is `pim_catalog_image`. Since v2.1, you can also use a `pim_assets_collection` attribute type","default":"null","x-from-version":"2.0"},"attributes":{"type":"array","description":"Attributes codes that compose the family","x-validation-rules":"Each string of the array is an existing attribute code","items":{"type":"string"},"default":[]},"attribute_requirements":{"type":"object","description":"Attributes codes of the family that are required for the completeness calculation for each channel","x-validation-rules":"• Each string of these arrays is an existing attribute code • These attribute codes are in the array of the property `attributes` • The `channelCode` is the code of an existing and activated channel","properties":{"channelCode":{"type":"array","items":{"type":"string","description":"Attributes codes of the family that are required for the completeness calculation for the channel `channelCode`"}}}},"labels":{"type":"object","description":"Family labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Family label for the locale `localeCode`"}}}},"example":{"code":"caps","attributes":["sku","name","description","price","color","picture"],"attribute_as_label":"name","attribute_as_image":"picture","attribute_requirements":{"ecommerce":["sku","name","description","price","color"],"tablet":["sku","name","description","price"]},"labels":{"en_US":"Caps","fr_FR":"Casquettes"}}}]},"FamilyVariant":{"type":"object","required":["code","variant_attribute_sets"],"properties":{"code":{"type":"string","description":"Family variant code","x-immutable":true},"variant_attribute_sets":{"type":"array","description":"Attributes distribution according to the enrichment level","items":{"type":"object","required":["level","axes"],"description":"Enrichment level","properties":{"level":{"type":"integer","description":"Enrichment level","x-immutable":true,"x-validation-rules":"• Number representing the level of the attribute set. • It should be equal to 1 or 2. • If you specify the level 2, you have to specify the level 1 as well."},"axes":{"type":"array","description":"Codes of attributes used as variant axes","x-immutable":true,"items":{"type":"string"},"default":[],"x-validation-rules":"• Should be an array of maximum 5 existing attribute codes • These attributes should belong to the family of the family variant • Only the following attribute types are allowed: `simple select`, `multi select`, `reference data`, `metric`, `boolean` • Attributes cannot be scopable, nor localizable nor locale specific • Attributes used as axes in one level cannot be used as axes or as attributes in the other level"},"attributes":{"type":"array","description":"Codes of attributes bind to this enrichment level","items":{"type":"string"},"default":[],"x-validation-rules":"• Should be an array of existing attribute codes • These attributes should belong to the family of the family variant • Attributes used as attribute in one level cannot be used as axes or as attributes in the other level • Attributes that are `unique value` or `identifier` are automatically distributed to the lower level."}}}},"labels":{"type":"object","description":"Family variant labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Family variant label for the locale `localeCode`"}}}},"example":{"code":"shoesVariant","labels":{"en_US":"Shoes variant","fr_FR":"Variante de chaussures"},"variant_attribute_sets":[{"level":1,"attributes":["color","material"],"axes":["color"]},{"level":2,"attributes":["sku","size"],"axes":["size"]}]}},"FamilyVariantList":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code","variant_attribute_sets"],"properties":{"code":{"type":"string","description":"Family variant code","x-immutable":true},"variant_attribute_sets":{"type":"array","description":"Attributes distribution according to the enrichment level","items":{"type":"object","required":["level","axes"],"description":"Enrichment level","properties":{"level":{"type":"integer","description":"Enrichment level","x-immutable":true,"x-validation-rules":"• Number representing the level of the attribute set. • It should be equal to 1 or 2. • If you specify the level 2, you have to specify the level 1 as well."},"axes":{"type":"array","description":"Codes of attributes used as variant axes","x-immutable":true,"items":{"type":"string"},"default":[],"x-validation-rules":"• Should be an array of maximum 5 existing attribute codes • These attributes should belong to the family of the family variant • Only the following attribute types are allowed: `simple select`, `multi select`, `reference data`, `metric`, `boolean` • Attributes cannot be scopable, nor localizable nor locale specific • Attributes used as axes in one level cannot be used as axes or as attributes in the other level"},"attributes":{"type":"array","description":"Codes of attributes bind to this enrichment level","items":{"type":"string"},"default":[],"x-validation-rules":"• Should be an array of existing attribute codes • These attributes should belong to the family of the family variant • Attributes used as attribute in one level cannot be used as axes or as attributes in the other level • Attributes that are `unique value` or `identifier` are automatically distributed to the lower level."}}}},"labels":{"type":"object","description":"Family variant labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Family variant label for the locale `localeCode`"}}}},"example":{"code":"shoesVariant","labels":{"en_US":"Shoes variant","fr_FR":"Variante de chaussures"},"variant_attribute_sets":[{"level":1,"attributes":["color","material"],"axes":["color"]},{"level":2,"attributes":["sku","size"],"axes":["size"]}]}}]},"Attribute":{"type":"object","required":["code","type","group"],"properties":{"code":{"type":"string","description":"Attribute code","x-immutable":true},"type":{"type":"string","description":"Attribute type. See type section for more details.","x-validation-rules":"The type is one of the following values","enum":["pim_catalog_identifier","pim_catalog_metric","pim_catalog_number","pim_catalog_reference_data_multi_select","pim_catalog_reference_data_simple_select","pim_catalog_simpleselect","pim_catalog_multiselect","pim_catalog_date","pim_catalog_textarea","pim_catalog_text","pim_catalog_file","pim_catalog_image","pim_catalog_price_collection","pim_catalog_boolean","akeneo_reference_entity","akeneo_reference_entity_collection","pim_catalog_asset_collection"],"x-immutable":true},"labels":{"type":"object","description":"Attribute labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute label for the locale `localeCode`"}}},"group":{"type":"string","description":"Attribute group","x-validation-rules":"It is the code of an existing group"},"group_labels":{"type":"object","description":"Group labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","x-read-only":true,"default":{},"properties":{"localeCode":{"type":"string","description":"Group label for the locale `localeCode`"}}},"sort_order":{"type":"integer","description":"Order of the attribute in its group","x-validation-rules":"It is a positive integer","default":0},"localizable":{"type":"boolean","description":"Whether the attribute is localizable, i.e. can have one value by locale","default":false,"x-immutable":true},"scopable":{"type":"boolean","description":"Whether the attribute is scopable, i.e. can have one value by channel","default":false,"x-immutable":true},"available_locales":{"type":"array","description":"To make the attribute locale specfic, specify here for which locales it is specific","x-validation-rules":"Each string of the array is an existing and activated locale","items":{"type":"string"}},"unique":{"type":"boolean","description":"Whether two values for the attribute cannot be the same","x-immutable":true},"useable_as_grid_filter":{"type":"boolean","description":"Whether the attribute can be used as a filter for the product grid in the PIM user interface"},"max_characters":{"type":"integer","description":"Number maximum of characters allowed for the value of the attribute when the attribute type is `pim_catalog_text`, `pim_catalog_textarea` or `pim_catalog_identifier`","x-warning":"Only for `pim_catalog_text`, `pim_catalog_textarea` or `pim_catalog_identifier` attribute types"},"validation_rule":{"type":"string","description":"Validation rule type used to validate any attribute value when the attribute type is `pim_catalog_text` or `pim_catalog_identifier`","x-validation-rules":"Equal to `regexp` when the attribute type is equal to `pim_catalog_identifier`","x-warning":"Only for `pim_catalog_text` or `pim_catalog_identifier` attribute types"},"validation_regexp":{"type":"string","description":"Regexp expression used to validate any attribute value when the attribute type is `pim_catalog_text` or `pim_catalog_identifier`","x-validation-rules":"Required when the property `validation_rule` is equal to `regexp`","x-warning":"Only for `pim_catalog_text` or `pim_catalog_identifier` attribute types"},"wysiwyg_enabled":{"type":"boolean","description":"Whether the WYSIWYG interface is shown when the attribute type is `pim_catalog_textarea`","x-warning":"Only for `pim_catalog_textarea` attribute type"},"number_min":{"type":"string","description":"Minimum integer value allowed when the attribute type is `pim_catalog_metric`, `pim_catalog_price` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric`, `pim_catalog_price_collection` or `pim_catalog_number` attribute types"},"number_max":{"type":"string","description":"Maximum integer value allowed when the attribute type is `pim_catalog_metric`, `pim_catalog_price` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric`, `pim_catalog_price_collection` or `pim_catalog_number` attribute types"},"decimals_allowed":{"type":"boolean","description":"Whether decimals are allowed when the attribute type is `pim_catalog_metric`, `pim_catalog_price` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric`, `pim_catalog_price_collection` or `pim_catalog_number` attribute types"},"negative_allowed":{"type":"boolean","description":"Whether negative values are allowed when the attribute type is `pim_catalog_metric` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric` or `pim_catalog_number` attribute types"},"metric_family":{"type":"string","description":"Metric family when the attribute type is `pim_catalog_metric`","x-immutable":true,"x-validation-rules":"Required for `pim_catalog_metric` attribute type","x-warning":"Only for `pim_catalog_metric` attribute type"},"default_metric_unit":{"type":"string","description":"Default metric unit when the attribute type is `pim_catalog_metric`","x-validation-rules":"Required for `pim_catalog_metric` attribute type","x-warning":"Only for `pim_catalog_metric` attribute type"},"date_min":{"type":"string","description":"Minimum date allowed when the attribute type is `pim_catalog_date`","x-validation-rules":"The datetime format follows the ISO-8601 norm","x-warning":"Only for `pim_catalog_date` attribute type","format":"date-time"},"date_max":{"type":"string","description":"Maximum date allowed when the attribute type is `pim_catalog_date`","x-validation-rules":"The datetime format follows the ISO-8601 norm","x-warning":"Only for `pim_catalog_date` attribute type","format":"date-time"},"allowed_extensions":{"type":"array","description":"Extensions allowed when the attribute type is `pim_catalog_file` or `pim_catalog_image`","x-warning":"Only for `pim_catalog_file` or `pim_catalog_image` attribute types","items":{"type":"string"}},"max_file_size":{"type":"string","description":"Max file size in MB when the attribute type is `pim_catalog_file` or `pim_catalog_image`","x-warning":"Only for `pim_catalog_file` or `pim_catalog_image` attribute types"},"reference_data_name":{"type":"string","description":"Reference entity code when the attribute type is `akeneo_reference_entity` or `akeneo_reference_entity_collection` OR Asset family code when the attribute type is `pim_catalog_asset_collection`","x-validation-rules":"Required only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types","x-warning":"Only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types"},"default_value":{"type":"boolean","description":"Default value for a Yes/No attribute, applied when creating a new product or product model (only available since the 5.0)","x-warning":"Only for `pim_catalog_boolean` attribute type","x-from-version":"5.0"},"table_configuration":{"type":"array","description":"Configuration of the Table attribute (columns)","x-validation-rules":"Required only for `pim_catalog_table` attribute type","x-warning":"Only for `pim_catalog_table` attribute type","items":{"type":"object","required":["code","data_type"],"properties":{"code":{"type":"string","description":"Column code"},"data_type":{"type":"string","enum":["select","text","number","boolean"],"description":"Column data type"},"validations":{"type":"object","description":"User defined validation constraints on the cell content","default":{},"properties":{"min":{"type":"number","description":"minimum value of a numeric cell","x-validation-rules":"only for `number` data type columns"},"max":{"type":"number","description":"maximum value of a numeric cell","x-validation-rules":"only for `number` data type columns"},"decimals_allowed":{"type":"boolean","description":"whether the value of a numeric cell can hold a decimal part","x-validation-rules":"only for `number` data type columns"},"max_length":{"type":"number","description":"maximum length of a text cell","x-validation-rules":"only for `text` data type columns"}}},"labels":{"type":"object","description":"Column labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Column label for the locale `localeCode`"}}},"is_required_for_completeness":{"type":"boolean","description":"Defines if the column should be entirely filled for the attribute to be considered complete","x-warning":"This value is always true for the first column in a table configuration","default":false}}}},"is_main_identifier":{"type":"boolean","description":"Is this attribute main identifier when attribute type is `pim_catalog_identifier`"}},"example":{"code":"release_date","type":"pim_catalog_date","group":"marketing","group_labels":{"en_US":"Marketing","fr_FR":"Marketing"},"unique":false,"useable_as_grid_filter":true,"allowed_extensions":[],"metric_family":null,"default_metric_unit":null,"reference_data_name":null,"available_locales":[],"max_characters":null,"validation_rule":null,"validation_regexp":null,"wysiwyg_enabled":null,"number_min":null,"number_max":null,"decimals_allowed":null,"negative_allowed":null,"date_min":"2017-06-28T08:00:00","date_max":"2017-08-08T22:00:00","max_file_size":null,"minimum_input_length":null,"sort_order":1,"localizable":false,"scopable":false,"default_value":null,"labels":{"en_US":"Sale date","fr_FR":"Date des soldes"}}},"AttributeList":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code","type","group"],"properties":{"code":{"type":"string","description":"Attribute code","x-immutable":true},"type":{"type":"string","description":"Attribute type. See type section for more details.","x-validation-rules":"The type is one of the following values","enum":["pim_catalog_identifier","pim_catalog_metric","pim_catalog_number","pim_catalog_reference_data_multi_select","pim_catalog_reference_data_simple_select","pim_catalog_simpleselect","pim_catalog_multiselect","pim_catalog_date","pim_catalog_textarea","pim_catalog_text","pim_catalog_file","pim_catalog_image","pim_catalog_price_collection","pim_catalog_boolean","akeneo_reference_entity","akeneo_reference_entity_collection","pim_catalog_asset_collection"],"x-immutable":true},"labels":{"type":"object","description":"Attribute labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute label for the locale `localeCode`"}}},"group":{"type":"string","description":"Attribute group","x-validation-rules":"It is the code of an existing group"},"group_labels":{"type":"object","description":"Group labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","x-read-only":true,"default":{},"properties":{"localeCode":{"type":"string","description":"Group label for the locale `localeCode`"}}},"sort_order":{"type":"integer","description":"Order of the attribute in its group","x-validation-rules":"It is a positive integer","default":0},"localizable":{"type":"boolean","description":"Whether the attribute is localizable, i.e. can have one value by locale","default":false,"x-immutable":true},"scopable":{"type":"boolean","description":"Whether the attribute is scopable, i.e. can have one value by channel","default":false,"x-immutable":true},"available_locales":{"type":"array","description":"To make the attribute locale specfic, specify here for which locales it is specific","x-validation-rules":"Each string of the array is an existing and activated locale","items":{"type":"string"}},"unique":{"type":"boolean","description":"Whether two values for the attribute cannot be the same","x-immutable":true},"useable_as_grid_filter":{"type":"boolean","description":"Whether the attribute can be used as a filter for the product grid in the PIM user interface"},"max_characters":{"type":"integer","description":"Number maximum of characters allowed for the value of the attribute when the attribute type is `pim_catalog_text`, `pim_catalog_textarea` or `pim_catalog_identifier`","x-warning":"Only for `pim_catalog_text`, `pim_catalog_textarea` or `pim_catalog_identifier` attribute types"},"validation_rule":{"type":"string","description":"Validation rule type used to validate any attribute value when the attribute type is `pim_catalog_text` or `pim_catalog_identifier`","x-validation-rules":"Equal to `regexp` when the attribute type is equal to `pim_catalog_identifier`","x-warning":"Only for `pim_catalog_text` or `pim_catalog_identifier` attribute types"},"validation_regexp":{"type":"string","description":"Regexp expression used to validate any attribute value when the attribute type is `pim_catalog_text` or `pim_catalog_identifier`","x-validation-rules":"Required when the property `validation_rule` is equal to `regexp`","x-warning":"Only for `pim_catalog_text` or `pim_catalog_identifier` attribute types"},"wysiwyg_enabled":{"type":"boolean","description":"Whether the WYSIWYG interface is shown when the attribute type is `pim_catalog_textarea`","x-warning":"Only for `pim_catalog_textarea` attribute type"},"number_min":{"type":"string","description":"Minimum integer value allowed when the attribute type is `pim_catalog_metric`, `pim_catalog_price` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric`, `pim_catalog_price_collection` or `pim_catalog_number` attribute types"},"number_max":{"type":"string","description":"Maximum integer value allowed when the attribute type is `pim_catalog_metric`, `pim_catalog_price` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric`, `pim_catalog_price_collection` or `pim_catalog_number` attribute types"},"decimals_allowed":{"type":"boolean","description":"Whether decimals are allowed when the attribute type is `pim_catalog_metric`, `pim_catalog_price` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric`, `pim_catalog_price_collection` or `pim_catalog_number` attribute types"},"negative_allowed":{"type":"boolean","description":"Whether negative values are allowed when the attribute type is `pim_catalog_metric` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric` or `pim_catalog_number` attribute types"},"metric_family":{"type":"string","description":"Metric family when the attribute type is `pim_catalog_metric`","x-immutable":true,"x-validation-rules":"Required for `pim_catalog_metric` attribute type","x-warning":"Only for `pim_catalog_metric` attribute type"},"default_metric_unit":{"type":"string","description":"Default metric unit when the attribute type is `pim_catalog_metric`","x-validation-rules":"Required for `pim_catalog_metric` attribute type","x-warning":"Only for `pim_catalog_metric` attribute type"},"date_min":{"type":"string","description":"Minimum date allowed when the attribute type is `pim_catalog_date`","x-validation-rules":"The datetime format follows the ISO-8601 norm","x-warning":"Only for `pim_catalog_date` attribute type","format":"date-time"},"date_max":{"type":"string","description":"Maximum date allowed when the attribute type is `pim_catalog_date`","x-validation-rules":"The datetime format follows the ISO-8601 norm","x-warning":"Only for `pim_catalog_date` attribute type","format":"date-time"},"allowed_extensions":{"type":"array","description":"Extensions allowed when the attribute type is `pim_catalog_file` or `pim_catalog_image`","x-warning":"Only for `pim_catalog_file` or `pim_catalog_image` attribute types","items":{"type":"string"}},"max_file_size":{"type":"string","description":"Max file size in MB when the attribute type is `pim_catalog_file` or `pim_catalog_image`","x-warning":"Only for `pim_catalog_file` or `pim_catalog_image` attribute types"},"reference_data_name":{"type":"string","description":"Reference entity code when the attribute type is `akeneo_reference_entity` or `akeneo_reference_entity_collection` OR Asset family code when the attribute type is `pim_catalog_asset_collection`","x-validation-rules":"Required only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types","x-warning":"Only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types"},"default_value":{"type":"boolean","description":"Default value for a Yes/No attribute, applied when creating a new product or product model (only available since the 5.0)","x-warning":"Only for `pim_catalog_boolean` attribute type","x-from-version":"5.0"},"table_configuration":{"type":"array","description":"Configuration of the Table attribute (columns)","x-validation-rules":"Required only for `pim_catalog_table` attribute type","x-warning":"Only for `pim_catalog_table` attribute type","items":{"type":"object","required":["code","data_type"],"properties":{"code":{"type":"string","description":"Column code"},"data_type":{"type":"string","enum":["select","text","number","boolean"],"description":"Column data type"},"validations":{"type":"object","description":"User defined validation constraints on the cell content","default":{},"properties":{"min":{"type":"number","description":"minimum value of a numeric cell","x-validation-rules":"only for `number` data type columns"},"max":{"type":"number","description":"maximum value of a numeric cell","x-validation-rules":"only for `number` data type columns"},"decimals_allowed":{"type":"boolean","description":"whether the value of a numeric cell can hold a decimal part","x-validation-rules":"only for `number` data type columns"},"max_length":{"type":"number","description":"maximum length of a text cell","x-validation-rules":"only for `text` data type columns"}}},"labels":{"type":"object","description":"Column labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Column label for the locale `localeCode`"}}},"is_required_for_completeness":{"type":"boolean","description":"Defines if the column should be entirely filled for the attribute to be considered complete","x-warning":"This value is always true for the first column in a table configuration","default":false}}}},"is_main_identifier":{"type":"boolean","description":"Is this attribute main identifier when attribute type is `pim_catalog_identifier`"}},"example":{"code":"release_date","type":"pim_catalog_date","group":"marketing","group_labels":{"en_US":"Marketing","fr_FR":"Marketing"},"unique":false,"useable_as_grid_filter":true,"allowed_extensions":[],"metric_family":null,"default_metric_unit":null,"reference_data_name":null,"available_locales":[],"max_characters":null,"validation_rule":null,"validation_regexp":null,"wysiwyg_enabled":null,"number_min":null,"number_max":null,"decimals_allowed":null,"negative_allowed":null,"date_min":"2017-06-28T08:00:00","date_max":"2017-08-08T22:00:00","max_file_size":null,"minimum_input_length":null,"sort_order":1,"localizable":false,"scopable":false,"default_value":null,"labels":{"en_US":"Sale date","fr_FR":"Date des soldes"}}}]},"AttributeOption":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Code of option"},"attribute":{"type":"string","description":"Code of attribute related to the attribute option","x-validation-rules":"It is the same attribute code as the one given as path parameter"},"sort_order":{"type":"integer","description":"Order of attribute option","x-validation-rules":"It is a positive integer"},"labels":{"type":"object","description":"Attribute option labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute option label for the locale `localeCode`"}}}},"example":{"code":"black","attribute":"a_simple_select","sort_order":2,"labels":{"en_US":"Black","fr_FR":"Noir"}}},"AttributeOptionList":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Code of option"},"attribute":{"type":"string","description":"Code of attribute related to the attribute option","x-validation-rules":"It is the same attribute code as the one given as path parameter"},"sort_order":{"type":"integer","description":"Order of attribute option","x-validation-rules":"It is a positive integer"},"labels":{"type":"object","description":"Attribute option labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute option label for the locale `localeCode`"}}}},"example":{"code":"black","attribute":"a_simple_select","sort_order":2,"labels":{"en_US":"Black","fr_FR":"Noir"}}}]},"AttributeGroup":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Attribute group code","x-immutable":true},"sort_order":{"type":"integer","description":"Attribute group order among other attribute groups","x-validation-rules":"It is a positive integer","default":0},"attributes":{"type":"array","description":"Attribute codes that compose the attribute group","x-validation-rules":"Each string of the array is an existing attribute code, an attribute can only be in one attribute group","items":{"type":"string"},"default":[]},"labels":{"type":"object","description":"Attribute group labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute group label for the locale `localeCode`"}}}},"example":{"code":"marketing","sort_order":4,"attributes":["sku","name","description","response_time","release_date","price"],"labels":{"en_US":"Marketing","fr_FR":"Marketing"}}},"AttributeGroupList":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Attribute group code","x-immutable":true},"sort_order":{"type":"integer","description":"Attribute group order among other attribute groups","x-validation-rules":"It is a positive integer","default":0},"attributes":{"type":"array","description":"Attribute codes that compose the attribute group","x-validation-rules":"Each string of the array is an existing attribute code, an attribute can only be in one attribute group","items":{"type":"string"},"default":[]},"labels":{"type":"object","description":"Attribute group labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute group label for the locale `localeCode`"}}}},"example":{"code":"marketing","sort_order":4,"attributes":["sku","name","description","response_time","release_date","price"],"labels":{"en_US":"Marketing","fr_FR":"Marketing"}}}]},"MediaFile":{"allOf":[{"type":"object","properties":{"_links":{"type":"object","x-read-only":true,"properties":{"download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the binaries of the media file"}}}}}}},{"type":"object","properties":{"code":{"type":"string","description":"Media file code","x-immutable":true},"original_filename":{"type":"string","description":"Original filename of the media file"},"mime_type":{"type":"string","description":"Mime type of the media file","x-read-only":true},"size":{"type":"integer","description":"Size of the media file","x-read-only":true},"extension":{"type":"string","description":"Extension of the media file","x-read-only":true}},"example":{"code":"7/5/8/e/758e39d48ea7b42a55091434fd3d8b6cf3189b7f_10806799_1356.jpg","original_filename":"10806799-1356.jpg","mime_type":"image/jpeg","size":16070,"extension":"jpg"}}],"example":{"_links":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/media-files/7/5/8/e/758e39d48ea7b42a55091434fd3d8b6cf3189b7f_10806799_1356.jpg/download"}},"code":"7/5/8/e/758e39d48ea7b42a55091434fd3d8b6cf3189b7f_10806799_1356.jpg","original_filename":"10806799-1356.jpg","mime_type":"image/jpeg","size":16070,"extension":"jpg"}},"MediaFileList":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI to get the metadata of the media file"}}},"download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the binaries of the media file"}}}}}}},{"type":"object","properties":{"code":{"type":"string","description":"Media file code","x-immutable":true},"original_filename":{"type":"string","description":"Original filename of the media file"},"mime_type":{"type":"string","description":"Mime type of the media file","x-read-only":true},"size":{"type":"integer","description":"Size of the media file","x-read-only":true},"extension":{"type":"string","description":"Extension of the media file","x-read-only":true}},"example":{"code":"7/5/8/e/758e39d48ea7b42a55091434fd3d8b6cf3189b7f_10806799_1356.jpg","original_filename":"10806799-1356.jpg","mime_type":"image/jpeg","size":16070,"extension":"jpg"}}]},"Locale":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Locale code","x-immutable":true},"enabled":{"type":"boolean","description":"Whether the locale is enabled","default":false}},"example":{"code":"en_US","enable":true}},"LocaleList":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Locale code","x-immutable":true},"enabled":{"type":"boolean","description":"Whether the locale is enabled","default":false}},"example":{"code":"en_US","enable":true}}]},"Channel":{"type":"object","required":["code","category_tree","locales","currencies"],"properties":{"code":{"type":"string","description":"Channel code","x-immutable":true},"locales":{"type":"array","description":"Codes of activated locales for the channel","x-validation-rules":"• Each string of the array is an existing locale code • At least one locale in the array","items":{"type":"string"}},"currencies":{"type":"array","description":"Codes of activated currencies for the channel","x-validation-rules":"• Each string of the array is an existing currency code • At least one currency in the array","items":{"type":"string"}},"category_tree":{"type":"string","description":"Code of the category tree linked to the channel","x-validation-rules":"It is the code of an existing category code that is a tree (a category without parent)"},"conversion_units":{"type":"object","description":"Units to which the given metric attributes should be converted when exporting products","x-validation-rules":"• The `attributeCode` is the code of an existing attribute whose type is `pim_catalog_metric` • The strings are existing unit codes.","properties":{"attributeCode":{"type":"string","description":"Conversion unit code used to convert the values of the attribute `attributeCode` when exporting via the channel"}}},"labels":{"type":"object","description":"Channel labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Channel label for the locale `localeCode`"}}}},"example":{"code":"ecommerce","currencies":["USD","EUR"],"locales":["de_DE","en_US","fr_FR"],"category_tree":"master","conversion_units":{"weight":"KILOGRAM"},"labels":{"en_US":"Ecommerce","de_DE":"Ecommerce","fr_FR":"Ecommerce"}}},"ChannelList":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code","category_tree","locales","currencies"],"properties":{"code":{"type":"string","description":"Channel code","x-immutable":true},"locales":{"type":"array","description":"Codes of activated locales for the channel","x-validation-rules":"• Each string of the array is an existing locale code • At least one locale in the array","items":{"type":"string"}},"currencies":{"type":"array","description":"Codes of activated currencies for the channel","x-validation-rules":"• Each string of the array is an existing currency code • At least one currency in the array","items":{"type":"string"}},"category_tree":{"type":"string","description":"Code of the category tree linked to the channel","x-validation-rules":"It is the code of an existing category code that is a tree (a category without parent)"},"conversion_units":{"type":"object","description":"Units to which the given metric attributes should be converted when exporting products","x-validation-rules":"• The `attributeCode` is the code of an existing attribute whose type is `pim_catalog_metric` • The strings are existing unit codes.","properties":{"attributeCode":{"type":"string","description":"Conversion unit code used to convert the values of the attribute `attributeCode` when exporting via the channel"}}},"labels":{"type":"object","description":"Channel labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Channel label for the locale `localeCode`"}}}},"example":{"code":"ecommerce","currencies":["USD","EUR"],"locales":["de_DE","en_US","fr_FR"],"category_tree":"master","conversion_units":{"weight":"KILOGRAM"},"labels":{"en_US":"Ecommerce","de_DE":"Ecommerce","fr_FR":"Ecommerce"}}}]},"AssociationType":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Association type code","x-immutable":true},"labels":{"type":"object","description":"Association type labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Association type label for the locale `localeCode`"}}},"is_quantified":{"type":"boolean","description":"When true, the association is a quantified association (Only available in the PIM Serenity version.)","default":false,"x-immutable":true},"is_two_way":{"type":"boolean","description":"When true, the association is a two-way association (Only available in the PIM Serenity version.)","default":false,"x-immutable":true}},"example":{"code":"upsell","labels":{"en_US":"Upsell","fr_FR":"Vente incitative"},"is_quantified":false,"is_two_way":false}},"AssociationTypeList":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Association type code","x-immutable":true},"labels":{"type":"object","description":"Association type labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Association type label for the locale `localeCode`"}}},"is_quantified":{"type":"boolean","description":"When true, the association is a quantified association (Only available in the PIM Serenity version.)","default":false,"x-immutable":true},"is_two_way":{"type":"boolean","description":"When true, the association is a two-way association (Only available in the PIM Serenity version.)","default":false,"x-immutable":true}},"example":{"code":"upsell","labels":{"en_US":"Upsell","fr_FR":"Vente incitative"},"is_quantified":false,"is_two_way":false}}]},"Currency":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Currency code","x-immutable":true},"enabled":{"type":"boolean","description":"Whether the currency is enabled"},"label":{"type":"string","description":"Currency label"}},"example":{"code":"EUR","enabled":true,"label":"EUR (Euro)"}},"CurrencyList":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Currency code","x-immutable":true},"enabled":{"type":"boolean","description":"Whether the currency is enabled"},"label":{"type":"string","description":"Currency label"}},"example":{"code":"EUR","enabled":true,"label":"EUR (Euro)"}}]},"AssetFamilyList":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Asset family code","x-immutable":true},"labels":{"type":"object","description":"Asset family labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Asset family label for the locale `localeCode`"}}},"attribute_as_main_media":{"type":"string","description":"Attribute code that is used as the main media of the asset family.","x-validation-rules":"It should be the code of an attribute that belongs to this family, and it must be a media file or a media link attribute type.","default":"First media file or media link attribute that was created"},"naming_convention":{"type":"object","description":"The naming convention ran over the asset code or the main media filename upon each asset creation, in order to automatically set several values in asset attributes. To learn more and see the format of this property, take a look at here.","x-validation-rules":"To know more about the validation of this property, take a look at our naming convention format.","default":{},"properties":{"source":{"type":"object","description":"The string on which the naming convention should be applied. More details here."},"pattern":{"type":"string","description":"The regular expression that should be applied on the source. More details here."},"abort_asset_creation_on_error":{"type":"boolean","description":"Whether the asset should be created if the naming convention failed to apply. More details here."}}},"product_link_rules":{"type":"array","description":"The rules that will be run after the asset creation, in order to automatically link the assets of this family to a set of products. To understand the format of this property, see here.","x-validation-rules":"To know more about the validation of this property, take a look at our product link rule format.","default":[],"items":{"type":"object","properties":{"product_selections":{"type":"array","description":"The product selection to which the assets of the asset family to be automatically linked. More details here.","items":{"type":"object","required":["field","operator","value"],"properties":{"field":{"type":"string"},"operator":{"type":"string"},"value":{"type":"string"},"locale":{"type":"string"},"channel":{"type":"string"}}}},"assign_assets_to":{"type":"array","description":"The product value in which your assets will be assigned. More details here.","items":{"type":"object","required":["attribute","mode"],"properties":{"attribute":{"type":"string"},"locale":{"type":"string"},"channel":{"type":"string"},"mode":{"type":"string"}}}}}}},"transformations":{"type":"array","description":"The transformations to perform on source files in order to generate new files into your asset attributes (only available since v4.0). To understand the format of this property, see here.","x-validation-rules":"To know more about the validation of this property, take a look at our transformation format.","x-from-version":"4.0","default":[],"items":{"type":"object","required":["label","target","source","operations"],"properties":{"label":{"type":"string","description":"The name of the transformation"},"filename_suffix":{"type":"string","description":"The suffix that will be appended to the source filename to generate the target filename. More details here."},"filename_prefix":{"type":"string","description":"The prefix that will be prepended to the source filename to generate the target filename. More details here."},"source":{"type":"object","required":["attribute","channel","locale"],"description":"The attribute value in which is stored the media file you want to use as the source file for your transformation. More details here.","properties":{"attribute":{"type":"string"},"channel":{"type":"string"},"locale":{"type":"string"}}},"target":{"type":"object","required":["attribute","channel","locale"],"description":"The attribute value in which the PIM will generate the new transformed file, aka the target file. More details here.","properties":{"attribute":{"type":"string"},"channel":{"type":"string"},"locale":{"type":"string"}}},"operations":{"type":"object","description":"The transformations that should be applied to your source file to generate the target file. More details here.","x-validation-rules":"Should contain at least one operation","properties":{"type":{"type":"string"},"parameters":{"type":"object","properties":{"colorspace":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"},"ratio":{"type":"integer"},"resolution-unit":{"type":"string"},"resolution-x":{"type":"integer"},"resolution-y":{"type":"integer"},"quality":{"type":"integer"}}}}}}}}},"example":{"code":"model_pictures","labels":{"en_US":"Model pictures","fr_FR":"Photographies en pied"},"attribute_as_main_media":"main_image","naming_convention":{"source":{"property":"code","channel":null,"locale":null},"pattern":"/(?P.*)-.*/","abort_asset_creation_on_error":true},"product_link_rules":[{"product_selections":[{"field":"sku","operator":"EQUALS","value":"{{product_ref}}"}],"assign_assets_to":[{"attribute":"model_pictures","mode":"replace"}]}],"transformations":[{"label":"Thumbnail plus black and white transformation","filename_suffix":"_thumbnailBW","source":{"attribute":"main_image","channel":null,"locale":null},"target":{"attribute":"thumbnail","channel":null,"locale":null},"operations":[{"type":"thumbnail","parameters":{"width":150,"height":150}},{"type":"colorspace","parameters":{"colorspace":"grey"}}]}]}}]},"AssetFamilyItemList":{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},"AssetAttributeList":{"type":"array","items":{"type":"object","required":["code","type","media_type"],"properties":{"code":{"type":"string","description":"Attribute code","x-immutable":true},"labels":{"type":"object","description":"Attribute labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute label for the locale `localeCode`"}}},"type":{"type":"string","description":"Attribute type. See type section for more details.","enum":["text","media_link","number","media_file","single_option","multiple_options","boolean","date","record"],"x-immutable":true},"value_per_locale":{"type":"boolean","description":"Whether the attribute is localizable, i.e. can have one value by locale","default":false,"x-immutable":true},"value_per_channel":{"type":"boolean","description":"Whether the attribute is scopable, i.e. can have one value by channel","default":false,"x-immutable":true},"is_required_for_completeness":{"type":"boolean","description":"Whether the attribute should be part of the record's completeness calculation","default":false},"is_read_only":{"type":"boolean","description":"Whether the attribute should be in read only mode only in the UI, but you can still update it with the API","default":false},"max_characters":{"type":"integer","description":"Maximum number of characters allowed for the value of the attribute when the attribute type is `text`","x-warning":"Only for `text` attribute type"},"is_textarea":{"type":"boolean","description":"Whether the UI should display a text area instead of a simple field when the attribute type is `text`","default":false,"x-warning":"Only for `text` attribute type"},"is_rich_text_editor":{"type":"boolean","description":"Whether the UI should display a rich text editor instead of a simple text area when the attribute type is `text`","x-validation-rules":"Required when the property `is_textarea` is equal to `true`","x-warning":"Only for `text` attribute type"},"validation_rule":{"type":"string","description":"Validation rule type used to validate the attribute value when the attribute type is `text`","default":"none","x-warning":"Only for `text` attribute type","enum":["email","url","regexp","none"]},"validation_regexp":{"type":"string","description":"Regexp expression used to validate the attribute value when the attribute type is `text`","default":null,"x-validation-rules":"Required when the property `validation_rule` is equal to `regexp`","x-warning":"Only for `text` attribute type"},"allowed_extensions":{"type":"array","description":"Extensions allowed when the attribute type is `media_file`","default":[],"x-warning":"Only for `media_file` attribute type","items":{"type":"string"}},"max_file_size":{"type":"string","description":"Max file size in MB when the attribute type is `media_file`","default":null,"x-warning":"Only for `media_file` attribute type"},"decimals_allowed":{"type":"boolean","description":"Whether decimals are allowed when the attribute type is `number`","default":false,"x-warning":"Only for `number` attribute type"},"min_value":{"type":"string","description":"Minimum value allowed when the attribute type is `number`","default":null,"x-validation-rules":"The minimum value must be lower than the maximum value","x-warning":"Only for `number` attribute type"},"max_value":{"type":"string","description":"Maximum value allowed when the attribute type is `number`","default":null,"x-validation-rules":"The maximum value must be greater than the minimum value","x-warning":"Only for `number` attribute type"},"media_type":{"type":"string","description":"For the `media_link` attribute type, it is the type of the media behind the url, to allow its preview in the PIM. For the `media_file` attribute type, it is the type of the file.","enum":["image","pdf","youtube","vimeo","other"],"x-warning":"Only required for `media_link` and `media_file` attribute types"},"prefix":{"type":"string","description":"Prefix of the `media_link` attribute type. The common url root that prefixes the link to the media","default":null,"x-warning":"Only for `media_link` attribute type"},"suffix":{"type":"string","description":"Suffix of the `media_link` attribute type. The common url suffix for the media","default":null,"x-warning":"Only for `media_link` attribute type"},"reference_entity":{"type":"string","description":"Reference entity code for the `record` attribute type (see Reference entity).","default":null,"x-warning":"Only for `record` attribute type","x-from-version":"SaaS"}},"example":{"code":"model_is_wearing_size","labels":{"en_US":"Model is wearing size","fr_FR":"Le mannequin porte la taille"},"type":"single_option","value_per_locale":false,"value_per_channel":false,"is_required_for_completeness":true}}},"AssetAttributeOptionList":{"type":"array","items":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Attribute's option code","x-immutable":true},"labels":{"type":"object","description":"Attribute labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute label for the locale `localeCode`"}}}},"example":{"code":"small","labels":{"en_US":"S","fr_FR":"S"}}}},"AssetList":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Code of the asset","x-immutable":true},"values":{"type":"object","description":"Asset attributes values, see the Focus on the asset values section for more details.","x-validation-rules":"Validation rules detailed in Asset attribute values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","description":"Channel code of the asset attribute value"},"locale":{"type":"string","description":"Locale code of the asset attribute value"},"data":{"type":"object","description":"Asset attribute value. See the `data` format section for more details."},"_links":{"type":"object","description":"Related links for the `media file` attribute values. See the `_links` format section for more details.","x-validation-rules":"The share link is returned for the **main** `media file` attribute when asset sharing is enabled"},"linked_data":{"type":"object","description":"Linked data for the `media link` attribute values. See the `linked_data` format section for more details.","x-from-version":"SaaS"}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true,"x-from-version":"6.0"},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true,"x-from-version":"6.0"}},"example":{"code":"sku_54628_picture1","values":{"media_preview":[{"locale":null,"channel":null,"data":"sku_54628_picture1.jpg"}],"model_wears_size":[{"locale":null,"channel":null,"data":"s"}],"photographer":[{"locale":null,"channel":null,"data":"ben_levy"}],"main_colors":[{"locale":null,"channel":null,"data":["red","purple"]}],"end_of_use_date":[{"locale":null,"channel":null,"data":"02/03/2021"}]},"created":"2021-05-31T09:23:34+00:00","updated":"2021-05-31T09:23:34+00:00"}}]},"AssetItemList":{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},"AppCatalogList":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","properties":{"id":{"type":"string","description":"Catalog id","x-immutable":true},"name":{"type":"string","description":"Catalog name"},"enabled":{"type":"boolean","description":"Whether the catalog is enabled or not","default":false},"managed_currencies":{"type":"array","description":"List of currency codes","items":{"type":"string"}},"managed_locales":{"type":"array","description":"List of locale codes","items":{"type":"string"}}},"example":{"_links":{"self":{"href":"http://demo.akeneo.com/api/rest/v1/catalogs/3af8e091-6df5-4ed1-a9aa-090de12e5be5"}},"id":"12351d98-200e-4bbc-aa19-7fdda1bd14f2","name":"My app catalog","enabled":false,"managed_currencies":["EUR","USD","GBP"],"managed_locales":["fr_FR","en_US"]}}]},"Error":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"ErrorByLine":{"type":"object","properties":{"line":{"type":"integer","description":"Line number"},"identifier":{"type":"string","description":"Resource identifier, only filled when the resource is a product"},"code":{"type":"string","description":"Resource code, only filled when the resource is not a product"},"status_code":{"type":"integer","description":"HTTP status code, see Client errors to understand the meaning of each code"},"message":{"type":"string","description":"Message explaining the error"}}},"ErrorByLineProductUuid":{"type":"object","properties":{"line":{"type":"integer","description":"Line number"},"uuid":{"type":"string","description":"Product uuid"},"status_code":{"type":"integer","description":"HTTP status code, see Client errors to understand the meaning of each code"},"message":{"type":"string","description":"Message explaining the error"}}},"ErrorByObject":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Resource code"},"status_code":{"type":"integer","description":"HTTP status code, see Client errors to understand the meaning of each code"},"message":{"type":"string","description":"Message explaining the error"}}}},"Pagination":{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"previous":{"type":"object","properties":{"href":{"type":"string","description":"URI of the previous page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}},"current_page":{"type":"integer","description":"Current page number"}}},"SearchAfterPagination":{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}}}},"ItemList":{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},"MediaFileItemList":{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI to get the metadata of the media file"}}},"download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the binaries of the media file"}}}}}}},"ReferenceEntityItemList":{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}},"image_download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the binaries of the reference entity image file"}}}}}}},"ReferenceEntityRecordItemList":{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},"DeprecatedAsset":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"PAM asset code","x-immutable":true},"categories":{"type":"array","description":"Codes of the PAM asset categories in which the asset is classified","x-validation-rules":"Each string of the array is equal to an existing asset category code","items":{"type":"string"},"default":[]},"description":{"type":"string","description":"Description of the PAM asset","default":null},"localizable":{"type":"boolean","description":"Whether the asset is localized or not, meaning if you want to have different reference files for each of your locale","default":false,"x-immutable":true},"tags":{"type":"array","description":"Tags of the PAM asset","items":{"type":"string"},"default":[]},"end_of_use":{"type":"string","description":"Date on which the PAM asset expire","format":"dateTime","default":null,"x-validation-rules":"The date follows the ISO 8601 format"},"variation_files":{"type":"array","description":"Variations of the PAM asset","x-read-only":true,"items":{"type":"object","properties":{"_link":{"type":"object","description":"Links to get and download the variation file","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the variation entity"}}},"download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the variation file"}}}}},"locale":{"type":"string","description":"Locale code of the variation"},"scope":{"type":"string","description":"Channel code of the variation"},"code":{"type":"string","description":"Code of the variation"}}}},"reference_files":{"type":"array","description":"Reference files of the PAM asset","x-read-only":true,"items":{"type":"object","properties":{"_link":{"type":"object","description":"Links to get and download the reference file","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the reference file entity"}}},"download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the reference file"}}}}},"locale":{"type":"string","description":"Locale code of the reference file"},"code":{"type":"string","description":"Code of the reference file"}}}}},"example":{"code":"tshirt_artemis_main_picture","categories":["tshirts_assets"],"description":"The main picture of the Artemis t-shirt","localizable":false,"tags":["tshirts","red","summer"],"end_of_use":"2019-09-01T00:00:00+0200","variation_files":[{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/ecommerce/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/ecommerce/no_locale"}},"locale":null,"scope":"e_commerce","code":"7/5/8/e/758e39d48va7b42a55001434fd3d7b6cf3189b7f_tshirt_artemis_main_picture_ecommerce.jpg"},{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/print/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/print/no_locale"}},"locale":null,"scope":"print","code":"7/5/8/e/759e39d48va7b42a55002434fd3d7b6cf3189b7f_tshirt_artemis_main_picture_print.jpg"}],"reference_files":[{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/reference-files/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/reference-files/no_locale"}},"locale":null,"code":"7/5/8/e/759e39d48va7b42a55002434fd3d7b6cf3189b7f_tshirt_artemis_main_picture.jpg"}]}},"DeprecatedAssetList":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"PAM asset code","x-immutable":true},"categories":{"type":"array","description":"Codes of the PAM asset categories in which the asset is classified","x-validation-rules":"Each string of the array is equal to an existing asset category code","items":{"type":"string"},"default":[]},"description":{"type":"string","description":"Description of the PAM asset","default":null},"localizable":{"type":"boolean","description":"Whether the asset is localized or not, meaning if you want to have different reference files for each of your locale","default":false,"x-immutable":true},"tags":{"type":"array","description":"Tags of the PAM asset","items":{"type":"string"},"default":[]},"end_of_use":{"type":"string","description":"Date on which the PAM asset expire","format":"dateTime","default":null,"x-validation-rules":"The date follows the ISO 8601 format"},"variation_files":{"type":"array","description":"Variations of the PAM asset","x-read-only":true,"items":{"type":"object","properties":{"_link":{"type":"object","description":"Links to get and download the variation file","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the variation entity"}}},"download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the variation file"}}}}},"locale":{"type":"string","description":"Locale code of the variation"},"scope":{"type":"string","description":"Channel code of the variation"},"code":{"type":"string","description":"Code of the variation"}}}},"reference_files":{"type":"array","description":"Reference files of the PAM asset","x-read-only":true,"items":{"type":"object","properties":{"_link":{"type":"object","description":"Links to get and download the reference file","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the reference file entity"}}},"download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the reference file"}}}}},"locale":{"type":"string","description":"Locale code of the reference file"},"code":{"type":"string","description":"Code of the reference file"}}}}},"example":{"code":"tshirt_artemis_main_picture","categories":["tshirts_assets"],"description":"The main picture of the Artemis t-shirt","localizable":false,"tags":["tshirts","red","summer"],"end_of_use":"2019-09-01T00:00:00+0200","variation_files":[{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/ecommerce/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/ecommerce/no_locale"}},"locale":null,"scope":"e_commerce","code":"7/5/8/e/758e39d48va7b42a55001434fd3d7b6cf3189b7f_tshirt_artemis_main_picture_ecommerce.jpg"},{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/print/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/print/no_locale"}},"locale":null,"scope":"print","code":"7/5/8/e/759e39d48va7b42a55002434fd3d7b6cf3189b7f_tshirt_artemis_main_picture_print.jpg"}],"reference_files":[{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/reference-files/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/reference-files/no_locale"}},"locale":null,"code":"7/5/8/e/759e39d48va7b42a55002434fd3d7b6cf3189b7f_tshirt_artemis_main_picture.jpg"}]}}]},"DeprecatedAssetReferenceFile":{"type":"object","properties":{"code":{"type":"string","description":"Code of the PAM asset reference file","x-immutable":true},"locale":{"type":"string","description":"Locale of the PAM asset reference file, equal to `null` if the asset is not localizable"},"_link":{"type":"object","description":"Links to get and download the reference file","properties":{"download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the reference file"}}}}}},"example":{"code":"7/5/8/e/759e39d48va7b42a55002434fd3d7b6cf3189b7f_tshirt_artemis_main_picture.jpg","locale":null,"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/reference-files/no_locale/download"}}}},"DeprecatedAssetVariationFile":{"type":"object","properties":{"code":{"type":"string","description":"Code of the PAM asset variation file","x-immutable":true},"locale":{"type":"string","description":"Locale of the PAM asset variation file, equal to `null` if the asset is not localizable"},"scope":{"type":"string","description":"Channel of the PAM asset variation file"},"_link":{"type":"object","description":"Links to get and download the reference file","properties":{"download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the variation file"}}}}}},"example":{"code":"7/5/8/e/758e39d48va7b42a55001434fd3d7b6cf3189b7f_tshirt_artemis_main_picture_ecommerce.jpg","locale":null,"scope":"ecommerce","_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/ecommerce/no_locale/download"}}}},"DeprecatedAssetCategory":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"PAM asset category code","x-immutable":true},"parent":{"type":"string","description":"PAM ssset category code of the parent's asset category","x-validation-rules":"• It is either equal to `null` or to an existing asset category code. • If equal to an existing asset category code, it cannot reference itself.","default":"null"},"labels":{"type":"object","description":"PAM asset category labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"PAM asset category label for the locale `localeCode`"}}}},"example":{"code":"front_views","parent":"pictures","labels":{"en_US":"Front views","fr_FR":"Vues de face"}}},"DeprecatedAssetCategoryList":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"PAM asset category code","x-immutable":true},"parent":{"type":"string","description":"PAM ssset category code of the parent's asset category","x-validation-rules":"• It is either equal to `null` or to an existing asset category code. • If equal to an existing asset category code, it cannot reference itself.","default":"null"},"labels":{"type":"object","description":"PAM asset category labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"PAM asset category label for the locale `localeCode`"}}}},"example":{"code":"front_views","parent":"pictures","labels":{"en_US":"Front views","fr_FR":"Vues de face"}}}]},"DeprecatedAssetTag":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"PAM asset tag code","x-immutable":true}},"example":{"code":"tshirt"}},"DeprecatedAssetTagList":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"PAM asset tag code","x-immutable":true}},"example":{"code":"tshirt"}}]},"DeprecatedAssetReferenceFileUploadWarning":{"type":"object","properties":{"message":{"type":"string","description":"Message explaining the warning"},"errors":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","description":"Channel for which the variation file generation failed"},"locale":{"type":"string","description":"Locale for which the variation file generation failed"},"message":{"type":"string","description":"Message explaining why the variation file generation failed"}}}}}}},"responses":{"Created":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"ReferenceEntityMediaFileUploaded":{"description":"Created","x-details":"Means that the media file creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"},"Reference-entities-media-file-code":{"description":"Code of the media file","type":"string"}}},"AssetMediaFileUploaded":{"description":"Created","x-details":"Means that the media file creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"},"Asset-media-file-code":{"description":"Code of the media file","type":"string"}}},"Submitted":{"description":"Submitted","x-details":"Means that the draft submission was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"NoContent":{"description":"No content to return","x-details":"Means that the update was successful","headers":{"Location":{"description":"URI of the updated resource","type":"string"}}},"400Error":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401Error":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403Error":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404Error":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406Error":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}},"413Error":{"description":"Request Entity Too Large","x-details":"There are too many resources to process (max 100) or the line of JSON is too long (max 1 000 000 characters)","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":413,"message":"Too many resources to process, 100 is the maximum allowed."}},"415Error":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"415ErrorStream":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/vnd.akeneo.collection+json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/vnd.akeneo.collection+json’ is allowed."}},"415ErrorMultipart":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `multipart/form-data`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘multipart/form-data’ is allowed."}},"422Error":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}},"429Error":{"description":"Too many requests","x-details":"There are too many requests on this endpoint","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":429,"message":"You have exceeded the limit of API requests per second."}},"DeprecatedAssetReferenceFileUploaded":{"description":"Uploaded","x-details":"Means that the reference file upload was successful. Beware that even if the reference file upload is complete, some variation files generations could have failed. If so, you will see a warning message in the response body.","headers":{"Location":{"description":"URI of the created resource","type":"string"}},"x-no-entity":true,"schema":{"type":"object","properties":{"message":{"type":"string","description":"Message explaining the warning"},"errors":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","description":"Channel for which the variation file generation failed"},"locale":{"type":"string","description":"Locale for which the variation file generation failed"},"message":{"type":"string","description":"Message explaining why the variation file generation failed"}}}}}}},"403CatalogError":{"description":"Access forbidden","x-details":"The app does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list catalogs."}},"404CatalogError":{"description":"Catalog not found","x-details":"The catalog id given in the URI does not exist","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Catalog \"65f5a521-e65c-4d7b-8be8-1f267fa2729c\" does not exist or you can't access it."}}},"parameters":{"pagination_type":{"name":"pagination_type","in":"query","description":"Pagination method type, see Pagination section","required":false,"type":"string","default":"page","x-validation-rules":"One of the following values","enum":["page","search_after"]},"page":{"name":"page","in":"query","description":"Number of the page to retrieve when using the `page` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"integer","default":1},"search_after":{"name":"search_after","in":"query","description":"Cursor when using the `search_after` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"string","default":"cursor to the first page"},"limit":{"name":"limit","in":"query","description":"Number of results by page, see Pagination section","required":false,"type":"integer","minimum":1,"maximum":100,"default":10},"code":{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"},"file_path":{"name":"file_path","in":"path","description":"Path of the resource","required":true,"type":"string"},"uuid":{"name":"uuid","in":"path","description":"Uuid of the resource","required":true,"type":"string"},"reference_entity_code":{"name":"reference_entity_code","in":"path","description":"Code of the reference entity","required":true,"type":"string"},"asset_family_code":{"name":"asset_family_code","in":"path","description":"Code of the asset family","required":true,"type":"string"},"attribute_code":{"name":"attribute_code","in":"path","description":"Code of the attribute","required":true,"type":"string"},"asset_code":{"name":"asset_code","in":"path","description":"Code of the asset","required":true,"type":"string"},"channel_code":{"name":"channel_code","in":"path","description":"Code of the channel","required":true,"type":"string"},"locale_code":{"name":"locale_code","in":"path","description":"Code of the locale if the asset is localizable or equal to `no-locale` if the asset is not localizable","required":true,"type":"string"},"family_code":{"name":"family_code","in":"path","description":"Code of the family","required":true,"type":"string"},"with_count":{"name":"with_count","in":"query","description":"Return the count of items in the response. Be carefull with that, on a big catalog, it can decrease performance in a significative way","default":false,"type":"boolean","required":false},"with_count_for_catalogs":{"name":"with_count","in":"query","description":"Return the count of items in the response.","default":false,"type":"boolean","required":false},"with_attribute_options":{"name":"with_attribute_options","in":"query","description":"Return labels of attribute options in the response. See the `linked_data` format section for more details. (Only available since the 5.0 version)","default":false,"type":"boolean","required":false,"x-from-version":"5.0"},"with_attribute_options__product_models":{"name":"with_attribute_options","in":"query","description":"Return labels of attribute options in the response. (Only available on SaaS platforms)","default":false,"type":"boolean","required":false,"x-from-version":"SaaS"},"with_table_select_options":{"name":"with_table_select_options","in":"query","description":"Return the options of 'select' column types (of a table attribute) in the response. (Only available since the 7.0 version)","default":false,"type":"boolean","required":false,"x-from-version":"7.0"},"with_asset_share_links":{"name":"with_asset_share_links","in":"query","description":"Return asset collection share link urls in the response. See the `linked_data` format section for more details. (Only available in the SaaS version)","default":false,"type":"boolean","required":false,"x-from-version":"SaaS"},"with_quality_scores__products":{"name":"with_quality_scores","in":"query","description":"Return product quality scores in the response. (Only available since the 5.0 version)","default":false,"type":"boolean","required":false,"x-from-version":"5.0"},"with_quality_scores__product_models":{"name":"with_quality_scores","in":"query","description":"Return product model quality scores in the response. (Only available since the 6.0 version)","type":"boolean","required":false,"x-from-version":"6.0"},"with_completenesses":{"name":"with_completenesses","in":"query","description":"Return product completenesses in the response. (Only available since the 6.0 version)","default":false,"type":"boolean","required":false,"x-from-version":"6.0"},"with_position":{"name":"with_position","in":"query","description":"Return information about category position into its category tree (only available since the 7.0 version)","required":false,"type":"boolean","x-from-version":"7.0"},"updated_before":{"name":"updated_before","in":"query","description":"Filter products that have been updated BEFORE the provided date (Only available on Catalogs endpoints). This filter uses the PIM products updated date.","type":"string","format":"date","required":false,"x-from-version":"SaaS"},"updated_after":{"name":"updated_after","in":"query","description":"Filter products that have been updated AFTER the provided date (Only available on Catalogs endpoints). This filter uses the PIM products updated date.","type":"string","format":"date","required":false,"x-from-version":"SaaS"},"with_enriched_attributes":{"name":"with_enriched_attributes","in":"query","description":"Return attribute values of the category (only available on SaaS platforms)","required":false,"type":"boolean","x-from-version":"SaaS"}}} \ No newline at end of file +{"swagger":"2.0","info":{"title":"Akeneo PIM REST API","version":"1.0.0"},"host":"demo.akeneo.com","schemes":["http"],"produces":["application/json"],"paths":{"/api/rest/v1/products-uuid":{"get":{"summary":"Get list of products","operationId":"get_products_uuid","tags":["Product [uuid]"],"x-versions":["7.0","SaaS"],"description":"This endpoint allows you to get a list of products. Products are paginated and they can be filtered. In the Enterprise Edition, permissions based on your user groups are applied to the set of products you request.","parameters":[{"name":"search","in":"query","description":"Filter products, for more details see the Filters section","required":false,"type":"string"},{"name":"scope","in":"query","type":"string","description":"Filter product values to return scopable attributes for the given channel as well as the non localizable/non scopable attributes, for more details see the Filter product values via channel section","required":false},{"name":"locales","in":"query","type":"string","description":"Filter product values to return localizable attributes for the given locales as well as the non localizable/non scopable attributes, for more details see the Filter product values via locale section","required":false},{"name":"attributes","in":"query","type":"string","description":"Filter product values to only return those concerning the given attributes, for more details see the Filter on product values section","required":false},{"name":"pagination_type","in":"query","description":"Pagination method type, see Pagination section","required":false,"type":"string","default":"page","x-validation-rules":"One of the following values","enum":["page","search_after"]},{"name":"page","in":"query","description":"Number of the page to retrieve when using the `page` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"integer","default":1},{"name":"search_after","in":"query","description":"Cursor when using the `search_after` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"string","default":"cursor to the first page"},{"name":"limit","in":"query","description":"Number of results by page, see Pagination section","required":false,"type":"integer","minimum":1,"maximum":100,"default":10},{"name":"with_count","in":"query","description":"Return the count of items in the response. Be carefull with that, on a big catalog, it can decrease performance in a significative way","default":false,"type":"boolean","required":false},{"name":"with_attribute_options","in":"query","description":"Return labels of attribute options in the response. See the `linked_data` format section for more details. (Only available since the 5.0 version)","default":false,"type":"boolean","required":false,"x-from-version":"5.0"},{"name":"with_asset_share_links","in":"query","description":"Return asset collection share link urls in the response. See the `linked_data` format section for more details. (Only available in the SaaS version)","default":false,"type":"boolean","required":false,"x-from-version":"SaaS"},{"name":"with_quality_scores","in":"query","description":"Return product quality scores in the response. (Only available since the 5.0 version)","default":false,"type":"boolean","required":false,"x-from-version":"5.0"},{"name":"with_completenesses","in":"query","description":"Return product completenesses in the response. (Only available since the 6.0 version)","default":false,"type":"boolean","required":false,"x-from-version":"6.0"}],"responses":{"200":{"description":"Return products paginated","schema":{"title":"Products","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"previous":{"type":"object","properties":{"href":{"type":"string","description":"URI of the previous page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}},"current_page":{"type":"integer","description":"Current page number"}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","properties":{"uuid":{"type":"string","description":"Product uuid"},"enabled":{"type":"boolean","description":"Whether the product is enabled","default":true},"family":{"type":"string","description":"Family code from which the product inherits its attributes and attributes requirements.","x-validation-rules":"It is equal to an existing family code. In the case of variant product, the given family should be the same as the product model family.","default":"null only in the case of a non variant product"},"categories":{"type":"array","description":"Codes of the categories in which the product is classified","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"groups":{"type":"array","description":"Codes of the groups to which the product belong","x-validation-rules":"Each string of the array is equal to an existing group code","items":{"type":"string"},"default":[]},"parent":{"type":"string","description":"Code of the parent product model when the product is a variant (only available since the 2.0). This parent can be modified since the 2.3.","x-validation-rules":"It is equal to an existing product model code only if the product is variant otherwise it's equal to null","default":"null","x-from-version":"2.0"},"values":{"type":"object","description":"Product attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value. See the `data` format section for more details."},"linked_data":{"type":"object","x-read-only":true,"description":"Object containing additional data when a related query parameter is enabled. See the `linked_data` format section for more details. (only available since the 5.0)","x-from-version":"5.0","properties":{"attribute":{"type":"string"},"code":{"type":"string"},"labels":{"type":"object"}}},"attribute_type":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"The type of the value's attribute. See type section for more details."},"reference_data_name":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"Reference entity code when the attribute type is `akeneo_reference_entity` or `akeneo_reference_entity_collection` OR Asset family code when the attribute type is `pim_catalog_asset_collection`","x-warning":"Only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types"}}}}}},"associations":{"type":"object","description":"Several associations related to groups, product models and/or other products, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the uuid of an existing product. • Each string in the array of the property `product_models` is the code of an existing product model.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of product uuids with which the product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Several quantified associations related to products and/or product models, grouped by quantified association types (only available since the 5.0)","x-validation-rules":"• The `quantifiedAssociationTypeCode` is the code of an existing association type which provides quantity information. • Each object in the array of the property `products` contains the uuid of an existing product and the quantity of it.","x-from-version":"5.0","properties":{"quantifiedAssociationTypeCode":{"type":"object","properties":{"products":{"type":"array","description":"Array of objects containing product uuids and quantities with which the product is in relation","items":{"type":"object","properties":{"uuid":{"type":"string"},"quantity":{"type":"integer"}}}},"product_models":{"type":"array","description":"Array of objects containing product model codes and quantities with which the product is in relation","items":{"type":"object","properties":{"code":{"type":"string"},"quantity":{"type":"integer"}}}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"metadata":{"type":"object","description":"More information around the product (only available since the v2.0 in the Enterprise Edition)","x-immutable":true,"x-read-only":true,"x-from-version":"2.0","properties":{"workflow_status":{"description":"Status of the product regarding the user permissions","type":"string","enum":["read_only","draft_in_progress","proposal_waiting_for_approval","working_copy"]}}},"quality_scores":{"type":"object","description":"Product quality scores for each channel/locale combination (only available since the 5.0 and when the \"with_quality_scores\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"5.0"},"completenesses":{"type":"array","description":"Product completenesses for each channel/locale combination (only available since the 7.0 version, and when the \"with_completenesses\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"7.0","items":{"type":"object","properties":{"scope":{"type":"string"},"locale":{"type":"string"},"data":{"type":"integer"}}}}},"example":{"uuid":"25566245-55c3-42ce-86d9-8610ac459fa8","enabled":true,"family":"tshirt","categories":["summer_collection"],"groups":[],"parent":null,"values":{"sku":[{"data":"top","locale":null,"scope":null}],"name":[{"data":"Top","locale":"en_US","scope":null},{"data":"Débardeur","locale":"fr_FR","scope":null}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce"},{"data":"Top","locale":"en_US","scope":"tablet"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}}}],"size":[{"locale":null,"scope":null,"data":"m","linked_data":{"attribute":"size","code":"m","labels":{"en_US":"M","fr_FR":"M"}}}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"],"linked_data":{"winter_2016":{"attribute":"collection","code":"winter_2016","labels":{"en_US":"Winter 2016","fr_FR":"Hiver 2016"}}}}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["d055527c-0698-4967-8f16-8a5f23f4e5cf"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"uuid":"fc24e6c3-933c-4a93-8a81-e5c703d134d5","quantity":2},{"uuid":"a9b69002-a0b1-4ead-85c2-f8dbf59c6cfc","quantity":1}],"product_models":[{"identifier":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"completenesses":[{"scope":"ecommerce","locale":"en_US","data":10},{"scope":"ecommerce","locale":"fr_FR","data":20},{"scope":"tablet","locale":"en_US","data":30},{"scope":"tablet","locale":"fr_FR","data":40}]}}]}}}}}}]},"x-examples-per-version":[{"x-version":"SaaS","x-example":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/products-uuid?page=3&limit=3&with_quality_scores=true&with_completenesses=true&with_attribute_options=true"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/products-uuid?page=1&limit=3&with_quality_scores=true&with_completenesses=true&with_attribute_options=true"},"previous":{"href":"https://demo.akeneo.com/api/rest/v1/products-uuid?page=2&limit=3&with_quality_scores=true&with_completenesses=true&with_attribute_options=true"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/products-uuid?page=4&limit=3&with_quality_scores=true&with_completenesses=true&with_attribute_options=true"}},"current_page":3,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product-uuid/25566245-55c3-42ce-86d9-8610ac459fa8"}},"uuid":"25566245-55c3-42ce-86d9-8610ac459fa8","family":"tshirt","groups":[],"parent":null,"categories":["summer_collection"],"enabled":true,"values":{"sku":[{"data":"top","locale":null,"scope":null,"attribute_type":"pim_catalog_identifier"}],"name":[{"data":"Top","locale":"en_US","scope":null,"attribute_type":"pim_catalog_text"},{"data":"Débardeur","locale":"fr_FR","scope":null,"attribute_type":"pim_catalog_text"}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce","attribute_type":"pim_catalog_textarea"},{"data":"Top","locale":"en_US","scope":"tablet","attribute_type":"pim_catalog_textarea"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce","attribute_type":"pim_catalog_textarea"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet","attribute_type":"pim_catalog_textarea"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}],"attribute_type":"pim_catalog_price_collection"}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}},"attribute_type":"pim_catalog_simpleselect"}],"size":[{"locale":null,"scope":null,"data":"m","linked_data":{"attribute":"size","code":"m","labels":{"en_US":"M","fr_FR":"M"}},"attribute_type":"pim_catalog_simpleselect"}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"],"linked_data":{"winter_2016":{"attribute":"collection","code":"winter_2016","labels":{"en_US":"Winter 2016","fr_FR":"Hiver 2016"}}},"attribute_type":"pim_catalog_multiselect"}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["d055527c-0698-4967-8f16-8a5f23f4e5cf"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"uuid":"fc24e6c3-933c-4a93-8a81-e5c703d134d5","quantity":2},{"uuid":"a9b69002-a0b1-4ead-85c2-f8dbf59c6cfc","quantity":1}],"product_models":[{"identifier":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"completenesses":[{"scope":"ecommerce","locale":"en_US","data":20},{"scope":"ecommerce","locale":"fr_FR","data":30},{"scope":"tablet","locale":"en_US","data":55},{"scope":"tablet","locale":"fr_FR","data":70}]},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/fc24e6c3-933c-4a93-8a81-e5c703d134d5"}},"uuid":"fc24e6c3-933c-4a93-8a81-e5c703d134d5","family":"caps","groups":[],"parent":null,"categories":["summer_collection"],"enabled":true,"values":{"sku":[{"data":"cap","locale":null,"scope":null}],"name":[{"data":"Cap","locale":"en_US","scope":null},{"data":"Casquette","locale":"fr_FR","scope":null}],"description":[{"data":"Cap unisex","locale":"en_US","scope":"ecommerce"},{"data":"Cap unisex","locale":"en_US","scope":"tablet"},{"data":"Casquette unisexe","locale":"fr_FR","scope":"ecommerce"},{"data":"Casquette unisexe","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"20","currency":"EUR"},{"amount":"20","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}}}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["d055527c-0698-4967-8f16-8a5f23f4e5cf"],"product_models":[],"groups":[]}},"quantified_associations":{},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"completenesses":[{"scope":"ecommerce","locale":"en_US","data":20},{"scope":"ecommerce","locale":"fr_FR","data":30},{"scope":"tablet","locale":"en_US","data":55},{"scope":"tablet","locale":"fr_FR","data":70}]},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product-uuid/fa0b115e-46ec-4527-beab-7207452f1b47"}},"uuid":"fa0b115e-46ec-4527-beab-7207452f1b47","family":null,"groups":[],"parent":null,"categories":["winter_collection"],"enabled":true,"values":{"sku":[{"data":"sweat","locale":null,"scope":null}]},"created":"2016-06-23T11:24:44+02:00","updated":"2016-06-23T11:24:44+02:00","associations":{},"quantified_associations":{},"quality_scores":{},"completenesses":[]}]}}}]},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}},"post":{"summary":"Create a new product","operationId":"post_products_uuid","tags":["Product [uuid]"],"x-versions":["7.0","SaaS"],"description":"This endpoint allows you to create a new product. In the Enterprise Edition, permissions based on your user groups are applied to the product you try to create. If no uuid is provided, the PIM will generate one for you.","parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"uuid":{"type":"string","description":"Product uuid"},"enabled":{"type":"boolean","description":"Whether the product is enabled","default":true},"family":{"type":"string","description":"Family code from which the product inherits its attributes and attributes requirements.","x-validation-rules":"It is equal to an existing family code. In the case of variant product, the given family should be the same as the product model family.","default":"null only in the case of a non variant product"},"categories":{"type":"array","description":"Codes of the categories in which the product is classified","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"groups":{"type":"array","description":"Codes of the groups to which the product belong","x-validation-rules":"Each string of the array is equal to an existing group code","items":{"type":"string"},"default":[]},"parent":{"type":"string","description":"Code of the parent product model when the product is a variant (only available since the 2.0). This parent can be modified since the 2.3.","x-validation-rules":"It is equal to an existing product model code only if the product is variant otherwise it's equal to null","default":"null","x-from-version":"2.0"},"values":{"type":"object","description":"Product attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value. See the `data` format section for more details."},"linked_data":{"type":"object","x-read-only":true,"description":"Object containing additional data when a related query parameter is enabled. See the `linked_data` format section for more details. (only available since the 5.0)","x-from-version":"5.0","properties":{"attribute":{"type":"string"},"code":{"type":"string"},"labels":{"type":"object"}}},"attribute_type":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"The type of the value's attribute. See type section for more details."},"reference_data_name":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"Reference entity code when the attribute type is `akeneo_reference_entity` or `akeneo_reference_entity_collection` OR Asset family code when the attribute type is `pim_catalog_asset_collection`","x-warning":"Only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types"}}}}}},"associations":{"type":"object","description":"Several associations related to groups, product models and/or other products, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the uuid of an existing product. • Each string in the array of the property `product_models` is the code of an existing product model.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of product uuids with which the product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Several quantified associations related to products and/or product models, grouped by quantified association types (only available since the 5.0)","x-validation-rules":"• The `quantifiedAssociationTypeCode` is the code of an existing association type which provides quantity information. • Each object in the array of the property `products` contains the uuid of an existing product and the quantity of it.","x-from-version":"5.0","properties":{"quantifiedAssociationTypeCode":{"type":"object","properties":{"products":{"type":"array","description":"Array of objects containing product uuids and quantities with which the product is in relation","items":{"type":"object","properties":{"uuid":{"type":"string"},"quantity":{"type":"integer"}}}},"product_models":{"type":"array","description":"Array of objects containing product model codes and quantities with which the product is in relation","items":{"type":"object","properties":{"code":{"type":"string"},"quantity":{"type":"integer"}}}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"metadata":{"type":"object","description":"More information around the product (only available since the v2.0 in the Enterprise Edition)","x-immutable":true,"x-read-only":true,"x-from-version":"2.0","properties":{"workflow_status":{"description":"Status of the product regarding the user permissions","type":"string","enum":["read_only","draft_in_progress","proposal_waiting_for_approval","working_copy"]}}},"quality_scores":{"type":"object","description":"Product quality scores for each channel/locale combination (only available since the 5.0 and when the \"with_quality_scores\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"5.0"},"completenesses":{"type":"array","description":"Product completenesses for each channel/locale combination (only available since the 7.0 version, and when the \"with_completenesses\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"7.0","items":{"type":"object","properties":{"scope":{"type":"string"},"locale":{"type":"string"},"data":{"type":"integer"}}}}},"example":{"uuid":"25566245-55c3-42ce-86d9-8610ac459fa8","enabled":true,"family":"tshirt","categories":["summer_collection"],"groups":[],"parent":null,"values":{"sku":[{"data":"top","locale":null,"scope":null}],"name":[{"data":"Top","locale":"en_US","scope":null},{"data":"Débardeur","locale":"fr_FR","scope":null}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce"},{"data":"Top","locale":"en_US","scope":"tablet"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}}}],"size":[{"locale":null,"scope":null,"data":"m","linked_data":{"attribute":"size","code":"m","labels":{"en_US":"M","fr_FR":"M"}}}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"],"linked_data":{"winter_2016":{"attribute":"collection","code":"winter_2016","labels":{"en_US":"Winter 2016","fr_FR":"Hiver 2016"}}}}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["d055527c-0698-4967-8f16-8a5f23f4e5cf"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"uuid":"fc24e6c3-933c-4a93-8a81-e5c703d134d5","quantity":2},{"uuid":"a9b69002-a0b1-4ead-85c2-f8dbf59c6cfc","quantity":1}],"product_models":[{"identifier":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"completenesses":[{"scope":"ecommerce","locale":"en_US","data":10},{"scope":"ecommerce","locale":"fr_FR","data":20},{"scope":"tablet","locale":"en_US","data":30},{"scope":"tablet","locale":"fr_FR","data":40}]}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}},"patch":{"summary":"Update/create several products","operationId":"patch_products_uuid","tags":["Product [uuid]"],"x-versions":["7.0","SaaS"],"description":"This endpoint allows you to update and/or create several products at once. Learn more about Update behavior. Note that if no product exists for the given uuid, it creates it. In the Enterprise Edition, permissions based on your user groups are applied to the products you try to update. It may result in the creation of drafts if you only have edit rights through the product's categories.","x-body-by-line":"Contains several lines, each line is a product in JSON standard format","parameters":[{"name":"body","in":"body","schema":{"required":["uuid"],"x-examples":{"x-example-1":"{\"uuid\":\"fc24e6c3-933c-4a93-8a81-e5c703d134d5\",\"values\":{\"description\":[{\"scope\":\"ecommerce\",\"locale\":\"en_US\",\"data\":\"My amazing cap\"}]}}","x-example-2":"{\"uuid\":\"573dd613-0c7f-4143-83d5-63cc5e535966\",\"values\":{\"sku\":[{\"data\":\"updated_sku\",\"locale\":null,\"scope\":null}]}, \"group\":[\"promotion\"]}","x-example-3":"{\"uuid\":\"25566245-55c3-42ce-86d9-8610ac459fa8\",\"values\":{\"sku\":[{\"data\":\"new_product\",\"locale\":null,\"scope\":null}]},\"family\":\"clothes\"}"},"type":"object","properties":{"uuid":{"type":"string","description":"Product uuid"},"enabled":{"type":"boolean","description":"Whether the product is enabled","default":true},"family":{"type":"string","description":"Family code from which the product inherits its attributes and attributes requirements.","x-validation-rules":"It is equal to an existing family code. In the case of variant product, the given family should be the same as the product model family.","default":"null only in the case of a non variant product"},"categories":{"type":"array","description":"Codes of the categories in which the product is classified","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"groups":{"type":"array","description":"Codes of the groups to which the product belong","x-validation-rules":"Each string of the array is equal to an existing group code","items":{"type":"string"},"default":[]},"parent":{"type":"string","description":"Code of the parent product model when the product is a variant (only available since the 2.0). This parent can be modified since the 2.3.","x-validation-rules":"It is equal to an existing product model code only if the product is variant otherwise it's equal to null","default":"null","x-from-version":"2.0"},"values":{"type":"object","description":"Product attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value. See the `data` format section for more details."},"linked_data":{"type":"object","x-read-only":true,"description":"Object containing additional data when a related query parameter is enabled. See the `linked_data` format section for more details. (only available since the 5.0)","x-from-version":"5.0","properties":{"attribute":{"type":"string"},"code":{"type":"string"},"labels":{"type":"object"}}},"attribute_type":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"The type of the value's attribute. See type section for more details."},"reference_data_name":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"Reference entity code when the attribute type is `akeneo_reference_entity` or `akeneo_reference_entity_collection` OR Asset family code when the attribute type is `pim_catalog_asset_collection`","x-warning":"Only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types"}}}}}},"associations":{"type":"object","description":"Several associations related to groups, product models and/or other products, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the uuid of an existing product. • Each string in the array of the property `product_models` is the code of an existing product model.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of product uuids with which the product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Several quantified associations related to products and/or product models, grouped by quantified association types (only available since the 5.0)","x-validation-rules":"• The `quantifiedAssociationTypeCode` is the code of an existing association type which provides quantity information. • Each object in the array of the property `products` contains the uuid of an existing product and the quantity of it.","x-from-version":"5.0","properties":{"quantifiedAssociationTypeCode":{"type":"object","properties":{"products":{"type":"array","description":"Array of objects containing product uuids and quantities with which the product is in relation","items":{"type":"object","properties":{"uuid":{"type":"string"},"quantity":{"type":"integer"}}}},"product_models":{"type":"array","description":"Array of objects containing product model codes and quantities with which the product is in relation","items":{"type":"object","properties":{"code":{"type":"string"},"quantity":{"type":"integer"}}}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"metadata":{"type":"object","description":"More information around the product (only available since the v2.0 in the Enterprise Edition)","x-immutable":true,"x-read-only":true,"x-from-version":"2.0","properties":{"workflow_status":{"description":"Status of the product regarding the user permissions","type":"string","enum":["read_only","draft_in_progress","proposal_waiting_for_approval","working_copy"]}}},"quality_scores":{"type":"object","description":"Product quality scores for each channel/locale combination (only available since the 5.0 and when the \"with_quality_scores\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"5.0"},"completenesses":{"type":"array","description":"Product completenesses for each channel/locale combination (only available since the 7.0 version, and when the \"with_completenesses\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"7.0","items":{"type":"object","properties":{"scope":{"type":"string"},"locale":{"type":"string"},"data":{"type":"integer"}}}}},"example":{"uuid":"25566245-55c3-42ce-86d9-8610ac459fa8","enabled":true,"family":"tshirt","categories":["summer_collection"],"groups":[],"parent":null,"values":{"sku":[{"data":"top","locale":null,"scope":null}],"name":[{"data":"Top","locale":"en_US","scope":null},{"data":"Débardeur","locale":"fr_FR","scope":null}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce"},{"data":"Top","locale":"en_US","scope":"tablet"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}}}],"size":[{"locale":null,"scope":null,"data":"m","linked_data":{"attribute":"size","code":"m","labels":{"en_US":"M","fr_FR":"M"}}}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"],"linked_data":{"winter_2016":{"attribute":"collection","code":"winter_2016","labels":{"en_US":"Winter 2016","fr_FR":"Hiver 2016"}}}}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["d055527c-0698-4967-8f16-8a5f23f4e5cf"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"uuid":"fc24e6c3-933c-4a93-8a81-e5c703d134d5","quantity":2},{"uuid":"a9b69002-a0b1-4ead-85c2-f8dbf59c6cfc","quantity":1}],"product_models":[{"identifier":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"completenesses":[{"scope":"ecommerce","locale":"en_US","data":10},{"scope":"ecommerce","locale":"fr_FR","data":20},{"scope":"tablet","locale":"en_US","data":30},{"scope":"tablet","locale":"fr_FR","data":40}]}}}],"responses":{"200":{"description":"OK","x-details":"Returns a plain text response whose lines are JSON containing the status of each update or creation","x-no-entity":true,"schema":{"type":"object","properties":{"line":{"type":"integer","description":"Line number"},"uuid":{"type":"string","description":"Product uuid"},"status_code":{"type":"integer","description":"HTTP status code, see Client errors to understand the meaning of each code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"x-example-1":"{\"line\":1,\"uuid\":\"fc24e6c3-933c-4a93-8a81-e5c703d134d5\",\"status_code\":204}","x-example-2":"{\"line\":2,\"uuid\":\"573dd613-0c7f-4143-83d5-63cc5e535966\",\"status_code\":422,\"message\":\"Property \\\"group\\\" does not exist.\"}","x-example-3":"{\"line\":3,\"uuid\":\"25566245-55c3-42ce-86d9-8610ac459fa8\",\"status_code\":201}"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"413":{"description":"Request Entity Too Large","x-details":"There are too many resources to process (max 100) or the line of JSON is too long (max 1 000 000 characters)","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":413,"message":"Too many resources to process, 100 is the maximum allowed."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/vnd.akeneo.collection+json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/vnd.akeneo.collection+json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/products-uuid/{uuid}":{"get":{"summary":"Get a product","operationId":"get_products_uuid__uuid_","tags":["Product [uuid]"],"x-versions":["7.0","SaaS"],"description":"This endpoint allows you to get the information about a given product. In the Entreprise Edition, permissions based on your user groups are applied to the product you request.","parameters":[{"name":"uuid","in":"path","description":"Uuid of the resource","required":true,"type":"string"},{"name":"with_attribute_options","in":"query","description":"Return labels of attribute options in the response. See the `linked_data` format section for more details. (Only available since the 5.0 version)","default":false,"type":"boolean","required":false,"x-from-version":"5.0"},{"name":"with_asset_share_links","in":"query","description":"Return asset collection share link urls in the response. See the `linked_data` format section for more details. (Only available in the SaaS version)","default":false,"type":"boolean","required":false,"x-from-version":"SaaS"},{"name":"with_quality_scores","in":"query","description":"Return product quality scores in the response. (Only available since the 5.0 version)","default":false,"type":"boolean","required":false,"x-from-version":"5.0"},{"name":"with_completenesses","in":"query","description":"Return product completenesses in the response. (Only available since the 6.0 version)","default":false,"type":"boolean","required":false,"x-from-version":"6.0"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the product in JSON standard format","schema":{"type":"object","properties":{"uuid":{"type":"string","description":"Product uuid"},"enabled":{"type":"boolean","description":"Whether the product is enabled","default":true},"family":{"type":"string","description":"Family code from which the product inherits its attributes and attributes requirements.","x-validation-rules":"It is equal to an existing family code. In the case of variant product, the given family should be the same as the product model family.","default":"null only in the case of a non variant product"},"categories":{"type":"array","description":"Codes of the categories in which the product is classified","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"groups":{"type":"array","description":"Codes of the groups to which the product belong","x-validation-rules":"Each string of the array is equal to an existing group code","items":{"type":"string"},"default":[]},"parent":{"type":"string","description":"Code of the parent product model when the product is a variant (only available since the 2.0). This parent can be modified since the 2.3.","x-validation-rules":"It is equal to an existing product model code only if the product is variant otherwise it's equal to null","default":"null","x-from-version":"2.0"},"values":{"type":"object","description":"Product attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value. See the `data` format section for more details."},"linked_data":{"type":"object","x-read-only":true,"description":"Object containing additional data when a related query parameter is enabled. See the `linked_data` format section for more details. (only available since the 5.0)","x-from-version":"5.0","properties":{"attribute":{"type":"string"},"code":{"type":"string"},"labels":{"type":"object"}}},"attribute_type":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"The type of the value's attribute. See type section for more details."},"reference_data_name":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"Reference entity code when the attribute type is `akeneo_reference_entity` or `akeneo_reference_entity_collection` OR Asset family code when the attribute type is `pim_catalog_asset_collection`","x-warning":"Only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types"}}}}}},"associations":{"type":"object","description":"Several associations related to groups, product models and/or other products, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the uuid of an existing product. • Each string in the array of the property `product_models` is the code of an existing product model.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of product uuids with which the product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Several quantified associations related to products and/or product models, grouped by quantified association types (only available since the 5.0)","x-validation-rules":"• The `quantifiedAssociationTypeCode` is the code of an existing association type which provides quantity information. • Each object in the array of the property `products` contains the uuid of an existing product and the quantity of it.","x-from-version":"5.0","properties":{"quantifiedAssociationTypeCode":{"type":"object","properties":{"products":{"type":"array","description":"Array of objects containing product uuids and quantities with which the product is in relation","items":{"type":"object","properties":{"uuid":{"type":"string"},"quantity":{"type":"integer"}}}},"product_models":{"type":"array","description":"Array of objects containing product model codes and quantities with which the product is in relation","items":{"type":"object","properties":{"code":{"type":"string"},"quantity":{"type":"integer"}}}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"metadata":{"type":"object","description":"More information around the product (only available since the v2.0 in the Enterprise Edition)","x-immutable":true,"x-read-only":true,"x-from-version":"2.0","properties":{"workflow_status":{"description":"Status of the product regarding the user permissions","type":"string","enum":["read_only","draft_in_progress","proposal_waiting_for_approval","working_copy"]}}},"quality_scores":{"type":"object","description":"Product quality scores for each channel/locale combination (only available since the 5.0 and when the \"with_quality_scores\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"5.0"},"completenesses":{"type":"array","description":"Product completenesses for each channel/locale combination (only available since the 7.0 version, and when the \"with_completenesses\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"7.0","items":{"type":"object","properties":{"scope":{"type":"string"},"locale":{"type":"string"},"data":{"type":"integer"}}}}},"example":{"uuid":"25566245-55c3-42ce-86d9-8610ac459fa8","enabled":true,"family":"tshirt","categories":["summer_collection"],"groups":[],"parent":null,"values":{"sku":[{"data":"top","locale":null,"scope":null}],"name":[{"data":"Top","locale":"en_US","scope":null},{"data":"Débardeur","locale":"fr_FR","scope":null}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce"},{"data":"Top","locale":"en_US","scope":"tablet"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}}}],"size":[{"locale":null,"scope":null,"data":"m","linked_data":{"attribute":"size","code":"m","labels":{"en_US":"M","fr_FR":"M"}}}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"],"linked_data":{"winter_2016":{"attribute":"collection","code":"winter_2016","labels":{"en_US":"Winter 2016","fr_FR":"Hiver 2016"}}}}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["d055527c-0698-4967-8f16-8a5f23f4e5cf"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"uuid":"fc24e6c3-933c-4a93-8a81-e5c703d134d5","quantity":2},{"uuid":"a9b69002-a0b1-4ead-85c2-f8dbf59c6cfc","quantity":1}],"product_models":[{"identifier":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"completenesses":[{"scope":"ecommerce","locale":"en_US","data":10},{"scope":"ecommerce","locale":"fr_FR","data":20},{"scope":"tablet","locale":"en_US","data":30},{"scope":"tablet","locale":"fr_FR","data":40}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"patch":{"summary":"Update/create a product","operationId":"patch_products_uuid__uuid_","tags":["Product [uuid]"],"x-versions":["7.0","SaaS"],"description":"This endpoint allows you to update a given product. Learn more about Update behavior. Note that if no product exists for the given uuid, it creates it. In the Entreprise Edition, permissions based on your user groups are applied to the product you try to update. It may result in the creation of a draft if you only have edit rights through the product's categories.","parameters":[{"name":"uuid","in":"path","description":"Uuid of the resource","required":true,"type":"string"},{"name":"body","in":"body","required":true,"schema":{"type":"object","properties":{"uuid":{"type":"string","description":"Product uuid"},"enabled":{"type":"boolean","description":"Whether the product is enabled","default":true},"family":{"type":"string","description":"Family code from which the product inherits its attributes and attributes requirements.","x-validation-rules":"It is equal to an existing family code. In the case of variant product, the given family should be the same as the product model family.","default":"null only in the case of a non variant product"},"categories":{"type":"array","description":"Codes of the categories in which the product is classified","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"groups":{"type":"array","description":"Codes of the groups to which the product belong","x-validation-rules":"Each string of the array is equal to an existing group code","items":{"type":"string"},"default":[]},"parent":{"type":"string","description":"Code of the parent product model when the product is a variant (only available since the 2.0). This parent can be modified since the 2.3.","x-validation-rules":"It is equal to an existing product model code only if the product is variant otherwise it's equal to null","default":"null","x-from-version":"2.0"},"values":{"type":"object","description":"Product attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value. See the `data` format section for more details."},"linked_data":{"type":"object","x-read-only":true,"description":"Object containing additional data when a related query parameter is enabled. See the `linked_data` format section for more details. (only available since the 5.0)","x-from-version":"5.0","properties":{"attribute":{"type":"string"},"code":{"type":"string"},"labels":{"type":"object"}}},"attribute_type":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"The type of the value's attribute. See type section for more details."},"reference_data_name":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"Reference entity code when the attribute type is `akeneo_reference_entity` or `akeneo_reference_entity_collection` OR Asset family code when the attribute type is `pim_catalog_asset_collection`","x-warning":"Only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types"}}}}}},"associations":{"type":"object","description":"Several associations related to groups, product models and/or other products, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the uuid of an existing product. • Each string in the array of the property `product_models` is the code of an existing product model.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of product uuids with which the product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Several quantified associations related to products and/or product models, grouped by quantified association types (only available since the 5.0)","x-validation-rules":"• The `quantifiedAssociationTypeCode` is the code of an existing association type which provides quantity information. • Each object in the array of the property `products` contains the uuid of an existing product and the quantity of it.","x-from-version":"5.0","properties":{"quantifiedAssociationTypeCode":{"type":"object","properties":{"products":{"type":"array","description":"Array of objects containing product uuids and quantities with which the product is in relation","items":{"type":"object","properties":{"uuid":{"type":"string"},"quantity":{"type":"integer"}}}},"product_models":{"type":"array","description":"Array of objects containing product model codes and quantities with which the product is in relation","items":{"type":"object","properties":{"code":{"type":"string"},"quantity":{"type":"integer"}}}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"metadata":{"type":"object","description":"More information around the product (only available since the v2.0 in the Enterprise Edition)","x-immutable":true,"x-read-only":true,"x-from-version":"2.0","properties":{"workflow_status":{"description":"Status of the product regarding the user permissions","type":"string","enum":["read_only","draft_in_progress","proposal_waiting_for_approval","working_copy"]}}},"quality_scores":{"type":"object","description":"Product quality scores for each channel/locale combination (only available since the 5.0 and when the \"with_quality_scores\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"5.0"},"completenesses":{"type":"array","description":"Product completenesses for each channel/locale combination (only available since the 7.0 version, and when the \"with_completenesses\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"7.0","items":{"type":"object","properties":{"scope":{"type":"string"},"locale":{"type":"string"},"data":{"type":"integer"}}}}},"example":{"uuid":"25566245-55c3-42ce-86d9-8610ac459fa8","enabled":true,"family":"tshirt","categories":["summer_collection"],"groups":[],"parent":null,"values":{"sku":[{"data":"top","locale":null,"scope":null}],"name":[{"data":"Top","locale":"en_US","scope":null},{"data":"Débardeur","locale":"fr_FR","scope":null}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce"},{"data":"Top","locale":"en_US","scope":"tablet"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}}}],"size":[{"locale":null,"scope":null,"data":"m","linked_data":{"attribute":"size","code":"m","labels":{"en_US":"M","fr_FR":"M"}}}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"],"linked_data":{"winter_2016":{"attribute":"collection","code":"winter_2016","labels":{"en_US":"Winter 2016","fr_FR":"Hiver 2016"}}}}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["d055527c-0698-4967-8f16-8a5f23f4e5cf"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"uuid":"fc24e6c3-933c-4a93-8a81-e5c703d134d5","quantity":2},{"uuid":"a9b69002-a0b1-4ead-85c2-f8dbf59c6cfc","quantity":1}],"product_models":[{"identifier":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"completenesses":[{"scope":"ecommerce","locale":"en_US","data":10},{"scope":"ecommerce","locale":"fr_FR","data":20},{"scope":"tablet","locale":"en_US","data":30},{"scope":"tablet","locale":"fr_FR","data":40}]}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"204":{"description":"No content to return","x-details":"Means that the update was successful","headers":{"Location":{"description":"URI of the updated resource","type":"string"}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}},"delete":{"summary":"Delete a product","operationId":"delete_products_uuid__uuid_","tags":["Product [uuid]"],"x-versions":["7.0","SaaS"],"description":"This endpoint allows you to delete a given product. In the Enterprise Edition, permissions based on your user groups are applied to the product you try to delete.","parameters":[{"name":"uuid","in":"path","description":"Uuid of the resource","required":true,"type":"string"}],"responses":{"204":{"description":"No content to return","x-details":"Means that the deletion was successful"},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}}}}},"/api/rest/v1/products-uuid/{uuid}/proposal":{"post":{"summary":"Submit a draft for approval","operationId":"post_proposal_uuid","tags":["Product [uuid]"],"x-versions":["7.0","SaaS"],"x-ee":true,"description":"This endpoint allows you to submit a draft for approval.","parameters":[{"name":"uuid","in":"path","description":"Uuid of the resource","required":true,"type":"string"}],"responses":{"201":{"description":"Submitted","x-details":"Means that the draft submission was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/products-uuid/{uuid}/draft":{"get":{"summary":"Get a draft","operationId":"get_draft_uuid__uuid_","tags":["Product [uuid]"],"x-versions":["7.0","SaaS"],"x-ee":true,"description":"This endpoint allows you to get the information about a given draft.","parameters":[{"name":"uuid","in":"path","description":"Uuid of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the draft in JSON standard format","schema":{"type":"object","properties":{"uuid":{"type":"string","description":"Product uuid"},"enabled":{"type":"boolean","description":"Whether the product is enabled","default":true},"family":{"type":"string","description":"Family code from which the product inherits its attributes and attributes requirements.","x-validation-rules":"It is equal to an existing family code. In the case of variant product, the given family should be the same as the product model family.","default":"null only in the case of a non variant product"},"categories":{"type":"array","description":"Codes of the categories in which the product is classified","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"groups":{"type":"array","description":"Codes of the groups to which the product belong","x-validation-rules":"Each string of the array is equal to an existing group code","items":{"type":"string"},"default":[]},"parent":{"type":"string","description":"Code of the parent product model when the product is a variant (only available since the 2.0). This parent can be modified since the 2.3.","x-validation-rules":"It is equal to an existing product model code only if the product is variant otherwise it's equal to null","default":"null","x-from-version":"2.0"},"values":{"type":"object","description":"Product attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value. See the `data` format section for more details."},"linked_data":{"type":"object","x-read-only":true,"description":"Object containing additional data when a related query parameter is enabled. See the `linked_data` format section for more details. (only available since the 5.0)","x-from-version":"5.0","properties":{"attribute":{"type":"string"},"code":{"type":"string"},"labels":{"type":"object"}}},"attribute_type":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"The type of the value's attribute. See type section for more details."},"reference_data_name":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"Reference entity code when the attribute type is `akeneo_reference_entity` or `akeneo_reference_entity_collection` OR Asset family code when the attribute type is `pim_catalog_asset_collection`","x-warning":"Only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types"}}}}}},"associations":{"type":"object","description":"Several associations related to groups, product models and/or other products, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the uuid of an existing product. • Each string in the array of the property `product_models` is the code of an existing product model.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of product uuids with which the product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Several quantified associations related to products and/or product models, grouped by quantified association types (only available since the 5.0)","x-validation-rules":"• The `quantifiedAssociationTypeCode` is the code of an existing association type which provides quantity information. • Each object in the array of the property `products` contains the uuid of an existing product and the quantity of it.","x-from-version":"5.0","properties":{"quantifiedAssociationTypeCode":{"type":"object","properties":{"products":{"type":"array","description":"Array of objects containing product uuids and quantities with which the product is in relation","items":{"type":"object","properties":{"uuid":{"type":"string"},"quantity":{"type":"integer"}}}},"product_models":{"type":"array","description":"Array of objects containing product model codes and quantities with which the product is in relation","items":{"type":"object","properties":{"code":{"type":"string"},"quantity":{"type":"integer"}}}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"metadata":{"type":"object","description":"More information around the product (only available since the v2.0 in the Enterprise Edition)","x-immutable":true,"x-read-only":true,"x-from-version":"2.0","properties":{"workflow_status":{"description":"Status of the product regarding the user permissions","type":"string","enum":["read_only","draft_in_progress","proposal_waiting_for_approval","working_copy"]}}},"quality_scores":{"type":"object","description":"Product quality scores for each channel/locale combination (only available since the 5.0 and when the \"with_quality_scores\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"5.0"},"completenesses":{"type":"array","description":"Product completenesses for each channel/locale combination (only available since the 7.0 version, and when the \"with_completenesses\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"7.0","items":{"type":"object","properties":{"scope":{"type":"string"},"locale":{"type":"string"},"data":{"type":"integer"}}}}},"example":{"uuid":"25566245-55c3-42ce-86d9-8610ac459fa8","enabled":true,"family":"tshirt","categories":["summer_collection"],"groups":[],"parent":null,"values":{"sku":[{"data":"top","locale":null,"scope":null}],"name":[{"data":"Top","locale":"en_US","scope":null},{"data":"Débardeur","locale":"fr_FR","scope":null}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce"},{"data":"Top","locale":"en_US","scope":"tablet"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}}}],"size":[{"locale":null,"scope":null,"data":"m","linked_data":{"attribute":"size","code":"m","labels":{"en_US":"M","fr_FR":"M"}}}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"],"linked_data":{"winter_2016":{"attribute":"collection","code":"winter_2016","labels":{"en_US":"Winter 2016","fr_FR":"Hiver 2016"}}}}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["d055527c-0698-4967-8f16-8a5f23f4e5cf"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"uuid":"fc24e6c3-933c-4a93-8a81-e5c703d134d5","quantity":2},{"uuid":"a9b69002-a0b1-4ead-85c2-f8dbf59c6cfc","quantity":1}],"product_models":[{"identifier":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"completenesses":[{"scope":"ecommerce","locale":"en_US","data":10},{"scope":"ecommerce","locale":"fr_FR","data":20},{"scope":"tablet","locale":"en_US","data":30},{"scope":"tablet","locale":"fr_FR","data":40}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}}},"/api/rest/v1/products":{"get":{"summary":"Get list of products","operationId":"get_products","tags":["Product [identifier]"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to get a list of products. Products are paginated and they can be filtered. In the Enterprise Edition, since the 2.0, permissions based on your user groups are applied to the set of products you request.","parameters":[{"name":"search","in":"query","description":"Filter products, for more details see the Filters section","required":false,"type":"string"},{"name":"scope","in":"query","type":"string","description":"Filter product values to return scopable attributes for the given channel as well as the non localizable/non scopable attributes, for more details see the Filter product values via channel section","required":false},{"name":"locales","in":"query","type":"string","description":"Filter product values to return localizable attributes for the given locales as well as the non localizable/non scopable attributes, for more details see the Filter product values via locale section","required":false},{"name":"attributes","in":"query","type":"string","description":"Filter product values to only return those concerning the given attributes, for more details see the Filter on product values section","required":false},{"name":"pagination_type","in":"query","description":"Pagination method type, see Pagination section","required":false,"type":"string","default":"page","x-validation-rules":"One of the following values","enum":["page","search_after"]},{"name":"page","in":"query","description":"Number of the page to retrieve when using the `page` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"integer","default":1},{"name":"search_after","in":"query","description":"Cursor when using the `search_after` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"string","default":"cursor to the first page"},{"name":"limit","in":"query","description":"Number of results by page, see Pagination section","required":false,"type":"integer","minimum":1,"maximum":100,"default":10},{"name":"with_count","in":"query","description":"Return the count of items in the response. Be carefull with that, on a big catalog, it can decrease performance in a significative way","default":false,"type":"boolean","required":false},{"name":"with_attribute_options","in":"query","description":"Return labels of attribute options in the response. See the `linked_data` format section for more details. (Only available since the 5.0 version)","default":false,"type":"boolean","required":false,"x-from-version":"5.0"},{"name":"with_asset_share_links","in":"query","description":"Return asset collection share link urls in the response. See the `linked_data` format section for more details. (Only available in the SaaS version)","default":false,"type":"boolean","required":false,"x-from-version":"SaaS"},{"name":"with_quality_scores","in":"query","description":"Return product quality scores in the response. (Only available since the 5.0 version)","default":false,"type":"boolean","required":false,"x-from-version":"5.0"},{"name":"with_completenesses","in":"query","description":"Return product completenesses in the response. (Only available since the 6.0 version)","default":false,"type":"boolean","required":false,"x-from-version":"6.0"}],"responses":{"200":{"description":"Return products paginated","schema":{"title":"Products","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"previous":{"type":"object","properties":{"href":{"type":"string","description":"URI of the previous page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}},"current_page":{"type":"integer","description":"Current page number"}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["identifier"],"properties":{"uuid":{"type":"string","description":"Product UUID","x-from-version":"7.0"},"identifier":{"type":"string","description":"Product identifier, i.e. the value of the only `pim_catalog_identifier` attribute"},"enabled":{"type":"boolean","description":"Whether the product is enabled","default":true},"family":{"type":"string","description":"Family code from which the product inherits its attributes and attributes requirements.","x-validation-rules":"It is equal to an existing family code. In the case of variant product, the given family should be the same as the product model family.","default":"null only in the case of a non variant product"},"categories":{"type":"array","description":"Codes of the categories in which the product is classified","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"groups":{"type":"array","description":"Codes of the groups to which the product belong","x-validation-rules":"Each string of the array is equal to an existing group code","items":{"type":"string"},"default":[]},"parent":{"type":"string","description":"Code of the parent product model when the product is a variant (only available since the 2.0). This parent can be modified since the 2.3.","x-validation-rules":"It is equal to an existing product model code only if the product is variant otherwise it's equal to null","default":"null","x-from-version":"2.0"},"values":{"type":"object","description":"Product attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value. See the `data` format section for more details."},"linked_data":{"type":"object","x-read-only":true,"description":"Object containing additional data when a related query parameter is enabled. See the `linked_data` format section for more details. (only available since the 5.0)","x-from-version":"5.0","properties":{"attribute":{"type":"string"},"code":{"type":"string"},"labels":{"type":"object"}}},"attribute_type":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"The type of the value's attribute. See type section for more details."},"reference_data_name":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"Reference entity code when the attribute type is `akeneo_reference_entity` or `akeneo_reference_entity_collection` OR Asset family code when the attribute type is `pim_catalog_asset_collection`","x-warning":"Only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types"}}}}}},"associations":{"type":"object","description":"Several associations related to groups, product models and/or other products, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the identifier of an existing product. • Each string in the array of the property `product_models` is the code of an existing product model.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of product identifiers with which the product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Several quantified associations related to products and/or product models, grouped by quantified association types (only available since the 5.0)","x-validation-rules":"• The `quantifiedAssociationTypeCode` is the code of an existing association type which provides quantity information. • Each object in the array of the property `products` contains the identifier of an existing product and the quantity of it.","x-from-version":"5.0","properties":{"quantifiedAssociationTypeCode":{"type":"object","properties":{"products":{"type":"array","description":"Array of objects containing product identifiers and quantities with which the product is in relation","items":{"type":"object","properties":{"identifier":{"type":"string"},"quantity":{"type":"integer"}}}},"product_models":{"type":"array","description":"Array of objects containing product model codes and quantities with which the product is in relation","items":{"type":"object","properties":{"code":{"type":"string"},"quantity":{"type":"integer"}}}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"metadata":{"type":"object","description":"More information around the product (only available since the v2.0 in the Enterprise Edition)","x-immutable":true,"x-read-only":true,"x-from-version":"2.0","properties":{"workflow_status":{"description":"Status of the product regarding the user permissions","type":"string","enum":["read_only","draft_in_progress","proposal_waiting_for_approval","working_copy"]}}},"quality_scores":{"type":"object","description":"Product quality scores for each channel/locale combination (only available since the 5.0 and when the \"with_quality_scores\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"5.0"},"completenesses":{"type":"array","description":"Product completenesses for each channel/locale combination (only available since the 7.0 version, and when the \"with_completenesses\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"7.0","items":{"type":"object","properties":{"scope":{"type":"string"},"locale":{"type":"string"},"data":{"type":"integer"}}}}},"example":{"identifier":"top","enabled":true,"family":"tshirt","categories":["summer_collection"],"groups":[],"parent":null,"values":{"name":[{"data":"Top","locale":"en_US","scope":null,"attribute_type":"pim_catalog_text"},{"data":"Débardeur","locale":"fr_FR","scope":null,"attribute_type":"pim_catalog_text"}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce","attribute_type":"pim_catalog_textarea"},{"data":"Top","locale":"en_US","scope":"tablet","attribute_type":"pim_catalog_textarea"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce","attribute_type":"pim_catalog_textarea"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet","attribute_type":"pim_catalog_textarea"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}],"attribute_type":"pim_catalog_price_collection"}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}},"attribute_type":"pim_catalog_simpleselect"}],"size":[{"locale":null,"scope":null,"data":"m","linked_data":{"attribute":"size","code":"m","labels":{"en_US":"M","fr_FR":"M"}},"attribute_type":"pim_catalog_simpleselect"}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"],"linked_data":{"winter_2016":{"attribute":"collection","code":"winter_2016","labels":{"en_US":"Winter 2016","fr_FR":"Hiver 2016"}}},"attribute_type":"pim_catalog_multiselect"}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglass"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"cap","quantity":2},{"identifier":"shoes","quantity":1}],"product_models":[{"identifier":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"completenesses":[{"scope":"ecommerce","locale":"en_US","data":10},{"scope":"ecommerce","locale":"fr_FR","data":20},{"scope":"tablet","locale":"en_US","data":30},{"scope":"tablet","locale":"fr_FR","data":40}]}}]}}}}}}]},"x-examples-per-version":[{"x-version":"1.7","x-example":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=3&limit=3"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=1&limit=3"},"previous":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=2&limit=3"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=4&limit=3"}},"current_page":3,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/top"}},"identifier":"top","family":"tshirt","groups":[],"categories":["summer_collection"],"enabled":true,"values":{"name":[{"data":"Top","locale":"en_US","scope":null},{"data":"Débardeur","locale":"fr_FR","scope":null}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce"},{"data":"Top","locale":"en_US","scope":"tablet"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black"}],"size":[{"locale":null,"scope":null,"data":"m"}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"]}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglasses"],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"cap","quantity":2},{"identifier":"shoes","quantity":1}]}}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/cap"}},"identifier":"cap","family":"caps","groups":[],"categories":["summer_collection"],"enabled":true,"values":{"name":[{"data":"Cap","locale":"en_US","scope":null},{"data":"Casquette","locale":"fr_FR","scope":null}],"description":[{"data":"Cap unisex","locale":"en_US","scope":"ecommerce"},{"data":"Cap unisex","locale":"en_US","scope":"tablet"},{"data":"Casquette unisexe","locale":"fr_FR","scope":"ecommerce"},{"data":"Casquette unisexe","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"20","currency":"EUR"},{"amount":"20","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black"}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglasses"],"groups":[]}},"quantified_associations":{}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/sweat"}},"identifier":"sweat","family":null,"groups":[],"categories":["winter_collection"],"enabled":true,"values":{},"created":"2016-06-23T11:24:44+02:00","updated":"2016-06-23T11:24:44+02:00","associations":{},"quantified_associations":{}}]}}},{"x-version":"2.0","x-example":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=3&limit=3"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=1&limit=3"},"previous":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=2&limit=3"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=4&limit=3"}},"current_page":3,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/top"}},"identifier":"top","family":"tshirt","groups":[],"parent":null,"categories":["summer_collection"],"enabled":true,"values":{"name":[{"data":"Top","locale":"en_US","scope":null},{"data":"Débardeur","locale":"fr_FR","scope":null}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce"},{"data":"Top","locale":"en_US","scope":"tablet"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black"}],"size":[{"locale":null,"scope":null,"data":"m"}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"]}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglasses"],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"cap","quantity":2},{"identifier":"shoes","quantity":1}]}}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/cap"}},"identifier":"cap","family":"caps","groups":[],"parent":null,"categories":["summer_collection"],"enabled":true,"values":{"name":[{"data":"Cap","locale":"en_US","scope":null},{"data":"Casquette","locale":"fr_FR","scope":null}],"description":[{"data":"Cap unisex","locale":"en_US","scope":"ecommerce"},{"data":"Cap unisex","locale":"en_US","scope":"tablet"},{"data":"Casquette unisexe","locale":"fr_FR","scope":"ecommerce"},{"data":"Casquette unisexe","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"20","currency":"EUR"},{"amount":"20","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black"}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglasses"],"groups":[]}},"quantified_associations":{}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/sweat"}},"identifier":"sweat","family":null,"groups":[],"parent":null,"categories":["winter_collection"],"enabled":true,"values":{},"created":"2016-06-23T11:24:44+02:00","updated":"2016-06-23T11:24:44+02:00","associations":{},"quantified_associations":{}}]}}},{"x-version":"2.1","x-example":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=3&limit=3"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=1&limit=3"},"previous":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=2&limit=3"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=4&limit=3"}},"current_page":3,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/top"}},"identifier":"top","family":"tshirt","groups":[],"parent":null,"categories":["summer_collection"],"enabled":true,"values":{"name":[{"data":"Top","locale":"en_US","scope":null},{"data":"Débardeur","locale":"fr_FR","scope":null}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce"},{"data":"Top","locale":"en_US","scope":"tablet"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black"}],"size":[{"locale":null,"scope":null,"data":"m"}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"]}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglasses"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"cap","quantity":2},{"identifier":"shoes","quantity":1}],"product_models":[{"identifier":"model-biker-jacket-leather","quantity":2}]}}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/cap"}},"identifier":"cap","family":"caps","groups":[],"parent":null,"categories":["summer_collection"],"enabled":true,"values":{"name":[{"data":"Cap","locale":"en_US","scope":null},{"data":"Casquette","locale":"fr_FR","scope":null}],"description":[{"data":"Cap unisex","locale":"en_US","scope":"ecommerce"},{"data":"Cap unisex","locale":"en_US","scope":"tablet"},{"data":"Casquette unisexe","locale":"fr_FR","scope":"ecommerce"},{"data":"Casquette unisexe","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"20","currency":"EUR"},{"amount":"20","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black"}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglasses"],"product_models":[],"groups":[]}},"quantified_associations":{}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/sweat"}},"identifier":"sweat","family":null,"groups":[],"parent":null,"categories":["winter_collection"],"enabled":true,"values":{},"created":"2016-06-23T11:24:44+02:00","updated":"2016-06-23T11:24:44+02:00","associations":{},"quantified_associations":{}}]}}},{"x-version":"5.0","x-example":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=3&limit=3&with_quality_scores=true&with_attribute_options=true"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=1&limit=3&with_quality_scores=true&with_attribute_options=true"},"previous":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=2&limit=3&with_quality_scores=true&with_attribute_options=true"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=4&limit=3&with_quality_scores=true&with_attribute_options=true"}},"current_page":3,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/top"}},"identifier":"top","family":"tshirt","groups":[],"parent":null,"categories":["summer_collection"],"enabled":true,"values":{"name":[{"data":"Top","locale":"en_US","scope":null},{"data":"Débardeur","locale":"fr_FR","scope":null}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce"},{"data":"Top","locale":"en_US","scope":"tablet"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}}}],"size":[{"locale":null,"scope":null,"data":"m","linked_data":{"attribute":"size","code":"m","labels":{"en_US":"M","fr_FR":"M"}}}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"],"linked_data":{"winter_2016":{"attribute":"collection","code":"winter_2016","labels":{"en_US":"Winter 2016","fr_FR":"Hiver 2016"}}}}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglasses"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"cap","quantity":2},{"identifier":"shoes","quantity":1}],"product_models":[{"identifier":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}]},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/cap"}},"identifier":"cap","family":"caps","groups":[],"parent":null,"categories":["summer_collection"],"enabled":true,"values":{"name":[{"data":"Cap","locale":"en_US","scope":null},{"data":"Casquette","locale":"fr_FR","scope":null}],"description":[{"data":"Cap unisex","locale":"en_US","scope":"ecommerce"},{"data":"Cap unisex","locale":"en_US","scope":"tablet"},{"data":"Casquette unisexe","locale":"fr_FR","scope":"ecommerce"},{"data":"Casquette unisexe","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"20","currency":"EUR"},{"amount":"20","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}}}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglasses"],"product_models":[],"groups":[]}},"quantified_associations":{},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}]},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/sweat"}},"identifier":"sweat","family":null,"groups":[],"parent":null,"categories":["winter_collection"],"enabled":true,"values":{},"created":"2016-06-23T11:24:44+02:00","updated":"2016-06-23T11:24:44+02:00","associations":{},"quantified_associations":{},"quality_scores":{}}]}}},{"x-version":"SaaS","x-example":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=3&limit=3&with_quality_scores=true&with_completenesses=true&with_attribute_options=true"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=1&limit=3&with_quality_scores=true&with_completenesses=true&with_attribute_options=true"},"previous":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=2&limit=3&with_quality_scores=true&with_completenesses=true&with_attribute_options=true"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=4&limit=3&with_quality_scores=true&with_completenesses=true&with_attribute_options=true"}},"current_page":3,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/top"}},"uuid":"aaf518b2-f91e-40f1-a53a-78ce5e81a6f9","identifier":"top","family":"tshirt","groups":[],"parent":null,"categories":["summer_collection"],"enabled":true,"values":{"name":[{"data":"Top","locale":"en_US","scope":null,"attribute_type":"pim_catalog_text"},{"data":"Débardeur","locale":"fr_FR","scope":null,"attribute_type":"pim_catalog_text"}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce","attribute_type":"pim_catalog_textarea"},{"data":"Top","locale":"en_US","scope":"tablet","attribute_type":"pim_catalog_textarea"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce","attribute_type":"pim_catalog_textarea"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet","attribute_type":"pim_catalog_textarea"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}],"attribute_type":"pim_catalog_price_collection"}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}},"attribute_type":"pim_catalog_simpleselect"}],"size":[{"locale":null,"scope":null,"data":"m","linked_data":{"attribute":"size","code":"m","labels":{"en_US":"M","fr_FR":"M"}},"attribute_type":"pim_catalog_simpleselect"}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"],"linked_data":{"winter_2016":{"attribute":"collection","code":"winter_2016","labels":{"en_US":"Winter 2016","fr_FR":"Hiver 2016"}}},"attribute_type":"pim_catalog_multiselect"}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglasses"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"cap","quantity":2},{"identifier":"shoes","quantity":1}],"product_models":[{"identifier":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"completenesses":[{"scope":"ecommerce","locale":"en_US","data":20},{"scope":"ecommerce","locale":"fr_FR","data":30},{"scope":"tablet","locale":"en_US","data":55},{"scope":"tablet","locale":"fr_FR","data":70}]},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/cap"}},"uuid":"aec6780b-c813-4bd7-8e24-1a8574471576","identifier":"cap","family":"caps","groups":[],"parent":null,"categories":["summer_collection"],"enabled":true,"values":{"name":[{"data":"Cap","locale":"en_US","scope":null},{"data":"Casquette","locale":"fr_FR","scope":null}],"description":[{"data":"Cap unisex","locale":"en_US","scope":"ecommerce"},{"data":"Cap unisex","locale":"en_US","scope":"tablet"},{"data":"Casquette unisexe","locale":"fr_FR","scope":"ecommerce"},{"data":"Casquette unisexe","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"20","currency":"EUR"},{"amount":"20","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}}}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglasses"],"product_models":[],"groups":[]}},"quantified_associations":{},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"completenesses":[{"scope":"ecommerce","locale":"en_US","data":20},{"scope":"ecommerce","locale":"fr_FR","data":30},{"scope":"tablet","locale":"en_US","data":55},{"scope":"tablet","locale":"fr_FR","data":70}]},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/sweat"}},"uuid":"93f14b03-5ed3-4f23-87c6-ae3806041b6a","identifier":"sweat","family":null,"groups":[],"parent":null,"categories":["winter_collection"],"enabled":true,"values":{},"created":"2016-06-23T11:24:44+02:00","updated":"2016-06-23T11:24:44+02:00","associations":{},"quantified_associations":{},"quality_scores":{},"completenesses":[]}]}}}]},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}},"post":{"summary":"Create a new product","operationId":"post_products","tags":["Product [identifier]"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to create a new product. In the Enterprise Edition, since the v2.0, permissions based on your user groups are applied to the product you try to create.","parameters":[{"name":"body","in":"body","schema":{"type":"object","required":["identifier"],"properties":{"uuid":{"type":"string","description":"Product UUID","x-from-version":"7.0"},"identifier":{"type":"string","description":"Product identifier, i.e. the value of the only `pim_catalog_identifier` attribute"},"enabled":{"type":"boolean","description":"Whether the product is enabled","default":true},"family":{"type":"string","description":"Family code from which the product inherits its attributes and attributes requirements.","x-validation-rules":"It is equal to an existing family code. In the case of variant product, the given family should be the same as the product model family.","default":"null only in the case of a non variant product"},"categories":{"type":"array","description":"Codes of the categories in which the product is classified","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"groups":{"type":"array","description":"Codes of the groups to which the product belong","x-validation-rules":"Each string of the array is equal to an existing group code","items":{"type":"string"},"default":[]},"parent":{"type":"string","description":"Code of the parent product model when the product is a variant (only available since the 2.0). This parent can be modified since the 2.3.","x-validation-rules":"It is equal to an existing product model code only if the product is variant otherwise it's equal to null","default":"null","x-from-version":"2.0"},"values":{"type":"object","description":"Product attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value. See the `data` format section for more details."},"linked_data":{"type":"object","x-read-only":true,"description":"Object containing additional data when a related query parameter is enabled. See the `linked_data` format section for more details. (only available since the 5.0)","x-from-version":"5.0","properties":{"attribute":{"type":"string"},"code":{"type":"string"},"labels":{"type":"object"}}},"attribute_type":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"The type of the value's attribute. See type section for more details."},"reference_data_name":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"Reference entity code when the attribute type is `akeneo_reference_entity` or `akeneo_reference_entity_collection` OR Asset family code when the attribute type is `pim_catalog_asset_collection`","x-warning":"Only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types"}}}}}},"associations":{"type":"object","description":"Several associations related to groups, product models and/or other products, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the identifier of an existing product. • Each string in the array of the property `product_models` is the code of an existing product model.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of product identifiers with which the product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Several quantified associations related to products and/or product models, grouped by quantified association types (only available since the 5.0)","x-validation-rules":"• The `quantifiedAssociationTypeCode` is the code of an existing association type which provides quantity information. • Each object in the array of the property `products` contains the identifier of an existing product and the quantity of it.","x-from-version":"5.0","properties":{"quantifiedAssociationTypeCode":{"type":"object","properties":{"products":{"type":"array","description":"Array of objects containing product identifiers and quantities with which the product is in relation","items":{"type":"object","properties":{"identifier":{"type":"string"},"quantity":{"type":"integer"}}}},"product_models":{"type":"array","description":"Array of objects containing product model codes and quantities with which the product is in relation","items":{"type":"object","properties":{"code":{"type":"string"},"quantity":{"type":"integer"}}}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"metadata":{"type":"object","description":"More information around the product (only available since the v2.0 in the Enterprise Edition)","x-immutable":true,"x-read-only":true,"x-from-version":"2.0","properties":{"workflow_status":{"description":"Status of the product regarding the user permissions","type":"string","enum":["read_only","draft_in_progress","proposal_waiting_for_approval","working_copy"]}}},"quality_scores":{"type":"object","description":"Product quality scores for each channel/locale combination (only available since the 5.0 and when the \"with_quality_scores\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"5.0"},"completenesses":{"type":"array","description":"Product completenesses for each channel/locale combination (only available since the 7.0 version, and when the \"with_completenesses\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"7.0","items":{"type":"object","properties":{"scope":{"type":"string"},"locale":{"type":"string"},"data":{"type":"integer"}}}}},"example":{"identifier":"top","enabled":true,"family":"tshirt","categories":["summer_collection"],"groups":[],"parent":null,"values":{"name":[{"data":"Top","locale":"en_US","scope":null,"attribute_type":"pim_catalog_text"},{"data":"Débardeur","locale":"fr_FR","scope":null,"attribute_type":"pim_catalog_text"}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce","attribute_type":"pim_catalog_textarea"},{"data":"Top","locale":"en_US","scope":"tablet","attribute_type":"pim_catalog_textarea"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce","attribute_type":"pim_catalog_textarea"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet","attribute_type":"pim_catalog_textarea"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}],"attribute_type":"pim_catalog_price_collection"}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}},"attribute_type":"pim_catalog_simpleselect"}],"size":[{"locale":null,"scope":null,"data":"m","linked_data":{"attribute":"size","code":"m","labels":{"en_US":"M","fr_FR":"M"}},"attribute_type":"pim_catalog_simpleselect"}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"],"linked_data":{"winter_2016":{"attribute":"collection","code":"winter_2016","labels":{"en_US":"Winter 2016","fr_FR":"Hiver 2016"}}},"attribute_type":"pim_catalog_multiselect"}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglass"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"cap","quantity":2},{"identifier":"shoes","quantity":1}],"product_models":[{"identifier":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"completenesses":[{"scope":"ecommerce","locale":"en_US","data":10},{"scope":"ecommerce","locale":"fr_FR","data":20},{"scope":"tablet","locale":"en_US","data":30},{"scope":"tablet","locale":"fr_FR","data":40}]}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}},"patch":{"summary":"Update/create several products","operationId":"patch_products","tags":["Product [identifier]"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to update and/or create several products at once. Learn more about Update behavior. Note that if no product exists for the given identifier, it creates it. In the Enterprise Edition, since the v2.0, permissions based on your user groups are applied to the products you try to update. It may result in the creation of drafts if you only have edit rights through the product's categories.","x-body-by-line":"Contains several lines, each line is a product in JSON standard format","parameters":[{"name":"body","in":"body","schema":{"x-examples":{"x-example-1":"{\"identifier\":\"cap\",\"values\":{\"description\":[{\"scope\":\"ecommerce\",\"locale\":\"en_US\",\"data\":\"My amazing cap\"}]}}","x-example-2":"{\"identifier\":\"mug\",\"group\":[\"promotion\"]}","x-example-3":"{\"identifier\":\"tshirt\",\"family\":\"clothes\"}"},"type":"object","required":["identifier"],"properties":{"uuid":{"type":"string","description":"Product UUID","x-from-version":"7.0"},"identifier":{"type":"string","description":"Product identifier, i.e. the value of the only `pim_catalog_identifier` attribute"},"enabled":{"type":"boolean","description":"Whether the product is enabled","default":true},"family":{"type":"string","description":"Family code from which the product inherits its attributes and attributes requirements.","x-validation-rules":"It is equal to an existing family code. In the case of variant product, the given family should be the same as the product model family.","default":"null only in the case of a non variant product"},"categories":{"type":"array","description":"Codes of the categories in which the product is classified","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"groups":{"type":"array","description":"Codes of the groups to which the product belong","x-validation-rules":"Each string of the array is equal to an existing group code","items":{"type":"string"},"default":[]},"parent":{"type":"string","description":"Code of the parent product model when the product is a variant (only available since the 2.0). This parent can be modified since the 2.3.","x-validation-rules":"It is equal to an existing product model code only if the product is variant otherwise it's equal to null","default":"null","x-from-version":"2.0"},"values":{"type":"object","description":"Product attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value. See the `data` format section for more details."},"linked_data":{"type":"object","x-read-only":true,"description":"Object containing additional data when a related query parameter is enabled. See the `linked_data` format section for more details. (only available since the 5.0)","x-from-version":"5.0","properties":{"attribute":{"type":"string"},"code":{"type":"string"},"labels":{"type":"object"}}},"attribute_type":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"The type of the value's attribute. See type section for more details."},"reference_data_name":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"Reference entity code when the attribute type is `akeneo_reference_entity` or `akeneo_reference_entity_collection` OR Asset family code when the attribute type is `pim_catalog_asset_collection`","x-warning":"Only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types"}}}}}},"associations":{"type":"object","description":"Several associations related to groups, product models and/or other products, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the identifier of an existing product. • Each string in the array of the property `product_models` is the code of an existing product model.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of product identifiers with which the product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Several quantified associations related to products and/or product models, grouped by quantified association types (only available since the 5.0)","x-validation-rules":"• The `quantifiedAssociationTypeCode` is the code of an existing association type which provides quantity information. • Each object in the array of the property `products` contains the identifier of an existing product and the quantity of it.","x-from-version":"5.0","properties":{"quantifiedAssociationTypeCode":{"type":"object","properties":{"products":{"type":"array","description":"Array of objects containing product identifiers and quantities with which the product is in relation","items":{"type":"object","properties":{"identifier":{"type":"string"},"quantity":{"type":"integer"}}}},"product_models":{"type":"array","description":"Array of objects containing product model codes and quantities with which the product is in relation","items":{"type":"object","properties":{"code":{"type":"string"},"quantity":{"type":"integer"}}}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"metadata":{"type":"object","description":"More information around the product (only available since the v2.0 in the Enterprise Edition)","x-immutable":true,"x-read-only":true,"x-from-version":"2.0","properties":{"workflow_status":{"description":"Status of the product regarding the user permissions","type":"string","enum":["read_only","draft_in_progress","proposal_waiting_for_approval","working_copy"]}}},"quality_scores":{"type":"object","description":"Product quality scores for each channel/locale combination (only available since the 5.0 and when the \"with_quality_scores\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"5.0"},"completenesses":{"type":"array","description":"Product completenesses for each channel/locale combination (only available since the 7.0 version, and when the \"with_completenesses\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"7.0","items":{"type":"object","properties":{"scope":{"type":"string"},"locale":{"type":"string"},"data":{"type":"integer"}}}}},"example":{"identifier":"top","enabled":true,"family":"tshirt","categories":["summer_collection"],"groups":[],"parent":null,"values":{"name":[{"data":"Top","locale":"en_US","scope":null,"attribute_type":"pim_catalog_text"},{"data":"Débardeur","locale":"fr_FR","scope":null,"attribute_type":"pim_catalog_text"}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce","attribute_type":"pim_catalog_textarea"},{"data":"Top","locale":"en_US","scope":"tablet","attribute_type":"pim_catalog_textarea"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce","attribute_type":"pim_catalog_textarea"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet","attribute_type":"pim_catalog_textarea"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}],"attribute_type":"pim_catalog_price_collection"}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}},"attribute_type":"pim_catalog_simpleselect"}],"size":[{"locale":null,"scope":null,"data":"m","linked_data":{"attribute":"size","code":"m","labels":{"en_US":"M","fr_FR":"M"}},"attribute_type":"pim_catalog_simpleselect"}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"],"linked_data":{"winter_2016":{"attribute":"collection","code":"winter_2016","labels":{"en_US":"Winter 2016","fr_FR":"Hiver 2016"}}},"attribute_type":"pim_catalog_multiselect"}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglass"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"cap","quantity":2},{"identifier":"shoes","quantity":1}],"product_models":[{"identifier":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"completenesses":[{"scope":"ecommerce","locale":"en_US","data":10},{"scope":"ecommerce","locale":"fr_FR","data":20},{"scope":"tablet","locale":"en_US","data":30},{"scope":"tablet","locale":"fr_FR","data":40}]}}}],"responses":{"200":{"description":"OK","x-details":"Returns a plain text response whose lines are JSON containing the status of each update or creation","x-no-entity":true,"schema":{"type":"object","properties":{"line":{"type":"integer","description":"Line number"},"identifier":{"type":"string","description":"Resource identifier, only filled when the resource is a product"},"code":{"type":"string","description":"Resource code, only filled when the resource is not a product"},"status_code":{"type":"integer","description":"HTTP status code, see Client errors to understand the meaning of each code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"x-example-1":"{\"line\":1,\"identifier\":\"cap\",\"status_code\":204}","x-example-2":"{\"line\":2,\"identifier\":\"mug\",\"status_code\":422,\"message\":\"Property \\\"group\\\" does not exist.\"}","x-example-3":"{\"line\":3,\"identifier\":\"tshirt\",\"status_code\":201}"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"413":{"description":"Request Entity Too Large","x-details":"There are too many resources to process (max 100) or the line of JSON is too long (max 1 000 000 characters)","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":413,"message":"Too many resources to process, 100 is the maximum allowed."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/vnd.akeneo.collection+json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/vnd.akeneo.collection+json’ is allowed."}}}}},"/api/rest/v1/products/{code}":{"get":{"summary":"Get a product","operationId":"get_products__code_","tags":["Product [identifier]"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to get the information about a given product. In the Entreprise Edition, since the v2.0, permissions based on your user groups are applied to the product you request.","parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"},{"name":"with_attribute_options","in":"query","description":"Return labels of attribute options in the response. See the `linked_data` format section for more details. (Only available since the 5.0 version)","default":false,"type":"boolean","required":false,"x-from-version":"5.0"},{"name":"with_asset_share_links","in":"query","description":"Return asset collection share link urls in the response. See the `linked_data` format section for more details. (Only available in the SaaS version)","default":false,"type":"boolean","required":false,"x-from-version":"SaaS"},{"name":"with_quality_scores","in":"query","description":"Return product quality scores in the response. (Only available since the 5.0 version)","default":false,"type":"boolean","required":false,"x-from-version":"5.0"},{"name":"with_completenesses","in":"query","description":"Return product completenesses in the response. (Only available since the 6.0 version)","default":false,"type":"boolean","required":false,"x-from-version":"6.0"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the product in JSON standard format","schema":{"type":"object","required":["identifier"],"properties":{"uuid":{"type":"string","description":"Product UUID","x-from-version":"7.0"},"identifier":{"type":"string","description":"Product identifier, i.e. the value of the only `pim_catalog_identifier` attribute"},"enabled":{"type":"boolean","description":"Whether the product is enabled","default":true},"family":{"type":"string","description":"Family code from which the product inherits its attributes and attributes requirements.","x-validation-rules":"It is equal to an existing family code. In the case of variant product, the given family should be the same as the product model family.","default":"null only in the case of a non variant product"},"categories":{"type":"array","description":"Codes of the categories in which the product is classified","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"groups":{"type":"array","description":"Codes of the groups to which the product belong","x-validation-rules":"Each string of the array is equal to an existing group code","items":{"type":"string"},"default":[]},"parent":{"type":"string","description":"Code of the parent product model when the product is a variant (only available since the 2.0). This parent can be modified since the 2.3.","x-validation-rules":"It is equal to an existing product model code only if the product is variant otherwise it's equal to null","default":"null","x-from-version":"2.0"},"values":{"type":"object","description":"Product attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value. See the `data` format section for more details."},"linked_data":{"type":"object","x-read-only":true,"description":"Object containing additional data when a related query parameter is enabled. See the `linked_data` format section for more details. (only available since the 5.0)","x-from-version":"5.0","properties":{"attribute":{"type":"string"},"code":{"type":"string"},"labels":{"type":"object"}}},"attribute_type":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"The type of the value's attribute. See type section for more details."},"reference_data_name":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"Reference entity code when the attribute type is `akeneo_reference_entity` or `akeneo_reference_entity_collection` OR Asset family code when the attribute type is `pim_catalog_asset_collection`","x-warning":"Only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types"}}}}}},"associations":{"type":"object","description":"Several associations related to groups, product models and/or other products, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the identifier of an existing product. • Each string in the array of the property `product_models` is the code of an existing product model.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of product identifiers with which the product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Several quantified associations related to products and/or product models, grouped by quantified association types (only available since the 5.0)","x-validation-rules":"• The `quantifiedAssociationTypeCode` is the code of an existing association type which provides quantity information. • Each object in the array of the property `products` contains the identifier of an existing product and the quantity of it.","x-from-version":"5.0","properties":{"quantifiedAssociationTypeCode":{"type":"object","properties":{"products":{"type":"array","description":"Array of objects containing product identifiers and quantities with which the product is in relation","items":{"type":"object","properties":{"identifier":{"type":"string"},"quantity":{"type":"integer"}}}},"product_models":{"type":"array","description":"Array of objects containing product model codes and quantities with which the product is in relation","items":{"type":"object","properties":{"code":{"type":"string"},"quantity":{"type":"integer"}}}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"metadata":{"type":"object","description":"More information around the product (only available since the v2.0 in the Enterprise Edition)","x-immutable":true,"x-read-only":true,"x-from-version":"2.0","properties":{"workflow_status":{"description":"Status of the product regarding the user permissions","type":"string","enum":["read_only","draft_in_progress","proposal_waiting_for_approval","working_copy"]}}},"quality_scores":{"type":"object","description":"Product quality scores for each channel/locale combination (only available since the 5.0 and when the \"with_quality_scores\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"5.0"},"completenesses":{"type":"array","description":"Product completenesses for each channel/locale combination (only available since the 7.0 version, and when the \"with_completenesses\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"7.0","items":{"type":"object","properties":{"scope":{"type":"string"},"locale":{"type":"string"},"data":{"type":"integer"}}}}},"example":{"identifier":"top","enabled":true,"family":"tshirt","categories":["summer_collection"],"groups":[],"parent":null,"values":{"name":[{"data":"Top","locale":"en_US","scope":null,"attribute_type":"pim_catalog_text"},{"data":"Débardeur","locale":"fr_FR","scope":null,"attribute_type":"pim_catalog_text"}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce","attribute_type":"pim_catalog_textarea"},{"data":"Top","locale":"en_US","scope":"tablet","attribute_type":"pim_catalog_textarea"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce","attribute_type":"pim_catalog_textarea"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet","attribute_type":"pim_catalog_textarea"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}],"attribute_type":"pim_catalog_price_collection"}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}},"attribute_type":"pim_catalog_simpleselect"}],"size":[{"locale":null,"scope":null,"data":"m","linked_data":{"attribute":"size","code":"m","labels":{"en_US":"M","fr_FR":"M"}},"attribute_type":"pim_catalog_simpleselect"}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"],"linked_data":{"winter_2016":{"attribute":"collection","code":"winter_2016","labels":{"en_US":"Winter 2016","fr_FR":"Hiver 2016"}}},"attribute_type":"pim_catalog_multiselect"}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglass"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"cap","quantity":2},{"identifier":"shoes","quantity":1}],"product_models":[{"identifier":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"completenesses":[{"scope":"ecommerce","locale":"en_US","data":10},{"scope":"ecommerce","locale":"fr_FR","data":20},{"scope":"tablet","locale":"en_US","data":30},{"scope":"tablet","locale":"fr_FR","data":40}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"patch":{"summary":"Update/create a product","operationId":"patch_products__code_","tags":["Product [identifier]"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to update a given product. Learn more about Update behavior. Note that if no product exists for the given identifier, it creates it. In the Entreprise Edition, since the v2.0, permissions based on your user groups are applied to the product you try to update. It may result in the creation of a draft if you only have edit rights through the product's categories.","parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"},{"name":"body","in":"body","required":true,"schema":{"type":"object","required":["identifier"],"properties":{"uuid":{"type":"string","description":"Product UUID","x-from-version":"7.0"},"identifier":{"type":"string","description":"Product identifier, i.e. the value of the only `pim_catalog_identifier` attribute"},"enabled":{"type":"boolean","description":"Whether the product is enabled","default":true},"family":{"type":"string","description":"Family code from which the product inherits its attributes and attributes requirements.","x-validation-rules":"It is equal to an existing family code. In the case of variant product, the given family should be the same as the product model family.","default":"null only in the case of a non variant product"},"categories":{"type":"array","description":"Codes of the categories in which the product is classified","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"groups":{"type":"array","description":"Codes of the groups to which the product belong","x-validation-rules":"Each string of the array is equal to an existing group code","items":{"type":"string"},"default":[]},"parent":{"type":"string","description":"Code of the parent product model when the product is a variant (only available since the 2.0). This parent can be modified since the 2.3.","x-validation-rules":"It is equal to an existing product model code only if the product is variant otherwise it's equal to null","default":"null","x-from-version":"2.0"},"values":{"type":"object","description":"Product attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value. See the `data` format section for more details."},"linked_data":{"type":"object","x-read-only":true,"description":"Object containing additional data when a related query parameter is enabled. See the `linked_data` format section for more details. (only available since the 5.0)","x-from-version":"5.0","properties":{"attribute":{"type":"string"},"code":{"type":"string"},"labels":{"type":"object"}}},"attribute_type":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"The type of the value's attribute. See type section for more details."},"reference_data_name":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"Reference entity code when the attribute type is `akeneo_reference_entity` or `akeneo_reference_entity_collection` OR Asset family code when the attribute type is `pim_catalog_asset_collection`","x-warning":"Only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types"}}}}}},"associations":{"type":"object","description":"Several associations related to groups, product models and/or other products, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the identifier of an existing product. • Each string in the array of the property `product_models` is the code of an existing product model.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of product identifiers with which the product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Several quantified associations related to products and/or product models, grouped by quantified association types (only available since the 5.0)","x-validation-rules":"• The `quantifiedAssociationTypeCode` is the code of an existing association type which provides quantity information. • Each object in the array of the property `products` contains the identifier of an existing product and the quantity of it.","x-from-version":"5.0","properties":{"quantifiedAssociationTypeCode":{"type":"object","properties":{"products":{"type":"array","description":"Array of objects containing product identifiers and quantities with which the product is in relation","items":{"type":"object","properties":{"identifier":{"type":"string"},"quantity":{"type":"integer"}}}},"product_models":{"type":"array","description":"Array of objects containing product model codes and quantities with which the product is in relation","items":{"type":"object","properties":{"code":{"type":"string"},"quantity":{"type":"integer"}}}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"metadata":{"type":"object","description":"More information around the product (only available since the v2.0 in the Enterprise Edition)","x-immutable":true,"x-read-only":true,"x-from-version":"2.0","properties":{"workflow_status":{"description":"Status of the product regarding the user permissions","type":"string","enum":["read_only","draft_in_progress","proposal_waiting_for_approval","working_copy"]}}},"quality_scores":{"type":"object","description":"Product quality scores for each channel/locale combination (only available since the 5.0 and when the \"with_quality_scores\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"5.0"},"completenesses":{"type":"array","description":"Product completenesses for each channel/locale combination (only available since the 7.0 version, and when the \"with_completenesses\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"7.0","items":{"type":"object","properties":{"scope":{"type":"string"},"locale":{"type":"string"},"data":{"type":"integer"}}}}},"example":{"identifier":"top","enabled":true,"family":"tshirt","categories":["summer_collection"],"groups":[],"parent":null,"values":{"name":[{"data":"Top","locale":"en_US","scope":null,"attribute_type":"pim_catalog_text"},{"data":"Débardeur","locale":"fr_FR","scope":null,"attribute_type":"pim_catalog_text"}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce","attribute_type":"pim_catalog_textarea"},{"data":"Top","locale":"en_US","scope":"tablet","attribute_type":"pim_catalog_textarea"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce","attribute_type":"pim_catalog_textarea"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet","attribute_type":"pim_catalog_textarea"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}],"attribute_type":"pim_catalog_price_collection"}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}},"attribute_type":"pim_catalog_simpleselect"}],"size":[{"locale":null,"scope":null,"data":"m","linked_data":{"attribute":"size","code":"m","labels":{"en_US":"M","fr_FR":"M"}},"attribute_type":"pim_catalog_simpleselect"}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"],"linked_data":{"winter_2016":{"attribute":"collection","code":"winter_2016","labels":{"en_US":"Winter 2016","fr_FR":"Hiver 2016"}}},"attribute_type":"pim_catalog_multiselect"}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglass"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"cap","quantity":2},{"identifier":"shoes","quantity":1}],"product_models":[{"identifier":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"completenesses":[{"scope":"ecommerce","locale":"en_US","data":10},{"scope":"ecommerce","locale":"fr_FR","data":20},{"scope":"tablet","locale":"en_US","data":30},{"scope":"tablet","locale":"fr_FR","data":40}]}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"204":{"description":"No content to return","x-details":"Means that the update was successful","headers":{"Location":{"description":"URI of the updated resource","type":"string"}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}},"delete":{"summary":"Delete a product","operationId":"delete_products__code_","tags":["Product [identifier]"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to delete a given product. In the Enterprise Edition, since the 2.0, permissions based on your user groups are applied to the product you try to delete.","parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"204":{"description":"No content to return","x-details":"Means that the deletion was successful"},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}}}}},"/api/rest/v1/products/{code}/proposal":{"post":{"summary":"Submit a draft for approval","operationId":"post_proposal","tags":["Product [identifier]"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"description":"This endpoint allows you to submit a draft for approval.","parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"201":{"description":"Submitted","x-details":"Means that the draft submission was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/products/{code}/draft":{"get":{"summary":"Get a draft","operationId":"get_draft__code_","tags":["Product [identifier]"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"description":"This endpoint allows you to get the information about a given draft.","parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the draft in JSON standard format","schema":{"type":"object","required":["identifier"],"properties":{"uuid":{"type":"string","description":"Product UUID","x-from-version":"7.0"},"identifier":{"type":"string","description":"Product identifier, i.e. the value of the only `pim_catalog_identifier` attribute"},"enabled":{"type":"boolean","description":"Whether the product is enabled","default":true},"family":{"type":"string","description":"Family code from which the product inherits its attributes and attributes requirements.","x-validation-rules":"It is equal to an existing family code. In the case of variant product, the given family should be the same as the product model family.","default":"null only in the case of a non variant product"},"categories":{"type":"array","description":"Codes of the categories in which the product is classified","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"groups":{"type":"array","description":"Codes of the groups to which the product belong","x-validation-rules":"Each string of the array is equal to an existing group code","items":{"type":"string"},"default":[]},"parent":{"type":"string","description":"Code of the parent product model when the product is a variant (only available since the 2.0). This parent can be modified since the 2.3.","x-validation-rules":"It is equal to an existing product model code only if the product is variant otherwise it's equal to null","default":"null","x-from-version":"2.0"},"values":{"type":"object","description":"Product attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value. See the `data` format section for more details."},"linked_data":{"type":"object","x-read-only":true,"description":"Object containing additional data when a related query parameter is enabled. See the `linked_data` format section for more details. (only available since the 5.0)","x-from-version":"5.0","properties":{"attribute":{"type":"string"},"code":{"type":"string"},"labels":{"type":"object"}}},"attribute_type":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"The type of the value's attribute. See type section for more details."},"reference_data_name":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"Reference entity code when the attribute type is `akeneo_reference_entity` or `akeneo_reference_entity_collection` OR Asset family code when the attribute type is `pim_catalog_asset_collection`","x-warning":"Only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types"}}}}}},"associations":{"type":"object","description":"Several associations related to groups, product models and/or other products, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the identifier of an existing product. • Each string in the array of the property `product_models` is the code of an existing product model.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of product identifiers with which the product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Several quantified associations related to products and/or product models, grouped by quantified association types (only available since the 5.0)","x-validation-rules":"• The `quantifiedAssociationTypeCode` is the code of an existing association type which provides quantity information. • Each object in the array of the property `products` contains the identifier of an existing product and the quantity of it.","x-from-version":"5.0","properties":{"quantifiedAssociationTypeCode":{"type":"object","properties":{"products":{"type":"array","description":"Array of objects containing product identifiers and quantities with which the product is in relation","items":{"type":"object","properties":{"identifier":{"type":"string"},"quantity":{"type":"integer"}}}},"product_models":{"type":"array","description":"Array of objects containing product model codes and quantities with which the product is in relation","items":{"type":"object","properties":{"code":{"type":"string"},"quantity":{"type":"integer"}}}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"metadata":{"type":"object","description":"More information around the product (only available since the v2.0 in the Enterprise Edition)","x-immutable":true,"x-read-only":true,"x-from-version":"2.0","properties":{"workflow_status":{"description":"Status of the product regarding the user permissions","type":"string","enum":["read_only","draft_in_progress","proposal_waiting_for_approval","working_copy"]}}},"quality_scores":{"type":"object","description":"Product quality scores for each channel/locale combination (only available since the 5.0 and when the \"with_quality_scores\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"5.0"},"completenesses":{"type":"array","description":"Product completenesses for each channel/locale combination (only available since the 7.0 version, and when the \"with_completenesses\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"7.0","items":{"type":"object","properties":{"scope":{"type":"string"},"locale":{"type":"string"},"data":{"type":"integer"}}}}},"example":{"identifier":"top","enabled":true,"family":"tshirt","categories":["summer_collection"],"groups":[],"parent":null,"values":{"name":[{"data":"Top","locale":"en_US","scope":null,"attribute_type":"pim_catalog_text"},{"data":"Débardeur","locale":"fr_FR","scope":null,"attribute_type":"pim_catalog_text"}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce","attribute_type":"pim_catalog_textarea"},{"data":"Top","locale":"en_US","scope":"tablet","attribute_type":"pim_catalog_textarea"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce","attribute_type":"pim_catalog_textarea"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet","attribute_type":"pim_catalog_textarea"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}],"attribute_type":"pim_catalog_price_collection"}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}},"attribute_type":"pim_catalog_simpleselect"}],"size":[{"locale":null,"scope":null,"data":"m","linked_data":{"attribute":"size","code":"m","labels":{"en_US":"M","fr_FR":"M"}},"attribute_type":"pim_catalog_simpleselect"}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"],"linked_data":{"winter_2016":{"attribute":"collection","code":"winter_2016","labels":{"en_US":"Winter 2016","fr_FR":"Hiver 2016"}}},"attribute_type":"pim_catalog_multiselect"}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglass"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"cap","quantity":2},{"identifier":"shoes","quantity":1}],"product_models":[{"identifier":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"completenesses":[{"scope":"ecommerce","locale":"en_US","data":10},{"scope":"ecommerce","locale":"fr_FR","data":20},{"scope":"tablet","locale":"en_US","data":30},{"scope":"tablet","locale":"fr_FR","data":40}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}}},"/api/rest/v1/product-models":{"get":{"summary":"Get list of product models","operationId":"get_product_models","tags":["Product model"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to get a list of product models. Product models are paginated. In the Enterprise Edition, since the 2.0, permissions based on your user groups are applied to the set of products you request.","parameters":[{"name":"search","in":"query","description":"Filter product models, for more details see the Filters section","required":false,"type":"string"},{"name":"scope","in":"query","type":"string","description":"Filter product values to return scopable attributes for the given channel as well as the non localizable/non scopable attributes, for more details see the Filter product values via channel section","required":false},{"name":"locales","in":"query","type":"string","description":"Filter product values to return localizable attributes for the given locales as well as the non localizable/non scopable attributes, for more details see the Filter product values via locale section","required":false},{"name":"attributes","in":"query","type":"string","description":"Filter product values to only return those concerning the given attributes, for more details see the Filter on product values section and the Filter on product model properties section","required":false},{"name":"pagination_type","in":"query","description":"Pagination method type, see Pagination section","required":false,"type":"string","default":"page","x-validation-rules":"One of the following values","enum":["page","search_after"]},{"name":"page","in":"query","description":"Number of the page to retrieve when using the `page` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"integer","default":1},{"name":"search_after","in":"query","description":"Cursor when using the `search_after` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"string","default":"cursor to the first page"},{"name":"limit","in":"query","description":"Number of results by page, see Pagination section","required":false,"type":"integer","minimum":1,"maximum":100,"default":10},{"name":"with_count","in":"query","description":"Return the count of items in the response. Be carefull with that, on a big catalog, it can decrease performance in a significative way","default":false,"type":"boolean","required":false},{"name":"with_attribute_options","in":"query","description":"Return labels of attribute options in the response. (Only available on SaaS platforms)","default":false,"type":"boolean","required":false,"x-from-version":"SaaS"},{"name":"with_asset_share_links","in":"query","description":"Return asset collection share link urls in the response. See the `linked_data` format section for more details. (Only available in the SaaS version)","default":false,"type":"boolean","required":false,"x-from-version":"SaaS"},{"name":"with_quality_scores","in":"query","description":"Return product model quality scores in the response. (Only available since the 6.0 version)","type":"boolean","required":false,"x-from-version":"6.0"}],"responses":{"200":{"description":"Return product models paginated","schema":{"title":"Product Models","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"previous":{"type":"object","properties":{"href":{"type":"string","description":"URI of the previous page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}},"current_page":{"type":"integer","description":"Current page number"}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code","family_variant"],"properties":{"code":{"type":"string","description":"Product model code","x-immutable":true},"family":{"type":"string","description":"Family code from which the product inherits its attributes and attributes requirements (since the 3.2)","x-validation-rules":"It is equal to an existing family code","x-immutable":true,"x-from-version":"3.2"},"family_variant":{"type":"string","description":"Family variant code from which the product model inherits its attributes and variant attributes","x-validation-rules":"It is equal to an existing family variant code that belong to the family given in the `family` field","x-immutable":true},"parent":{"type":"string","description":"Code of the parent product model. This parent can be modified since the 2.3.","x-validation-rules":"• It is equal to an existing product model code • This product model has the same family variant as the one given in the `family_variant field`","default":"null","x-from-version":"2.3"},"categories":{"type":"array","description":"Codes of the categories in which the product model is categorized","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"values":{"type":"object","description":"Product model attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value"},"linked_data":{"type":"object","x-read-only":true,"description":"Object containing additional data when a related query parameter is enabled. See the `linked_data` format section for more details. (only available since the 5.0)","x-from-version":"SaaS","properties":{"attribute":{"type":"string"},"code":{"type":"string"},"labels":{"type":"object"}}}}}}}},"associations":{"type":"object","description":"Several associations related to groups, product and/or other product models, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the identifier of an existing product. • Each string in the array of the property `product_models` is the code of an existing product model.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of product identifiers with which the product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Several quantified associations related to products and/or product models, grouped by quantified association types (only available since the 5.0)","x-validation-rules":"• The `quantifiedAssociationTypeCode` is the code of an existing association type which provides quantity information. • Each object in the array of the property `products` contains the identifier of an existing product and the quantity of it. • Each object in the array of the property `product_models` contains the code of an existing product model and the quantity of it.","x-from-version":"5.0","properties":{"quantifiedAssociationTypeCode":{"type":"object","properties":{"products":{"type":"array","description":"Array of objects containing product identifiers and quantities with which the product model is in relation","items":{"type":"object","properties":{"identifier":{"type":"string"},"quantity":{"type":"integer"}}}},"product_models":{"type":"array","description":"Array of objects containing product model codes and quantities with which the product model is in relation","items":{"type":"object","properties":{"code":{"type":"string"},"quantity":{"type":"integer"}}}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"metadata":{"type":"object","description":"More information around the product model (only available since the v2.3 in the Enterprise Edition)","x-immutable":true,"x-read-only":true,"x-from-version":"2.3","properties":{"workflow_status":{"description":"Status of the product model regarding the user permissions","type":"string","enum":["read_only","draft_in_progress","proposal_waiting_for_approval","working_copy"]}}},"quality_scores":{"type":"object","description":"Product model quality scores for each channel/locale combination (only available since the 7.0 version and when the \"with_quality_scores\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"7.0"}},"example":{"code":"model-biker-jacket-leather","family":"clothing","family_variant":"clothing_material_size","parent":"model-biker-jacket","categories":["summer_collection"],"values":{"color":[{"locale":null,"scope":null,"data":"antique_white"}],"material":[{"locale":null,"scope":null,"data":"leather"}],"variation_name":[{"locale":"en_US","scope":null,"data":"Biker jacket leather"}],"name":[{"locale":"en_US","scope":null,"data":"Biker jacket"}],"collection":[{"locale":null,"scope":null,"data":["summer_2017"]}],"description":[{"locale":"en_US","scope":"ecommerce","data":"Biker jacket"}]},"associations":{"PACK":{"products":["sunglass"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"top","quantity":2},{"identifier":"cap","quantity":1}],"product_models":[{"code":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"created":"2017-10-02T15:03:55+02:00","updated":"2017-10-02T15:03:55+02:00"}}]}}}}}}]},"examples":{"_links":{"self":{"href":"http://demo.akeneo.com/api/rest/v1/product-models?pagination_type=search_after&limit=3&search_after=qg%3D%3D"},"first":{"href":"http://demo.akeneo.com/api/rest/v1/product-models?pagination_type=search_after&limit=3"},"next":{"href":"http://demo.akeneo.com/api/rest/v1/product-models?pagination_type=search_after&limit=3&search_after=rw%3D%3D"}},"_embedded":{"items":[{"_links":{"self":{"href":"http://demo.akeneo.com/api/rest/v1/product-models/amarisshoe"}},"code":"amarisshoe","family":"shoes","family_variant":"shoes_VariantA1","parent":null,"categories":["clothing","shoes"],"values":{"price":[{"locale":null,"scope":null,"data":[{"amount":"50.00","currency":"EUR"}]}],"description":[{"locale":"en_US","scope":"ecommerce","data":"I like shoes!"}]},"associations":{"PACK":{"products":["sunglasses"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"cap","quantity":2},{"identifier":"shoes","quantity":1}],"product_models":[{"identifier":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"created":"2017-10-04T18:04:10+02:00","updated":"2017-10-04T18:04:10+02:00"},{"_links":{"self":{"href":"http://demo.akeneo.com/api/rest/v1/product-models/Abiloitshirt"}},"code":"Abiloitshirt","family":"clothing","family_variant":"clothing_VariantA1","parent":null,"categories":["clothing","tshirt"],"values":{"price":[{"locale":null,"scope":null,"data":[{"amount":"50.00","currency":"EUR"}]}],"description":[{"locale":"en_US","scope":"ecommerce","data":"I like tshirt!"}]},"associations":{"PACK":{"products":["sunglasses"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"cap","quantity":2}],"product_models":[]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"created":"2017-10-04T18:04:10+02:00","updated":"2017-10-04T18:04:10+02:00"},{"_links":{"self":{"href":"http://demo.akeneo.com/api/rest/v1/product-models/Astertrousers"}},"code":"Astertrousers","family":"clothing","family_variant":"clothing_VariantA1","parent":null,"categories":["clothing","trousers"],"values":{"price":[{"locale":null,"scope":null,"data":[{"amount":"50.00","currency":"EUR"}]}],"description":[{"locale":"en_US","scope":"ecommerce","data":"I like trousers!"}]},"associations":{"PACK":{"products":["sunglasses"],"product_models":[],"groups":[]}},"quantified_associations":{},"created":"2017-10-04T18:04:10+02:00","updated":"2017-10-04T18:04:10+02:00"}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}},"post":{"summary":"Create a new product model","operationId":"post_product_models","tags":["Product model"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to create a new product model. In the Enterprise Edition, since the v2.3, permissions based on your user groups are applied to the product model you try to create.","parameters":[{"name":"body","in":"body","schema":{"type":"object","required":["code","family_variant"],"properties":{"code":{"type":"string","description":"Product model code","x-immutable":true},"family":{"type":"string","description":"Family code from which the product inherits its attributes and attributes requirements (since the 3.2)","x-validation-rules":"It is equal to an existing family code","x-immutable":true,"x-from-version":"3.2"},"family_variant":{"type":"string","description":"Family variant code from which the product model inherits its attributes and variant attributes","x-validation-rules":"It is equal to an existing family variant code that belong to the family given in the `family` field","x-immutable":true},"parent":{"type":"string","description":"Code of the parent product model. This parent can be modified since the 2.3.","x-validation-rules":"• It is equal to an existing product model code • This product model has the same family variant as the one given in the `family_variant field`","default":"null","x-from-version":"2.3"},"categories":{"type":"array","description":"Codes of the categories in which the product model is categorized","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"values":{"type":"object","description":"Product model attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value"},"linked_data":{"type":"object","x-read-only":true,"description":"Object containing additional data when a related query parameter is enabled. See the `linked_data` format section for more details. (only available since the 5.0)","x-from-version":"SaaS","properties":{"attribute":{"type":"string"},"code":{"type":"string"},"labels":{"type":"object"}}}}}}}},"associations":{"type":"object","description":"Several associations related to groups, product and/or other product models, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the identifier of an existing product. • Each string in the array of the property `product_models` is the code of an existing product model.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of product identifiers with which the product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Several quantified associations related to products and/or product models, grouped by quantified association types (only available since the 5.0)","x-validation-rules":"• The `quantifiedAssociationTypeCode` is the code of an existing association type which provides quantity information. • Each object in the array of the property `products` contains the identifier of an existing product and the quantity of it. • Each object in the array of the property `product_models` contains the code of an existing product model and the quantity of it.","x-from-version":"5.0","properties":{"quantifiedAssociationTypeCode":{"type":"object","properties":{"products":{"type":"array","description":"Array of objects containing product identifiers and quantities with which the product model is in relation","items":{"type":"object","properties":{"identifier":{"type":"string"},"quantity":{"type":"integer"}}}},"product_models":{"type":"array","description":"Array of objects containing product model codes and quantities with which the product model is in relation","items":{"type":"object","properties":{"code":{"type":"string"},"quantity":{"type":"integer"}}}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"metadata":{"type":"object","description":"More information around the product model (only available since the v2.3 in the Enterprise Edition)","x-immutable":true,"x-read-only":true,"x-from-version":"2.3","properties":{"workflow_status":{"description":"Status of the product model regarding the user permissions","type":"string","enum":["read_only","draft_in_progress","proposal_waiting_for_approval","working_copy"]}}},"quality_scores":{"type":"object","description":"Product model quality scores for each channel/locale combination (only available since the 7.0 version and when the \"with_quality_scores\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"7.0"}},"example":{"code":"model-biker-jacket-leather","family":"clothing","family_variant":"clothing_material_size","parent":"model-biker-jacket","categories":["summer_collection"],"values":{"color":[{"locale":null,"scope":null,"data":"antique_white"}],"material":[{"locale":null,"scope":null,"data":"leather"}],"variation_name":[{"locale":"en_US","scope":null,"data":"Biker jacket leather"}],"name":[{"locale":"en_US","scope":null,"data":"Biker jacket"}],"collection":[{"locale":null,"scope":null,"data":["summer_2017"]}],"description":[{"locale":"en_US","scope":"ecommerce","data":"Biker jacket"}]},"associations":{"PACK":{"products":["sunglass"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"top","quantity":2},{"identifier":"cap","quantity":1}],"product_models":[{"code":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"created":"2017-10-02T15:03:55+02:00","updated":"2017-10-02T15:03:55+02:00"}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}},"patch":{"summary":"Update/create several product models","operationId":"patch_product_models","tags":["Product model"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to update and/or create several product models at once. Learn more about Update behavior. Note that if no product models exists for the given code, it creates it. In the Enterprise Edition, since the v2.3, permissions based on your user groups are applied to the product models you try to update. It may result in the creation of drafts if you only have edit rights through the product model's categories.","x-body-by-line":"Contains several lines, each line is a product model in JSON standard format","parameters":[{"name":"body","in":"body","schema":{"x-examples":{"x-example-1":"{\"code\": \"sub_sweat_option_a\", \"parent\": \"sweat\", \"values\": {\"a_simple_select\": [{\"locale\": null, \"scope\": null, \"data\": \"optionA\"}]}}","x-example-2":"{\"code\": \"sub_sweat_option_b\", \"parent\": \"sweat\", \"values\": {\"a_simple_select\": [{\"locale\": null, \"scope\": null, \"data\": \"optionA\"}]}}","x-example-3":"{\"code\":\"tshirt\", \"parent\": \"root_tshirt\", \"family_variant\":\"clothesvariant\",\"values\":{\"description\":[{\"scope\":\"ecommerce\",\"locale\":\"en_US\",\"data\":\"My amazing tshirt\"}]}}"},"type":"object","required":["code","family_variant"],"properties":{"code":{"type":"string","description":"Product model code","x-immutable":true},"family":{"type":"string","description":"Family code from which the product inherits its attributes and attributes requirements (since the 3.2)","x-validation-rules":"It is equal to an existing family code","x-immutable":true,"x-from-version":"3.2"},"family_variant":{"type":"string","description":"Family variant code from which the product model inherits its attributes and variant attributes","x-validation-rules":"It is equal to an existing family variant code that belong to the family given in the `family` field","x-immutable":true},"parent":{"type":"string","description":"Code of the parent product model. This parent can be modified since the 2.3.","x-validation-rules":"• It is equal to an existing product model code • This product model has the same family variant as the one given in the `family_variant field`","default":"null","x-from-version":"2.3"},"categories":{"type":"array","description":"Codes of the categories in which the product model is categorized","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"values":{"type":"object","description":"Product model attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value"},"linked_data":{"type":"object","x-read-only":true,"description":"Object containing additional data when a related query parameter is enabled. See the `linked_data` format section for more details. (only available since the 5.0)","x-from-version":"SaaS","properties":{"attribute":{"type":"string"},"code":{"type":"string"},"labels":{"type":"object"}}}}}}}},"associations":{"type":"object","description":"Several associations related to groups, product and/or other product models, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the identifier of an existing product. • Each string in the array of the property `product_models` is the code of an existing product model.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of product identifiers with which the product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Several quantified associations related to products and/or product models, grouped by quantified association types (only available since the 5.0)","x-validation-rules":"• The `quantifiedAssociationTypeCode` is the code of an existing association type which provides quantity information. • Each object in the array of the property `products` contains the identifier of an existing product and the quantity of it. • Each object in the array of the property `product_models` contains the code of an existing product model and the quantity of it.","x-from-version":"5.0","properties":{"quantifiedAssociationTypeCode":{"type":"object","properties":{"products":{"type":"array","description":"Array of objects containing product identifiers and quantities with which the product model is in relation","items":{"type":"object","properties":{"identifier":{"type":"string"},"quantity":{"type":"integer"}}}},"product_models":{"type":"array","description":"Array of objects containing product model codes and quantities with which the product model is in relation","items":{"type":"object","properties":{"code":{"type":"string"},"quantity":{"type":"integer"}}}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"metadata":{"type":"object","description":"More information around the product model (only available since the v2.3 in the Enterprise Edition)","x-immutable":true,"x-read-only":true,"x-from-version":"2.3","properties":{"workflow_status":{"description":"Status of the product model regarding the user permissions","type":"string","enum":["read_only","draft_in_progress","proposal_waiting_for_approval","working_copy"]}}},"quality_scores":{"type":"object","description":"Product model quality scores for each channel/locale combination (only available since the 7.0 version and when the \"with_quality_scores\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"7.0"}},"example":{"code":"model-biker-jacket-leather","family":"clothing","family_variant":"clothing_material_size","parent":"model-biker-jacket","categories":["summer_collection"],"values":{"color":[{"locale":null,"scope":null,"data":"antique_white"}],"material":[{"locale":null,"scope":null,"data":"leather"}],"variation_name":[{"locale":"en_US","scope":null,"data":"Biker jacket leather"}],"name":[{"locale":"en_US","scope":null,"data":"Biker jacket"}],"collection":[{"locale":null,"scope":null,"data":["summer_2017"]}],"description":[{"locale":"en_US","scope":"ecommerce","data":"Biker jacket"}]},"associations":{"PACK":{"products":["sunglass"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"top","quantity":2},{"identifier":"cap","quantity":1}],"product_models":[{"code":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"created":"2017-10-02T15:03:55+02:00","updated":"2017-10-02T15:03:55+02:00"}}}],"responses":{"200":{"description":"OK","x-details":"Returns a plain text response whose lines are JSON containing the status of each update or creation","x-no-entity":true,"schema":{"type":"object","properties":{"line":{"type":"integer","description":"Line number"},"identifier":{"type":"string","description":"Resource identifier, only filled when the resource is a product"},"code":{"type":"string","description":"Resource code, only filled when the resource is not a product"},"status_code":{"type":"integer","description":"HTTP status code, see Client errors to understand the meaning of each code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"x-example-1":"{\"line\":1,\"code\":\"sub_sweat_option_a\",\"status_code\":204}","x-example-2":"{\"line\":2,\"code\":\"sub_sweat_option_b\",\"status_code\":422,\"message\":\"Validation failed.\",\"errors\":[{\"property\":\"attribute\",\"message\":\"Cannot set value \\\"Option A\\\" for the attribute axis \\\"a_simple_select\\\", as another sibling entity already has this value\"}]}","x-example-3":"{\"line\":3,\"code\":\"tshirt\",\"status_code\":201}"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"413":{"description":"Request Entity Too Large","x-details":"There are too many resources to process (max 100) or the line of JSON is too long (max 1 000 000 characters)","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":413,"message":"Too many resources to process, 100 is the maximum allowed."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/vnd.akeneo.collection+json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/vnd.akeneo.collection+json’ is allowed."}}}}},"/api/rest/v1/product-models/{code}":{"get":{"summary":"Get a product model","operationId":"get_product_models__code_","tags":["Product model"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to get the information about a given product model. In the Entreprise Edition, since the v2.0, permissions based on your user groups are applied to the product model you request.","parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"},{"name":"with_asset_share_links","in":"query","description":"Return asset collection share link urls in the response. See the `linked_data` format section for more details. (Only available in the SaaS version)","default":false,"type":"boolean","required":false,"x-from-version":"SaaS"},{"name":"with_quality_scores","in":"query","description":"Return product model quality scores in the response. (Only available since the 6.0 version)","type":"boolean","required":false,"x-from-version":"6.0"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the product model in JSON standard format.","schema":{"type":"object","required":["code","family_variant"],"properties":{"code":{"type":"string","description":"Product model code","x-immutable":true},"family":{"type":"string","description":"Family code from which the product inherits its attributes and attributes requirements (since the 3.2)","x-validation-rules":"It is equal to an existing family code","x-immutable":true,"x-from-version":"3.2"},"family_variant":{"type":"string","description":"Family variant code from which the product model inherits its attributes and variant attributes","x-validation-rules":"It is equal to an existing family variant code that belong to the family given in the `family` field","x-immutable":true},"parent":{"type":"string","description":"Code of the parent product model. This parent can be modified since the 2.3.","x-validation-rules":"• It is equal to an existing product model code • This product model has the same family variant as the one given in the `family_variant field`","default":"null","x-from-version":"2.3"},"categories":{"type":"array","description":"Codes of the categories in which the product model is categorized","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"values":{"type":"object","description":"Product model attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value"},"linked_data":{"type":"object","x-read-only":true,"description":"Object containing additional data when a related query parameter is enabled. See the `linked_data` format section for more details. (only available since the 5.0)","x-from-version":"SaaS","properties":{"attribute":{"type":"string"},"code":{"type":"string"},"labels":{"type":"object"}}}}}}}},"associations":{"type":"object","description":"Several associations related to groups, product and/or other product models, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the identifier of an existing product. • Each string in the array of the property `product_models` is the code of an existing product model.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of product identifiers with which the product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Several quantified associations related to products and/or product models, grouped by quantified association types (only available since the 5.0)","x-validation-rules":"• The `quantifiedAssociationTypeCode` is the code of an existing association type which provides quantity information. • Each object in the array of the property `products` contains the identifier of an existing product and the quantity of it. • Each object in the array of the property `product_models` contains the code of an existing product model and the quantity of it.","x-from-version":"5.0","properties":{"quantifiedAssociationTypeCode":{"type":"object","properties":{"products":{"type":"array","description":"Array of objects containing product identifiers and quantities with which the product model is in relation","items":{"type":"object","properties":{"identifier":{"type":"string"},"quantity":{"type":"integer"}}}},"product_models":{"type":"array","description":"Array of objects containing product model codes and quantities with which the product model is in relation","items":{"type":"object","properties":{"code":{"type":"string"},"quantity":{"type":"integer"}}}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"metadata":{"type":"object","description":"More information around the product model (only available since the v2.3 in the Enterprise Edition)","x-immutable":true,"x-read-only":true,"x-from-version":"2.3","properties":{"workflow_status":{"description":"Status of the product model regarding the user permissions","type":"string","enum":["read_only","draft_in_progress","proposal_waiting_for_approval","working_copy"]}}},"quality_scores":{"type":"object","description":"Product model quality scores for each channel/locale combination (only available since the 7.0 version and when the \"with_quality_scores\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"7.0"}},"example":{"code":"model-biker-jacket-leather","family":"clothing","family_variant":"clothing_material_size","parent":"model-biker-jacket","categories":["summer_collection"],"values":{"color":[{"locale":null,"scope":null,"data":"antique_white"}],"material":[{"locale":null,"scope":null,"data":"leather"}],"variation_name":[{"locale":"en_US","scope":null,"data":"Biker jacket leather"}],"name":[{"locale":"en_US","scope":null,"data":"Biker jacket"}],"collection":[{"locale":null,"scope":null,"data":["summer_2017"]}],"description":[{"locale":"en_US","scope":"ecommerce","data":"Biker jacket"}]},"associations":{"PACK":{"products":["sunglass"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"top","quantity":2},{"identifier":"cap","quantity":1}],"product_models":[{"code":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"created":"2017-10-02T15:03:55+02:00","updated":"2017-10-02T15:03:55+02:00"}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"patch":{"summary":"Update/create a product model","operationId":"patch_product_models__code_","tags":["Product model"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to update a given product model. Learn more about Update behavior. Note that if no product model exists for the given code, it creates it. In the Enterprise Edition PIM since the 2.3, permissions based on your user groups are applied to the product model you try to update. It may result in the creation of a draft if you only have edit rights through the product model's categories.","parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"},{"name":"body","in":"body","required":true,"schema":{"type":"object","required":["code","family_variant"],"properties":{"code":{"type":"string","description":"Product model code","x-immutable":true},"family":{"type":"string","description":"Family code from which the product inherits its attributes and attributes requirements (since the 3.2)","x-validation-rules":"It is equal to an existing family code","x-immutable":true,"x-from-version":"3.2"},"family_variant":{"type":"string","description":"Family variant code from which the product model inherits its attributes and variant attributes","x-validation-rules":"It is equal to an existing family variant code that belong to the family given in the `family` field","x-immutable":true},"parent":{"type":"string","description":"Code of the parent product model. This parent can be modified since the 2.3.","x-validation-rules":"• It is equal to an existing product model code • This product model has the same family variant as the one given in the `family_variant field`","default":"null","x-from-version":"2.3"},"categories":{"type":"array","description":"Codes of the categories in which the product model is categorized","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"values":{"type":"object","description":"Product model attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value"},"linked_data":{"type":"object","x-read-only":true,"description":"Object containing additional data when a related query parameter is enabled. See the `linked_data` format section for more details. (only available since the 5.0)","x-from-version":"SaaS","properties":{"attribute":{"type":"string"},"code":{"type":"string"},"labels":{"type":"object"}}}}}}}},"associations":{"type":"object","description":"Several associations related to groups, product and/or other product models, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the identifier of an existing product. • Each string in the array of the property `product_models` is the code of an existing product model.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of product identifiers with which the product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Several quantified associations related to products and/or product models, grouped by quantified association types (only available since the 5.0)","x-validation-rules":"• The `quantifiedAssociationTypeCode` is the code of an existing association type which provides quantity information. • Each object in the array of the property `products` contains the identifier of an existing product and the quantity of it. • Each object in the array of the property `product_models` contains the code of an existing product model and the quantity of it.","x-from-version":"5.0","properties":{"quantifiedAssociationTypeCode":{"type":"object","properties":{"products":{"type":"array","description":"Array of objects containing product identifiers and quantities with which the product model is in relation","items":{"type":"object","properties":{"identifier":{"type":"string"},"quantity":{"type":"integer"}}}},"product_models":{"type":"array","description":"Array of objects containing product model codes and quantities with which the product model is in relation","items":{"type":"object","properties":{"code":{"type":"string"},"quantity":{"type":"integer"}}}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"metadata":{"type":"object","description":"More information around the product model (only available since the v2.3 in the Enterprise Edition)","x-immutable":true,"x-read-only":true,"x-from-version":"2.3","properties":{"workflow_status":{"description":"Status of the product model regarding the user permissions","type":"string","enum":["read_only","draft_in_progress","proposal_waiting_for_approval","working_copy"]}}},"quality_scores":{"type":"object","description":"Product model quality scores for each channel/locale combination (only available since the 7.0 version and when the \"with_quality_scores\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"7.0"}},"example":{"code":"model-biker-jacket-leather","family":"clothing","family_variant":"clothing_material_size","parent":"model-biker-jacket","categories":["summer_collection"],"values":{"color":[{"locale":null,"scope":null,"data":"antique_white"}],"material":[{"locale":null,"scope":null,"data":"leather"}],"variation_name":[{"locale":"en_US","scope":null,"data":"Biker jacket leather"}],"name":[{"locale":"en_US","scope":null,"data":"Biker jacket"}],"collection":[{"locale":null,"scope":null,"data":["summer_2017"]}],"description":[{"locale":"en_US","scope":"ecommerce","data":"Biker jacket"}]},"associations":{"PACK":{"products":["sunglass"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"top","quantity":2},{"identifier":"cap","quantity":1}],"product_models":[{"code":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"created":"2017-10-02T15:03:55+02:00","updated":"2017-10-02T15:03:55+02:00"}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"204":{"description":"No content to return","x-details":"Means that the update was successful","headers":{"Location":{"description":"URI of the updated resource","type":"string"}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}},"delete":{"summary":"Delete a product model","operationId":"delete_product_models__code_","tags":["Product model"],"x-versions":["6.0","7.0","SaaS"],"description":"This endpoint allows you to delete a given product model. All its children, product models and variant products, will be also deleted. In the Enterprise Edition, the permissions based on your connection user group are applied to the product model you try to delete.","parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"204":{"description":"No content to return","x-details":"Means that the deletion was successful"},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}}}}},"/api/rest/v1/product-models/{code}/proposal":{"post":{"summary":"Submit a draft for approval","operationId":"post_product_model_proposal","tags":["Product model"],"x-versions":["2.3","3.x","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"description":"This endpoint allows you to submit a product model draft for approval.","parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"201":{"description":"Submitted","x-details":"Means that the draft submission was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/product-models/{code}/draft":{"get":{"summary":"Get a draft","operationId":"get_product_model_draft__code_","tags":["Product model"],"x-versions":["2.3","3.x","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"description":"This endpoint allows you to get the information about a given product model draft.","parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the draft in JSON standard format","schema":{"type":"object","required":["code","family_variant"],"properties":{"code":{"type":"string","description":"Product model code","x-immutable":true},"family":{"type":"string","description":"Family code from which the product inherits its attributes and attributes requirements (since the 3.2)","x-validation-rules":"It is equal to an existing family code","x-immutable":true,"x-from-version":"3.2"},"family_variant":{"type":"string","description":"Family variant code from which the product model inherits its attributes and variant attributes","x-validation-rules":"It is equal to an existing family variant code that belong to the family given in the `family` field","x-immutable":true},"parent":{"type":"string","description":"Code of the parent product model. This parent can be modified since the 2.3.","x-validation-rules":"• It is equal to an existing product model code • This product model has the same family variant as the one given in the `family_variant field`","default":"null","x-from-version":"2.3"},"categories":{"type":"array","description":"Codes of the categories in which the product model is categorized","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"values":{"type":"object","description":"Product model attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value"},"linked_data":{"type":"object","x-read-only":true,"description":"Object containing additional data when a related query parameter is enabled. See the `linked_data` format section for more details. (only available since the 5.0)","x-from-version":"SaaS","properties":{"attribute":{"type":"string"},"code":{"type":"string"},"labels":{"type":"object"}}}}}}}},"associations":{"type":"object","description":"Several associations related to groups, product and/or other product models, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the identifier of an existing product. • Each string in the array of the property `product_models` is the code of an existing product model.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of product identifiers with which the product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Several quantified associations related to products and/or product models, grouped by quantified association types (only available since the 5.0)","x-validation-rules":"• The `quantifiedAssociationTypeCode` is the code of an existing association type which provides quantity information. • Each object in the array of the property `products` contains the identifier of an existing product and the quantity of it. • Each object in the array of the property `product_models` contains the code of an existing product model and the quantity of it.","x-from-version":"5.0","properties":{"quantifiedAssociationTypeCode":{"type":"object","properties":{"products":{"type":"array","description":"Array of objects containing product identifiers and quantities with which the product model is in relation","items":{"type":"object","properties":{"identifier":{"type":"string"},"quantity":{"type":"integer"}}}},"product_models":{"type":"array","description":"Array of objects containing product model codes and quantities with which the product model is in relation","items":{"type":"object","properties":{"code":{"type":"string"},"quantity":{"type":"integer"}}}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"metadata":{"type":"object","description":"More information around the product model (only available since the v2.3 in the Enterprise Edition)","x-immutable":true,"x-read-only":true,"x-from-version":"2.3","properties":{"workflow_status":{"description":"Status of the product model regarding the user permissions","type":"string","enum":["read_only","draft_in_progress","proposal_waiting_for_approval","working_copy"]}}},"quality_scores":{"type":"object","description":"Product model quality scores for each channel/locale combination (only available since the 7.0 version and when the \"with_quality_scores\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"7.0"}},"example":{"code":"model-biker-jacket-leather","family":"clothing","family_variant":"clothing_material_size","parent":"model-biker-jacket","categories":["summer_collection"],"values":{"color":[{"locale":null,"scope":null,"data":"antique_white"}],"material":[{"locale":null,"scope":null,"data":"leather"}],"variation_name":[{"locale":"en_US","scope":null,"data":"Biker jacket leather"}],"name":[{"locale":"en_US","scope":null,"data":"Biker jacket"}],"collection":[{"locale":null,"scope":null,"data":["summer_2017"]}],"description":[{"locale":"en_US","scope":"ecommerce","data":"Biker jacket"}]},"associations":{"PACK":{"products":["sunglass"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"top","quantity":2},{"identifier":"cap","quantity":1}],"product_models":[{"code":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"created":"2017-10-02T15:03:55+02:00","updated":"2017-10-02T15:03:55+02:00"}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}}},"/api/rest/v1/published-products":{"get":{"summary":"Get list of published products","operationId":"get_published_products","description":"This endpoint allows you to get a list of published products. Published products are paginated and they can be filtered.","tags":["Published product"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"parameters":[{"name":"search","in":"query","description":"Filter published products, for more details see the Filters section","required":false,"type":"string"},{"name":"scope","in":"query","type":"string","description":"Filter published product values to return scopable attributes for the given channel as well as the non localizable/non scopable attributes, for more details see the Filter on published product values section","required":false},{"name":"locales","in":"query","type":"string","description":"Filter published product values to return localizable attributes for the given locales as well as the non localizable/non scopable attributes, for more details see the Filter on published product values section","required":false},{"name":"attributes","in":"query","type":"string","description":"Filter published product values to only return those concerning the given attributes, for more details see the Filter on product values section","required":false},{"name":"pagination_type","in":"query","description":"Pagination method type, see Pagination section","required":false,"type":"string","default":"page","x-validation-rules":"One of the following values","enum":["page","search_after"]},{"name":"page","in":"query","description":"Number of the page to retrieve when using the `page` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"integer","default":1},{"name":"search_after","in":"query","description":"Cursor when using the `search_after` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"string","default":"cursor to the first page"},{"name":"limit","in":"query","description":"Number of results by page, see Pagination section","required":false,"type":"integer","minimum":1,"maximum":100,"default":10},{"name":"with_count","in":"query","description":"Return the count of items in the response. Be carefull with that, on a big catalog, it can decrease performance in a significative way","default":false,"type":"boolean","required":false}],"responses":{"200":{"description":"Return published products paginated","schema":{"title":"Published products","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"previous":{"type":"object","properties":{"href":{"type":"string","description":"URI of the previous page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}},"current_page":{"type":"integer","description":"Current page number"}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["identifier"],"properties":{"identifier":{"type":"string","description":"Published product identifier, i.e. the value of the only `pim_catalog_identifier` attribute"},"enabled":{"type":"boolean","description":"Whether the published product is enable","default":true},"family":{"type":"string","description":"Family code from which the published product inherits its attributes and attributes requirements","x-validation-rules":"It is equal to an existing family code","default":"null"},"categories":{"type":"array","description":"Codes of the categories in which the published product is classified","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"groups":{"type":"array","description":"Codes of the groups to which the published product belong","x-validation-rules":"Each string of the array is equal to an existing group code","items":{"type":"string"},"default":[]},"values":{"type":"object","description":"Published product attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value"}}}}}},"associations":{"type":"object","description":"Several associations related to groups and/or other published products, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the identifier of an existing product. • Identifiers used in the array of the property `products` cannot be equal to the published product identifier.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the published product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of published product identifiers with which the published product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Warning: associations with quantities are not compatible with the published products. The response will always be empty."},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true}},"example":{"identifier":"top","enabled":true,"family":"tshirt","categories":["summer_collection"],"groups":[],"values":{"name":[{"data":"Top","locale":"en_US","scope":null},{"data":"Débardeur","locale":"fr_FR","scope":null}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce"},{"data":"Top","locale":"en_US","scope":"tablet"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black"}],"size":[{"locale":null,"scope":null,"data":"m"}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglass"],"product_models":[],"groups":[]}}}}]}}}}}}]},"examples":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/published-products?page=3&limit=3"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/published-products?page=1&limit=3"},"previous":{"href":"https://demo.akeneo.com/api/rest/v1/published-products?page=2&limit=3"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/published-products?page=4&limit=3"}},"current_page":3,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/published-products/top"}},"identifier":"top","family":"tshirt","groups":[],"categories":["summer_collection"],"enabled":true,"values":{"name":[{"data":"Top","locale":"en_US","scope":null},{"data":"Débardeur","locale":"fr_FR","scope":null}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce"},{"data":"Top","locale":"en_US","scope":"tablet"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black"}],"size":[{"locale":null,"scope":null,"data":"m"}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglasses"],"product_models":[],"groups":[]}}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/published-products/cap"}},"identifier":"cap","family":"caps","groups":[],"categories":["summer_collection"],"enabled":true,"values":{"name":[{"data":"Cap","locale":"en_US","scope":null},{"data":"Casquette","locale":"fr_FR","scope":null}],"description":[{"data":"Cap unisex","locale":"en_US","scope":"ecommerce"},{"data":"Cap unisex","locale":"en_US","scope":"tablet"},{"data":"Casquette unisexe","locale":"fr_FR","scope":"ecommerce"},{"data":"Casquette unisexe","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"20","currency":"EUR"},{"amount":"20","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black"}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglasses"],"product_models":[],"groups":[]}}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/published-products/sweat"}},"identifier":"sweat","family":null,"groups":[],"categories":["winter_collection"],"enabled":true,"values":{},"created":"2016-06-23T11:24:44+02:00","updated":"2016-06-23T11:24:44+02:00","associations":{}}]}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/published-products/{code}":{"get":{"summary":"Get a published product","operationId":"get_published_products__code_","tags":["Published product"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"description":"This endpoint allows you to get the information about a given published product.","parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the published product in JSON standard format","schema":{"type":"object","required":["identifier"],"properties":{"identifier":{"type":"string","description":"Published product identifier, i.e. the value of the only `pim_catalog_identifier` attribute"},"enabled":{"type":"boolean","description":"Whether the published product is enable","default":true},"family":{"type":"string","description":"Family code from which the published product inherits its attributes and attributes requirements","x-validation-rules":"It is equal to an existing family code","default":"null"},"categories":{"type":"array","description":"Codes of the categories in which the published product is classified","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"groups":{"type":"array","description":"Codes of the groups to which the published product belong","x-validation-rules":"Each string of the array is equal to an existing group code","items":{"type":"string"},"default":[]},"values":{"type":"object","description":"Published product attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value"}}}}}},"associations":{"type":"object","description":"Several associations related to groups and/or other published products, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the identifier of an existing product. • Identifiers used in the array of the property `products` cannot be equal to the published product identifier.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the published product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of published product identifiers with which the published product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Warning: associations with quantities are not compatible with the published products. The response will always be empty."},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true}},"example":{"identifier":"top","enabled":true,"family":"tshirt","categories":["summer_collection"],"groups":[],"values":{"name":[{"data":"Top","locale":"en_US","scope":null},{"data":"Débardeur","locale":"fr_FR","scope":null}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce"},{"data":"Top","locale":"en_US","scope":"tablet"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black"}],"size":[{"locale":null,"scope":null,"data":"m"}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglass"],"product_models":[],"groups":[]}}}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}}},"/api/rest/v1/media-files":{"get":{"summary":"Get a list of product media files","operationId":"get_media_files","description":"This endpoint allows you to get a list of media files that are used as attribute values in products or product models.","tags":["Product media file"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"page","in":"query","description":"Number of the page to retrieve when using the `page` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"integer","default":1},{"name":"limit","in":"query","description":"Number of results by page, see Pagination section","required":false,"type":"integer","minimum":1,"maximum":100,"default":10},{"name":"with_count","in":"query","description":"Return the count of items in the response. Be carefull with that, on a big catalog, it can decrease performance in a significative way","default":false,"type":"boolean","required":false}],"responses":{"200":{"description":"Return media files paginated","schema":{"title":"MediaFiles","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"previous":{"type":"object","properties":{"href":{"type":"string","description":"URI of the previous page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}},"current_page":{"type":"integer","description":"Current page number"}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI to get the metadata of the media file"}}},"download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the binaries of the media file"}}}}}}},{"type":"object","properties":{"code":{"type":"string","description":"Media file code","x-immutable":true},"original_filename":{"type":"string","description":"Original filename of the media file"},"mime_type":{"type":"string","description":"Mime type of the media file","x-read-only":true},"size":{"type":"integer","description":"Size of the media file","x-read-only":true},"extension":{"type":"string","description":"Extension of the media file","x-read-only":true}},"example":{"code":"7/5/8/e/758e39d48ea7b42a55091434fd3d8b6cf3189b7f_10806799_1356.jpg","original_filename":"10806799-1356.jpg","mime_type":"image/jpeg","size":16070,"extension":"jpg"}}]}}}}}}]},"examples":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/media-files?page=2&limit=4"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/media-files?page=1&limit=4"},"previous":{"href":"https://demo.akeneo.com/api/rest/v1/media-files?page=1&limit=4"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/media-files?page=2&limit=4"}},"current_page":2,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/media-files/7/5/8/e/758e39d48ea7b42a55091434fd3d8b6cf3189b7f_10806799_1356.jpg"},"download":{"href":"https://demo.akeneo.com/api/rest/v1/media-files/7/5/8/e/758e39d48ea7b42a55091434fd3d8b6cf3189b7f_10806799_1356.jpg/download"}},"code":"7/5/8/e/758e39d48ea7b42a55091434fd3d8b6cf3189b7f_10806799_1356.jpg","original_filename":"10806799-1356.jpg","mime_type":"image/jpeg","size":16070,"extension":"jpg"},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/media-files/d/0/3/2/d032a92d994df3ef67ee6746b7b7a795c2964e7c_10734346_1480.jpg"},"download":{"href":"https://demo.akeneo.com/api/rest/v1/media-files/d/0/3/2/d032a92d994df3ef67ee6746b7b7a795c2964e7c_10734346_1480.jpg/download"}},"code":"d/0/3/2/d032a92d994df3ef67ee6746b7b7a795c2964e7c_10734346_1480.jpg","original_filename":"10734346-1480.jpg","mime_type":"image/jpeg","size":16454,"extension":"jpg"},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/media-files/5/1/d/8/51d81dc778ba1501a8f998f3ab5797569f3b9e25_12431976_8797.jpg"},"download":{"href":"https://demo.akeneo.com/api/rest/v1/media-files/5/1/d/8/51d81dc778ba1501a8f998f3ab5797569f3b9e25_12431976_8797.jpg/download"}},"code":"5/1/d/8/51d81dc778ba1501a8f998f3ab5797569f3b9e25_12431976_8797.jpg","original_filename":"12431976-8797.jpg","mime_type":"image/jpeg","size":19725,"extension":"jpg"},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/media-files/0/c/b/0/0cb0c0e115dedba676f8d1ad8343e6207ab54c7b_107406_9841.jpg"},"download":{"href":"https://demo.akeneo.com/api/rest/v1/media-files/0/c/b/0/0cb0c0e115dedba676f8d1ad8343e6207ab54c7b_107406_9841.jpg/download"}},"code":"0/c/b/0/0cb0c0e115dedba676f8d1ad8343e6207ab54c7b_107406_9841.jpg","original_filename":"107406-9841.jpg","mime_type":"image/jpeg","size":17639,"extension":"jpg"}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"post":{"summary":"Create a new product media file","operationId":"post_media_files","description":"This endpoint allows you to create a new media file and associate it to an attribute value of a given product or product model.","tags":["Product media file"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"Content-type","in":"header","type":"string","description":"Equal to 'multipart/form-data', no other value allowed","required":true},{"name":"body","in":"body","x-form-data":true,"schema":{"required":["file"],"properties":{"product":{"type":"string","description":"The product to which the media file will be associated. It is a JSON string that follows this format '{\"identifier\":\"product_identifier\", \"attribute\":\"attribute_code\", \"scope\":\"channel_code\",\"locale\":\"locale_code\"}'. You have to either use this field or the `product_model` field, but not both at the same time."},"product_model":{"type":"string","description":"The product model to which the media file will be associated. It is a JSON string that follows this format '{\"code\":\"product_model_code\", \"attribute\":\"attribute_code\", \"scope\":\"channel_code\",\"locale\":\"locale_code\"}'. You have to either use this field or the `product` field, but not both at the same time."},"file":{"type":"string","description":"The binaries of the file","format":"binary"}}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `multipart/form-data`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘multipart/form-data’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/media-files/{code}":{"get":{"summary":"Get a product media file","operationId":"get_media_files__code_","description":"This endpoint allows you to get the information about a given media file that is used as an attribute value of a product or a product model.","tags":["Product media file"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the media file in JSON standard format","schema":{"allOf":[{"type":"object","properties":{"_links":{"type":"object","x-read-only":true,"properties":{"download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the binaries of the media file"}}}}}}},{"type":"object","properties":{"code":{"type":"string","description":"Media file code","x-immutable":true},"original_filename":{"type":"string","description":"Original filename of the media file"},"mime_type":{"type":"string","description":"Mime type of the media file","x-read-only":true},"size":{"type":"integer","description":"Size of the media file","x-read-only":true},"extension":{"type":"string","description":"Extension of the media file","x-read-only":true}},"example":{"code":"7/5/8/e/758e39d48ea7b42a55091434fd3d8b6cf3189b7f_10806799_1356.jpg","original_filename":"10806799-1356.jpg","mime_type":"image/jpeg","size":16070,"extension":"jpg"}}],"example":{"_links":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/media-files/7/5/8/e/758e39d48ea7b42a55091434fd3d8b6cf3189b7f_10806799_1356.jpg/download"}},"code":"7/5/8/e/758e39d48ea7b42a55091434fd3d8b6cf3189b7f_10806799_1356.jpg","original_filename":"10806799-1356.jpg","mime_type":"image/jpeg","size":16070,"extension":"jpg"}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}}},"/api/rest/v1/media-files/{code}/download":{"get":{"summary":"Download a product media file","operationId":"get_media_files__code__download","description":"This endpoint allows you to download a given media file that is used as an attribute value of a product or a product model.","x-content-type":"Mime-type of the media file","tags":["Product media file"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the binary of the media file","x-content-type":"Mime-type of the media file"},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}}}}},"/api/rest/v1/families":{"get":{"summary":"Get list of families","operationId":"get_families","description":"This endpoint allows you to get a list of families. Families are paginated and sorted by code.","tags":["Family"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"search","in":"query","description":"Filter families, for more details see the Filters section.","required":false,"type":"string"},{"name":"page","in":"query","description":"Number of the page to retrieve when using the `page` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"integer","default":1},{"name":"limit","in":"query","description":"Number of results by page, see Pagination section","required":false,"type":"integer","minimum":1,"maximum":100,"default":10},{"name":"with_count","in":"query","description":"Return the count of items in the response. Be carefull with that, on a big catalog, it can decrease performance in a significative way","default":false,"type":"boolean","required":false}],"responses":{"200":{"description":"Return families paginated","schema":{"title":"Families","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"previous":{"type":"object","properties":{"href":{"type":"string","description":"URI of the previous page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}},"current_page":{"type":"integer","description":"Current page number"}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code","attribute_as_label"],"properties":{"code":{"type":"string","description":"Family code","x-immutable":true},"attribute_as_label":{"type":"string","description":"Attribute code used as label","x-validation-rules":"• It is equal to an existing attribute code • This attribute code is in the array of the property `attributes` • The type of this attribute is either `pim_catalog_identifier` or `pim_catalog_text`"},"attribute_as_image":{"type":"string","description":"Attribute code used as the main picture in the user interface (only since v2.0)","x-validation-rules":"• It is equal to an existing attribute code • This attribute code is in the array of the property `attributes` • The type of this attribute is `pim_catalog_image`. Since v2.1, you can also use a `pim_assets_collection` attribute type","default":"null","x-from-version":"2.0"},"attributes":{"type":"array","description":"Attributes codes that compose the family","x-validation-rules":"Each string of the array is an existing attribute code","items":{"type":"string"},"default":[]},"attribute_requirements":{"type":"object","description":"Attributes codes of the family that are required for the completeness calculation for each channel","x-validation-rules":"• Each string of these arrays is an existing attribute code • These attribute codes are in the array of the property `attributes` • The `channelCode` is the code of an existing and activated channel","properties":{"channelCode":{"type":"array","items":{"type":"string","description":"Attributes codes of the family that are required for the completeness calculation for the channel `channelCode`"}}}},"labels":{"type":"object","description":"Family labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Family label for the locale `localeCode`"}}}},"example":{"code":"caps","attributes":["sku","name","description","price","color","picture"],"attribute_as_label":"name","attribute_as_image":"picture","attribute_requirements":{"ecommerce":["sku","name","description","price","color"],"tablet":["sku","name","description","price"]},"labels":{"en_US":"Caps","fr_FR":"Casquettes"}}}]}}}}}}]},"examples":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/families?page=2&limit=2"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/families?page=1&limit=2"},"previous":{"href":"https://demo.akeneo.com/api/rest/v1/families?page=1&limit=2"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/families?page=3&limit=2"}},"current_page":2,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/families/tshirt"}},"code":"tshirt","attributes":["sku","name","description","price","size","color","picture"],"attribute_as_label":"name","attribute_as_image":"picture","attribute_requirements":{"ecommerce":["sku","name","description","price","size","color"],"tablet":["sku","name","description","price"]},"labels":{"en_US":"Tshirt","fr_FR":"Tshirt"}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/families/caps"}},"code":"caps","attributes":["sku","name","description","price","color","picture"],"attribute_as_label":"name","attribute_as_image":"picture","attribute_requirements":{"ecommerce":["sku","name","description","price","color"],"tablet":["sku","name","description","price"]},"labels":{"en_US":"Caps","fr_FR":"Casquettes"}}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"post":{"summary":"Create a new family","operationId":"post_families","description":"This endpoint allows you to create a new family.","tags":["Family"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","required":["code","attribute_as_label"],"properties":{"code":{"type":"string","description":"Family code","x-immutable":true},"attribute_as_label":{"type":"string","description":"Attribute code used as label","x-validation-rules":"• It is equal to an existing attribute code • This attribute code is in the array of the property `attributes` • The type of this attribute is either `pim_catalog_identifier` or `pim_catalog_text`"},"attribute_as_image":{"type":"string","description":"Attribute code used as the main picture in the user interface (only since v2.0)","x-validation-rules":"• It is equal to an existing attribute code • This attribute code is in the array of the property `attributes` • The type of this attribute is `pim_catalog_image`. Since v2.1, you can also use a `pim_assets_collection` attribute type","default":"null","x-from-version":"2.0"},"attributes":{"type":"array","description":"Attributes codes that compose the family","x-validation-rules":"Each string of the array is an existing attribute code","items":{"type":"string"},"default":[]},"attribute_requirements":{"type":"object","description":"Attributes codes of the family that are required for the completeness calculation for each channel","x-validation-rules":"• Each string of these arrays is an existing attribute code • These attribute codes are in the array of the property `attributes` • The `channelCode` is the code of an existing and activated channel","properties":{"channelCode":{"type":"array","items":{"type":"string","description":"Attributes codes of the family that are required for the completeness calculation for the channel `channelCode`"}}}},"labels":{"type":"object","description":"Family labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Family label for the locale `localeCode`"}}}},"example":{"code":"caps","attributes":["sku","name","description","price","color","picture"],"attribute_as_label":"name","attribute_as_image":"picture","attribute_requirements":{"ecommerce":["sku","name","description","price","color"],"tablet":["sku","name","description","price"]},"labels":{"en_US":"Caps","fr_FR":"Casquettes"}}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}},"patch":{"summary":"Update/create several families","operationId":"patch_families","tags":["Family"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to update and/or create several families at once.","x-body-by-line":"Contains several lines, each line is a family in JSON standard format","parameters":[{"name":"body","in":"body","schema":{"x-examples":{"x-example-1":"{\"code\":\"tshirt\",\"attributes\":[\"description\",\"size\"]}","x-example-2":"{\"code\":\"cap\",\"attribute_as_label\":\"descripion\"}","x-example-3":"{\"code\":\"mug\",\"attributes\":[\"description\",\"short_description\"]}"},"type":"object","required":["code","attribute_as_label"],"properties":{"code":{"type":"string","description":"Family code","x-immutable":true},"attribute_as_label":{"type":"string","description":"Attribute code used as label","x-validation-rules":"• It is equal to an existing attribute code • This attribute code is in the array of the property `attributes` • The type of this attribute is either `pim_catalog_identifier` or `pim_catalog_text`"},"attribute_as_image":{"type":"string","description":"Attribute code used as the main picture in the user interface (only since v2.0)","x-validation-rules":"• It is equal to an existing attribute code • This attribute code is in the array of the property `attributes` • The type of this attribute is `pim_catalog_image`. Since v2.1, you can also use a `pim_assets_collection` attribute type","default":"null","x-from-version":"2.0"},"attributes":{"type":"array","description":"Attributes codes that compose the family","x-validation-rules":"Each string of the array is an existing attribute code","items":{"type":"string"},"default":[]},"attribute_requirements":{"type":"object","description":"Attributes codes of the family that are required for the completeness calculation for each channel","x-validation-rules":"• Each string of these arrays is an existing attribute code • These attribute codes are in the array of the property `attributes` • The `channelCode` is the code of an existing and activated channel","properties":{"channelCode":{"type":"array","items":{"type":"string","description":"Attributes codes of the family that are required for the completeness calculation for the channel `channelCode`"}}}},"labels":{"type":"object","description":"Family labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Family label for the locale `localeCode`"}}}},"example":{"code":"caps","attributes":["sku","name","description","price","color","picture"],"attribute_as_label":"name","attribute_as_image":"picture","attribute_requirements":{"ecommerce":["sku","name","description","price","color"],"tablet":["sku","name","description","price"]},"labels":{"en_US":"Caps","fr_FR":"Casquettes"}}}}],"responses":{"200":{"description":"OK","x-details":"Returns a plain text response whose lines are JSON containing the status of each update or creation","x-no-entity":true,"schema":{"type":"object","properties":{"line":{"type":"integer","description":"Line number"},"identifier":{"type":"string","description":"Resource identifier, only filled when the resource is a product"},"code":{"type":"string","description":"Resource code, only filled when the resource is not a product"},"status_code":{"type":"integer","description":"HTTP status code, see Client errors to understand the meaning of each code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"x-example-1":"{\"line\":1,\"code\":\"tshirt\",\"status_code\":201}","x-example-2":"{\"line\":2,\"code\":\"cap\",\"status_code\":422,\"message\":\"Attribute \\\"descripion\\\" does not exist.\"}","x-example-3":"{\"line\":3,\"code\":\"mug\",\"status_code\":204}"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"413":{"description":"Request Entity Too Large","x-details":"There are too many resources to process (max 100) or the line of JSON is too long (max 1 000 000 characters)","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":413,"message":"Too many resources to process, 100 is the maximum allowed."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/vnd.akeneo.collection+json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/vnd.akeneo.collection+json’ is allowed."}}}}},"/api/rest/v1/families/{code}":{"get":{"summary":"Get a family","operationId":"get_families__code_","description":"This endpoint allows you to get the information about a given family.","tags":["Family"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the family in JSON standard format","schema":{"type":"object","required":["code","attribute_as_label"],"properties":{"code":{"type":"string","description":"Family code","x-immutable":true},"attribute_as_label":{"type":"string","description":"Attribute code used as label","x-validation-rules":"• It is equal to an existing attribute code • This attribute code is in the array of the property `attributes` • The type of this attribute is either `pim_catalog_identifier` or `pim_catalog_text`"},"attribute_as_image":{"type":"string","description":"Attribute code used as the main picture in the user interface (only since v2.0)","x-validation-rules":"• It is equal to an existing attribute code • This attribute code is in the array of the property `attributes` • The type of this attribute is `pim_catalog_image`. Since v2.1, you can also use a `pim_assets_collection` attribute type","default":"null","x-from-version":"2.0"},"attributes":{"type":"array","description":"Attributes codes that compose the family","x-validation-rules":"Each string of the array is an existing attribute code","items":{"type":"string"},"default":[]},"attribute_requirements":{"type":"object","description":"Attributes codes of the family that are required for the completeness calculation for each channel","x-validation-rules":"• Each string of these arrays is an existing attribute code • These attribute codes are in the array of the property `attributes` • The `channelCode` is the code of an existing and activated channel","properties":{"channelCode":{"type":"array","items":{"type":"string","description":"Attributes codes of the family that are required for the completeness calculation for the channel `channelCode`"}}}},"labels":{"type":"object","description":"Family labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Family label for the locale `localeCode`"}}}},"example":{"code":"caps","attributes":["sku","name","description","price","color","picture"],"attribute_as_label":"name","attribute_as_image":"picture","attribute_requirements":{"ecommerce":["sku","name","description","price","color"],"tablet":["sku","name","description","price"]},"labels":{"en_US":"Caps","fr_FR":"Casquettes"}}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"patch":{"summary":"Update/create a family","operationId":"patch_families__code_","tags":["Family"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to update a given family. Know more about Update behavior. Note that if no family exists for the given code, it creates it.","parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"},{"name":"body","in":"body","required":true,"schema":{"type":"object","required":["code","attribute_as_label"],"properties":{"code":{"type":"string","description":"Family code","x-immutable":true},"attribute_as_label":{"type":"string","description":"Attribute code used as label","x-validation-rules":"• It is equal to an existing attribute code • This attribute code is in the array of the property `attributes` • The type of this attribute is either `pim_catalog_identifier` or `pim_catalog_text`"},"attribute_as_image":{"type":"string","description":"Attribute code used as the main picture in the user interface (only since v2.0)","x-validation-rules":"• It is equal to an existing attribute code • This attribute code is in the array of the property `attributes` • The type of this attribute is `pim_catalog_image`. Since v2.1, you can also use a `pim_assets_collection` attribute type","default":"null","x-from-version":"2.0"},"attributes":{"type":"array","description":"Attributes codes that compose the family","x-validation-rules":"Each string of the array is an existing attribute code","items":{"type":"string"},"default":[]},"attribute_requirements":{"type":"object","description":"Attributes codes of the family that are required for the completeness calculation for each channel","x-validation-rules":"• Each string of these arrays is an existing attribute code • These attribute codes are in the array of the property `attributes` • The `channelCode` is the code of an existing and activated channel","properties":{"channelCode":{"type":"array","items":{"type":"string","description":"Attributes codes of the family that are required for the completeness calculation for the channel `channelCode`"}}}},"labels":{"type":"object","description":"Family labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Family label for the locale `localeCode`"}}}},"example":{"code":"caps","attributes":["sku","name","description","price","color","picture"],"attribute_as_label":"name","attribute_as_image":"picture","attribute_requirements":{"ecommerce":["sku","name","description","price","color"],"tablet":["sku","name","description","price"]},"labels":{"en_US":"Caps","fr_FR":"Casquettes"}}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"204":{"description":"No content to return","x-details":"Means that the update was successful","headers":{"Location":{"description":"URI of the updated resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/families/{family_code}/variants":{"get":{"summary":"Get list of family variants","operationId":"get_families__family_code__variants","description":"This endpoint allows you to get a list of family variants. Family variants are paginated and sorted by code.","tags":["Family variant"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"family_code","in":"path","description":"Code of the family","required":true,"type":"string"},{"name":"page","in":"query","description":"Number of the page to retrieve when using the `page` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"integer","default":1},{"name":"limit","in":"query","description":"Number of results by page, see Pagination section","required":false,"type":"integer","minimum":1,"maximum":100,"default":10},{"name":"with_count","in":"query","description":"Return the count of items in the response. Be carefull with that, on a big catalog, it can decrease performance in a significative way","default":false,"type":"boolean","required":false}],"responses":{"200":{"description":"Return family variants paginated","schema":{"title":"Family Variants","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"previous":{"type":"object","properties":{"href":{"type":"string","description":"URI of the previous page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}},"current_page":{"type":"integer","description":"Current page number"}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code","variant_attribute_sets"],"properties":{"code":{"type":"string","description":"Family variant code","x-immutable":true},"variant_attribute_sets":{"type":"array","description":"Attributes distribution according to the enrichment level","items":{"type":"object","required":["level","axes"],"description":"Enrichment level","properties":{"level":{"type":"integer","description":"Enrichment level","x-immutable":true,"x-validation-rules":"• Number representing the level of the attribute set. • It should be equal to 1 or 2. • If you specify the level 2, you have to specify the level 1 as well."},"axes":{"type":"array","description":"Codes of attributes used as variant axes","x-immutable":true,"items":{"type":"string"},"default":[],"x-validation-rules":"• Should be an array of maximum 5 existing attribute codes • These attributes should belong to the family of the family variant • Only the following attribute types are allowed: `simple select`, `multi select`, `reference data`, `metric`, `boolean` • Attributes cannot be scopable, nor localizable nor locale specific • Attributes used as axes in one level cannot be used as axes or as attributes in the other level"},"attributes":{"type":"array","description":"Codes of attributes bind to this enrichment level","items":{"type":"string"},"default":[],"x-validation-rules":"• Should be an array of existing attribute codes • These attributes should belong to the family of the family variant • Attributes used as attribute in one level cannot be used as axes or as attributes in the other level • Attributes that are `unique value` or `identifier` are automatically distributed to the lower level."}}}},"labels":{"type":"object","description":"Family variant labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Family variant label for the locale `localeCode`"}}}},"example":{"code":"shoesVariant","labels":{"en_US":"Shoes variant","fr_FR":"Variante de chaussures"},"variant_attribute_sets":[{"level":1,"attributes":["color","material"],"axes":["color"]},{"level":2,"attributes":["sku","size"],"axes":["size"]}]}}]}}}}}}]},"examples":{"code":"shoesVariant","labels":{"en_US":"Shoes variant","fr_FR":"Variante de chaussures"},"variant_attribute_sets":[{"level":1,"attributes":["color","material"],"axes":["color"]},{"level":2,"attributes":["sku","size"],"axes":["size"]}]}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"post":{"summary":"Create a new family variant","operationId":"post_families__family_code__variants","tags":["Family"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to create a family variant.","parameters":[{"name":"family_code","in":"path","description":"Code of the family","required":true,"type":"string"},{"name":"body","in":"body","schema":{"type":"object","required":["code","variant_attribute_sets"],"properties":{"code":{"type":"string","description":"Family variant code","x-immutable":true},"variant_attribute_sets":{"type":"array","description":"Attributes distribution according to the enrichment level","items":{"type":"object","required":["level","axes"],"description":"Enrichment level","properties":{"level":{"type":"integer","description":"Enrichment level","x-immutable":true,"x-validation-rules":"• Number representing the level of the attribute set. • It should be equal to 1 or 2. • If you specify the level 2, you have to specify the level 1 as well."},"axes":{"type":"array","description":"Codes of attributes used as variant axes","x-immutable":true,"items":{"type":"string"},"default":[],"x-validation-rules":"• Should be an array of maximum 5 existing attribute codes • These attributes should belong to the family of the family variant • Only the following attribute types are allowed: `simple select`, `multi select`, `reference data`, `metric`, `boolean` • Attributes cannot be scopable, nor localizable nor locale specific • Attributes used as axes in one level cannot be used as axes or as attributes in the other level"},"attributes":{"type":"array","description":"Codes of attributes bind to this enrichment level","items":{"type":"string"},"default":[],"x-validation-rules":"• Should be an array of existing attribute codes • These attributes should belong to the family of the family variant • Attributes used as attribute in one level cannot be used as axes or as attributes in the other level • Attributes that are `unique value` or `identifier` are automatically distributed to the lower level."}}}},"labels":{"type":"object","description":"Family variant labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Family variant label for the locale `localeCode`"}}}},"example":{"code":"shoesVariant","labels":{"en_US":"Shoes variant","fr_FR":"Variante de chaussures"},"variant_attribute_sets":[{"level":1,"attributes":["color","material"],"axes":["color"]},{"level":2,"attributes":["sku","size"],"axes":["size"]}]}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}},"patch":{"summary":"Update/create several family variants","operationId":"patch_families__family_code__variants","tags":["Family variant"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to update and/or create several family variants at once, for a given family.","x-body-by-line":"Contains several lines, each line is a family in JSON standard format","parameters":[{"name":"family_code","in":"path","description":"Code of the family","required":true,"type":"string"},{"name":"body","in":"body","schema":{"x-examples":{"x-example-1":"{\"code\": \"shoes_by_size\", \"variant_attribute_sets\": [{\"level\": 1, \"axes\": [\"size\"], \"attributes\": [\"color\"]}]}","x-example-2":"{\"code\": \"shoes_by_color\",\"labels\": {\"en_US\": \"Shoes by color\"}}","x-example-3":"{\"code\": \"shoes_without_axes\", \"variant_attribute_sets\": [{\"level\": 1, \"axes\": [], \"attributes\": [\"color\"]}]}"},"type":"object","required":["code","variant_attribute_sets"],"properties":{"code":{"type":"string","description":"Family variant code","x-immutable":true},"variant_attribute_sets":{"type":"array","description":"Attributes distribution according to the enrichment level","items":{"type":"object","required":["level","axes"],"description":"Enrichment level","properties":{"level":{"type":"integer","description":"Enrichment level","x-immutable":true,"x-validation-rules":"• Number representing the level of the attribute set. • It should be equal to 1 or 2. • If you specify the level 2, you have to specify the level 1 as well."},"axes":{"type":"array","description":"Codes of attributes used as variant axes","x-immutable":true,"items":{"type":"string"},"default":[],"x-validation-rules":"• Should be an array of maximum 5 existing attribute codes • These attributes should belong to the family of the family variant • Only the following attribute types are allowed: `simple select`, `multi select`, `reference data`, `metric`, `boolean` • Attributes cannot be scopable, nor localizable nor locale specific • Attributes used as axes in one level cannot be used as axes or as attributes in the other level"},"attributes":{"type":"array","description":"Codes of attributes bind to this enrichment level","items":{"type":"string"},"default":[],"x-validation-rules":"• Should be an array of existing attribute codes • These attributes should belong to the family of the family variant • Attributes used as attribute in one level cannot be used as axes or as attributes in the other level • Attributes that are `unique value` or `identifier` are automatically distributed to the lower level."}}}},"labels":{"type":"object","description":"Family variant labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Family variant label for the locale `localeCode`"}}}},"example":{"code":"shoesVariant","labels":{"en_US":"Shoes variant","fr_FR":"Variante de chaussures"},"variant_attribute_sets":[{"level":1,"attributes":["color","material"],"axes":["color"]},{"level":2,"attributes":["sku","size"],"axes":["size"]}]}}}],"responses":{"200":{"description":"OK","x-details":"Returns a plain text response whose lines are JSON containing the status of each update or creation","x-no-entity":true,"schema":{"type":"object","properties":{"line":{"type":"integer","description":"Line number"},"identifier":{"type":"string","description":"Resource identifier, only filled when the resource is a product"},"code":{"type":"string","description":"Resource code, only filled when the resource is not a product"},"status_code":{"type":"integer","description":"HTTP status code, see Client errors to understand the meaning of each code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"x-example-1":"{\"line\":1,\"code\":\"shoes_by_size\",\"status_code\":201}","x-example-2":"{\"line\":2,\"code\":\"shoes_by_color\",\"status_code\":204}","x-example-3":"{\"line\":3,\"code\":\"mug\",\"status_code\":422, \"message\":\"There should be at least one attribute defined as axis for the attribute set for level \\\"1\\\"\"}"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"413":{"description":"Request Entity Too Large","x-details":"There are too many resources to process (max 100) or the line of JSON is too long (max 1 000 000 characters)","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":413,"message":"Too many resources to process, 100 is the maximum allowed."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/vnd.akeneo.collection+json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/vnd.akeneo.collection+json’ is allowed."}}}}},"/api/rest/v1/families/{family_code}/variants/{code}":{"get":{"summary":"Get a family variant","operationId":"get_families__family_code__variants__code__","description":"This endpoint allows you to get the information about a given family variant.","tags":["Family variant"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"family_code","in":"path","description":"Code of the family","required":true,"type":"string"},{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the family variant in JSON standard format","schema":{"type":"object","required":["code","variant_attribute_sets"],"properties":{"code":{"type":"string","description":"Family variant code","x-immutable":true},"variant_attribute_sets":{"type":"array","description":"Attributes distribution according to the enrichment level","items":{"type":"object","required":["level","axes"],"description":"Enrichment level","properties":{"level":{"type":"integer","description":"Enrichment level","x-immutable":true,"x-validation-rules":"• Number representing the level of the attribute set. • It should be equal to 1 or 2. • If you specify the level 2, you have to specify the level 1 as well."},"axes":{"type":"array","description":"Codes of attributes used as variant axes","x-immutable":true,"items":{"type":"string"},"default":[],"x-validation-rules":"• Should be an array of maximum 5 existing attribute codes • These attributes should belong to the family of the family variant • Only the following attribute types are allowed: `simple select`, `multi select`, `reference data`, `metric`, `boolean` • Attributes cannot be scopable, nor localizable nor locale specific • Attributes used as axes in one level cannot be used as axes or as attributes in the other level"},"attributes":{"type":"array","description":"Codes of attributes bind to this enrichment level","items":{"type":"string"},"default":[],"x-validation-rules":"• Should be an array of existing attribute codes • These attributes should belong to the family of the family variant • Attributes used as attribute in one level cannot be used as axes or as attributes in the other level • Attributes that are `unique value` or `identifier` are automatically distributed to the lower level."}}}},"labels":{"type":"object","description":"Family variant labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Family variant label for the locale `localeCode`"}}}},"example":{"code":"shoesVariant","labels":{"en_US":"Shoes variant","fr_FR":"Variante de chaussures"},"variant_attribute_sets":[{"level":1,"attributes":["color","material"],"axes":["color"]},{"level":2,"attributes":["sku","size"],"axes":["size"]}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"patch":{"summary":"Update/create a family variant","operationId":"patch_families__family_code__variants__code__","tags":["Family variant"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to update a given family variant. Know more about Update behavior. Note that if no family variant exists for the given code, it creates it.","parameters":[{"name":"family_code","in":"path","description":"Code of the family","required":true,"type":"string"},{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"},{"name":"body","in":"body","required":true,"schema":{"type":"object","required":["code","variant_attribute_sets"],"properties":{"code":{"type":"string","description":"Family variant code","x-immutable":true},"variant_attribute_sets":{"type":"array","description":"Attributes distribution according to the enrichment level","items":{"type":"object","required":["level","axes"],"description":"Enrichment level","properties":{"level":{"type":"integer","description":"Enrichment level","x-immutable":true,"x-validation-rules":"• Number representing the level of the attribute set. • It should be equal to 1 or 2. • If you specify the level 2, you have to specify the level 1 as well."},"axes":{"type":"array","description":"Codes of attributes used as variant axes","x-immutable":true,"items":{"type":"string"},"default":[],"x-validation-rules":"• Should be an array of maximum 5 existing attribute codes • These attributes should belong to the family of the family variant • Only the following attribute types are allowed: `simple select`, `multi select`, `reference data`, `metric`, `boolean` • Attributes cannot be scopable, nor localizable nor locale specific • Attributes used as axes in one level cannot be used as axes or as attributes in the other level"},"attributes":{"type":"array","description":"Codes of attributes bind to this enrichment level","items":{"type":"string"},"default":[],"x-validation-rules":"• Should be an array of existing attribute codes • These attributes should belong to the family of the family variant • Attributes used as attribute in one level cannot be used as axes or as attributes in the other level • Attributes that are `unique value` or `identifier` are automatically distributed to the lower level."}}}},"labels":{"type":"object","description":"Family variant labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Family variant label for the locale `localeCode`"}}}},"example":{"code":"shoesVariant","labels":{"en_US":"Shoes variant","fr_FR":"Variante de chaussures"},"variant_attribute_sets":[{"level":1,"attributes":["color","material"],"axes":["color"]},{"level":2,"attributes":["sku","size"],"axes":["size"]}]}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"204":{"description":"No content to return","x-details":"Means that the update was successful","headers":{"Location":{"description":"URI of the updated resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/attributes":{"get":{"summary":"Get list of attributes","operationId":"get_attributes","description":"This endpoint allows you to get a list of attributes. Attributes are paginated and sorted by code.","tags":["Attribute"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"search","in":"query","description":"Filter attributes, for more details see the Filters section.","required":false,"type":"string"},{"name":"page","in":"query","description":"Number of the page to retrieve when using the `page` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"integer","default":1},{"name":"limit","in":"query","description":"Number of results by page, see Pagination section","required":false,"type":"integer","minimum":1,"maximum":100,"default":10},{"name":"with_count","in":"query","description":"Return the count of items in the response. Be carefull with that, on a big catalog, it can decrease performance in a significative way","default":false,"type":"boolean","required":false},{"name":"with_table_select_options","in":"query","description":"Return the options of 'select' column types (of a table attribute) in the response. (Only available since the 7.0 version)","default":false,"type":"boolean","required":false,"x-from-version":"7.0"}],"responses":{"200":{"description":"Return attributes paginated","schema":{"title":"Attributes","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"previous":{"type":"object","properties":{"href":{"type":"string","description":"URI of the previous page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}},"current_page":{"type":"integer","description":"Current page number"}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code","type","group"],"properties":{"code":{"type":"string","description":"Attribute code","x-immutable":true},"type":{"type":"string","description":"Attribute type. See type section for more details.","x-validation-rules":"The type is one of the following values","enum":["pim_catalog_identifier","pim_catalog_metric","pim_catalog_number","pim_catalog_reference_data_multi_select","pim_catalog_reference_data_simple_select","pim_catalog_simpleselect","pim_catalog_multiselect","pim_catalog_date","pim_catalog_textarea","pim_catalog_text","pim_catalog_file","pim_catalog_image","pim_catalog_price_collection","pim_catalog_boolean","akeneo_reference_entity","akeneo_reference_entity_collection","pim_catalog_asset_collection"],"x-immutable":true},"labels":{"type":"object","description":"Attribute labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute label for the locale `localeCode`"}}},"group":{"type":"string","description":"Attribute group","x-validation-rules":"It is the code of an existing group"},"group_labels":{"type":"object","description":"Group labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","x-read-only":true,"default":{},"properties":{"localeCode":{"type":"string","description":"Group label for the locale `localeCode`"}}},"sort_order":{"type":"integer","description":"Order of the attribute in its group","x-validation-rules":"It is a positive integer","default":0},"localizable":{"type":"boolean","description":"Whether the attribute is localizable, i.e. can have one value by locale","default":false,"x-immutable":true},"scopable":{"type":"boolean","description":"Whether the attribute is scopable, i.e. can have one value by channel","default":false,"x-immutable":true},"available_locales":{"type":"array","description":"To make the attribute locale specfic, specify here for which locales it is specific","x-validation-rules":"Each string of the array is an existing and activated locale","items":{"type":"string"}},"unique":{"type":"boolean","description":"Whether two values for the attribute cannot be the same","x-immutable":true},"useable_as_grid_filter":{"type":"boolean","description":"Whether the attribute can be used as a filter for the product grid in the PIM user interface"},"max_characters":{"type":"integer","description":"Number maximum of characters allowed for the value of the attribute when the attribute type is `pim_catalog_text`, `pim_catalog_textarea` or `pim_catalog_identifier`","x-warning":"Only for `pim_catalog_text`, `pim_catalog_textarea` or `pim_catalog_identifier` attribute types"},"validation_rule":{"type":"string","description":"Validation rule type used to validate any attribute value when the attribute type is `pim_catalog_text` or `pim_catalog_identifier`","x-validation-rules":"Equal to `regexp` when the attribute type is equal to `pim_catalog_identifier`","x-warning":"Only for `pim_catalog_text` or `pim_catalog_identifier` attribute types"},"validation_regexp":{"type":"string","description":"Regexp expression used to validate any attribute value when the attribute type is `pim_catalog_text` or `pim_catalog_identifier`","x-validation-rules":"Required when the property `validation_rule` is equal to `regexp`","x-warning":"Only for `pim_catalog_text` or `pim_catalog_identifier` attribute types"},"wysiwyg_enabled":{"type":"boolean","description":"Whether the WYSIWYG interface is shown when the attribute type is `pim_catalog_textarea`","x-warning":"Only for `pim_catalog_textarea` attribute type"},"number_min":{"type":"string","description":"Minimum integer value allowed when the attribute type is `pim_catalog_metric`, `pim_catalog_price` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric`, `pim_catalog_price_collection` or `pim_catalog_number` attribute types"},"number_max":{"type":"string","description":"Maximum integer value allowed when the attribute type is `pim_catalog_metric`, `pim_catalog_price` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric`, `pim_catalog_price_collection` or `pim_catalog_number` attribute types"},"decimals_allowed":{"type":"boolean","description":"Whether decimals are allowed when the attribute type is `pim_catalog_metric`, `pim_catalog_price` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric`, `pim_catalog_price_collection` or `pim_catalog_number` attribute types"},"negative_allowed":{"type":"boolean","description":"Whether negative values are allowed when the attribute type is `pim_catalog_metric` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric` or `pim_catalog_number` attribute types"},"metric_family":{"type":"string","description":"Metric family when the attribute type is `pim_catalog_metric`","x-immutable":true,"x-validation-rules":"Required for `pim_catalog_metric` attribute type","x-warning":"Only for `pim_catalog_metric` attribute type"},"default_metric_unit":{"type":"string","description":"Default metric unit when the attribute type is `pim_catalog_metric`","x-validation-rules":"Required for `pim_catalog_metric` attribute type","x-warning":"Only for `pim_catalog_metric` attribute type"},"date_min":{"type":"string","description":"Minimum date allowed when the attribute type is `pim_catalog_date`","x-validation-rules":"The datetime format follows the ISO-8601 norm","x-warning":"Only for `pim_catalog_date` attribute type","format":"date-time"},"date_max":{"type":"string","description":"Maximum date allowed when the attribute type is `pim_catalog_date`","x-validation-rules":"The datetime format follows the ISO-8601 norm","x-warning":"Only for `pim_catalog_date` attribute type","format":"date-time"},"allowed_extensions":{"type":"array","description":"Extensions allowed when the attribute type is `pim_catalog_file` or `pim_catalog_image`","x-warning":"Only for `pim_catalog_file` or `pim_catalog_image` attribute types","items":{"type":"string"}},"max_file_size":{"type":"string","description":"Max file size in MB when the attribute type is `pim_catalog_file` or `pim_catalog_image`","x-warning":"Only for `pim_catalog_file` or `pim_catalog_image` attribute types"},"reference_data_name":{"type":"string","description":"Reference entity code when the attribute type is `akeneo_reference_entity` or `akeneo_reference_entity_collection` OR Asset family code when the attribute type is `pim_catalog_asset_collection`","x-validation-rules":"Required only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types","x-warning":"Only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types"},"default_value":{"type":"boolean","description":"Default value for a Yes/No attribute, applied when creating a new product or product model (only available since the 5.0)","x-warning":"Only for `pim_catalog_boolean` attribute type","x-from-version":"5.0"},"table_configuration":{"type":"array","description":"Configuration of the Table attribute (columns)","x-validation-rules":"Required only for `pim_catalog_table` attribute type","x-warning":"Only for `pim_catalog_table` attribute type","items":{"type":"object","required":["code","data_type"],"properties":{"code":{"type":"string","description":"Column code"},"data_type":{"type":"string","enum":["select","text","number","boolean"],"description":"Column data type"},"validations":{"type":"object","description":"User defined validation constraints on the cell content","default":{},"properties":{"min":{"type":"number","description":"minimum value of a numeric cell","x-validation-rules":"only for `number` data type columns"},"max":{"type":"number","description":"maximum value of a numeric cell","x-validation-rules":"only for `number` data type columns"},"decimals_allowed":{"type":"boolean","description":"whether the value of a numeric cell can hold a decimal part","x-validation-rules":"only for `number` data type columns"},"max_length":{"type":"number","description":"maximum length of a text cell","x-validation-rules":"only for `text` data type columns"}}},"labels":{"type":"object","description":"Column labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Column label for the locale `localeCode`"}}},"is_required_for_completeness":{"type":"boolean","description":"Defines if the column should be entirely filled for the attribute to be considered complete","x-warning":"This value is always true for the first column in a table configuration","default":false}}}},"is_main_identifier":{"type":"boolean","description":"Is this attribute main identifier when attribute type is `pim_catalog_identifier`"}},"example":{"code":"release_date","type":"pim_catalog_date","group":"marketing","group_labels":{"en_US":"Marketing","fr_FR":"Marketing"},"unique":false,"useable_as_grid_filter":true,"allowed_extensions":[],"metric_family":null,"default_metric_unit":null,"reference_data_name":null,"available_locales":[],"max_characters":null,"validation_rule":null,"validation_regexp":null,"wysiwyg_enabled":null,"number_min":null,"number_max":null,"decimals_allowed":null,"negative_allowed":null,"date_min":"2017-06-28T08:00:00","date_max":"2017-08-08T22:00:00","max_file_size":null,"minimum_input_length":null,"sort_order":1,"localizable":false,"scopable":false,"default_value":null,"labels":{"en_US":"Sale date","fr_FR":"Date des soldes"}}}]}}}}}}]},"examples":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/attributes?page=3&limit=3"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/attributes?page=1&limit=3"},"previous":{"href":"https://demo.akeneo.com/api/rest/v1/attributes?page=2&limit=3"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/attributes?page=4&limit=3"}},"current_page":3,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/attributes/sku"}},"code":"sku","type":"pim_catalog_identifier","group":"other","group_labels":{"en_US":"Other","fr_FR":"Autre"},"unique":true,"useable_as_grid_filter":true,"allowed_extensions":[],"metric_family":null,"default_metric_unit":null,"reference_data_name":null,"available_locales":[],"max_characters":null,"validation_rule":null,"validation_regexp":null,"wysiwyg_enabled":false,"number_min":null,"number_max":null,"decimals_allowed":false,"negative_allowed":false,"date_min":null,"date_max":null,"max_file_size":null,"minimum_input_length":null,"sort_order":1,"localizable":false,"scopable":false,"default_value":null,"labels":{"en_US":"Identifier","fr_FR":"Identifiant"}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/attributes/release_date"}},"code":"release_date","type":"pim_catalog_date","group":"marketing","unique":false,"useable_as_grid_filter":true,"allowed_extensions":[],"metric_family":null,"default_metric_unit":null,"reference_data_name":null,"available_locales":[],"max_characters":null,"validation_rule":null,"validation_regexp":null,"wysiwyg_enabled":false,"number_min":null,"number_max":null,"decimals_allowed":false,"negative_allowed":false,"date_min":"2017-06-28T08:00:00","date_max":"2017-08-08T22:00:00","max_file_size":null,"minimum_input_length":null,"sort_order":1,"localizable":false,"scopable":false,"default_value":null,"labels":{"en_US":"Sale date","fr_FR":"Date des soldes"}},{"_links":{"self":{"href":"http://localhost:8080/api/rest/v1/attributes/food_composition"}},"code":"food_composition","type":"pim_catalog_table","group":"product","unique":false,"useable_as_grid_filter":false,"allowed_extensions":[],"metric_family":null,"default_metric_unit":null,"reference_data_name":null,"available_locales":[],"max_characters":null,"validation_rule":null,"validation_regexp":null,"wysiwyg_enabled":null,"number_min":null,"number_max":null,"decimals_allowed":null,"negative_allowed":null,"date_min":null,"date_max":null,"max_file_size":null,"minimum_input_length":null,"sort_order":0,"localizable":false,"scopable":false,"labels":{"en_US":"Composition","fr_FR":"Composition"},"guidelines":{},"auto_option_sorting":null,"is_read_only":null,"default_value":null,"table_configuration":[{"code":"ingredient","data_type":"select","labels":{"en_US":"Ingredient","fr_FR":"Ingrédient"},"validations":{},"is_required_for_completeness":true},{"code":"percentage","data_type":"number","labels":{"en_US":"%","fr_FR":"%"},"validations":{"max":100,"min":0,"decimals_allowed":true},"is_required_for_completeness":true},{"code":"allergen","data_type":"boolean","labels":{"en_US":"Allergen","fr_FR":"Allergène"},"validations":{},"is_required_for_completeness":false}]}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"post":{"summary":"Create a new attribute","operationId":"post_attributes","description":"This endpoint allows you to create a new attribute.","tags":["Attribute"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","required":["code","type","group"],"properties":{"code":{"type":"string","description":"Attribute code","x-immutable":true},"type":{"type":"string","description":"Attribute type. See type section for more details.","x-validation-rules":"The type is one of the following values","enum":["pim_catalog_identifier","pim_catalog_metric","pim_catalog_number","pim_catalog_reference_data_multi_select","pim_catalog_reference_data_simple_select","pim_catalog_simpleselect","pim_catalog_multiselect","pim_catalog_date","pim_catalog_textarea","pim_catalog_text","pim_catalog_file","pim_catalog_image","pim_catalog_price_collection","pim_catalog_boolean","akeneo_reference_entity","akeneo_reference_entity_collection","pim_catalog_asset_collection"],"x-immutable":true},"labels":{"type":"object","description":"Attribute labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute label for the locale `localeCode`"}}},"group":{"type":"string","description":"Attribute group","x-validation-rules":"It is the code of an existing group"},"group_labels":{"type":"object","description":"Group labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","x-read-only":true,"default":{},"properties":{"localeCode":{"type":"string","description":"Group label for the locale `localeCode`"}}},"sort_order":{"type":"integer","description":"Order of the attribute in its group","x-validation-rules":"It is a positive integer","default":0},"localizable":{"type":"boolean","description":"Whether the attribute is localizable, i.e. can have one value by locale","default":false,"x-immutable":true},"scopable":{"type":"boolean","description":"Whether the attribute is scopable, i.e. can have one value by channel","default":false,"x-immutable":true},"available_locales":{"type":"array","description":"To make the attribute locale specfic, specify here for which locales it is specific","x-validation-rules":"Each string of the array is an existing and activated locale","items":{"type":"string"}},"unique":{"type":"boolean","description":"Whether two values for the attribute cannot be the same","x-immutable":true},"useable_as_grid_filter":{"type":"boolean","description":"Whether the attribute can be used as a filter for the product grid in the PIM user interface"},"max_characters":{"type":"integer","description":"Number maximum of characters allowed for the value of the attribute when the attribute type is `pim_catalog_text`, `pim_catalog_textarea` or `pim_catalog_identifier`","x-warning":"Only for `pim_catalog_text`, `pim_catalog_textarea` or `pim_catalog_identifier` attribute types"},"validation_rule":{"type":"string","description":"Validation rule type used to validate any attribute value when the attribute type is `pim_catalog_text` or `pim_catalog_identifier`","x-validation-rules":"Equal to `regexp` when the attribute type is equal to `pim_catalog_identifier`","x-warning":"Only for `pim_catalog_text` or `pim_catalog_identifier` attribute types"},"validation_regexp":{"type":"string","description":"Regexp expression used to validate any attribute value when the attribute type is `pim_catalog_text` or `pim_catalog_identifier`","x-validation-rules":"Required when the property `validation_rule` is equal to `regexp`","x-warning":"Only for `pim_catalog_text` or `pim_catalog_identifier` attribute types"},"wysiwyg_enabled":{"type":"boolean","description":"Whether the WYSIWYG interface is shown when the attribute type is `pim_catalog_textarea`","x-warning":"Only for `pim_catalog_textarea` attribute type"},"number_min":{"type":"string","description":"Minimum integer value allowed when the attribute type is `pim_catalog_metric`, `pim_catalog_price` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric`, `pim_catalog_price_collection` or `pim_catalog_number` attribute types"},"number_max":{"type":"string","description":"Maximum integer value allowed when the attribute type is `pim_catalog_metric`, `pim_catalog_price` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric`, `pim_catalog_price_collection` or `pim_catalog_number` attribute types"},"decimals_allowed":{"type":"boolean","description":"Whether decimals are allowed when the attribute type is `pim_catalog_metric`, `pim_catalog_price` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric`, `pim_catalog_price_collection` or `pim_catalog_number` attribute types"},"negative_allowed":{"type":"boolean","description":"Whether negative values are allowed when the attribute type is `pim_catalog_metric` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric` or `pim_catalog_number` attribute types"},"metric_family":{"type":"string","description":"Metric family when the attribute type is `pim_catalog_metric`","x-immutable":true,"x-validation-rules":"Required for `pim_catalog_metric` attribute type","x-warning":"Only for `pim_catalog_metric` attribute type"},"default_metric_unit":{"type":"string","description":"Default metric unit when the attribute type is `pim_catalog_metric`","x-validation-rules":"Required for `pim_catalog_metric` attribute type","x-warning":"Only for `pim_catalog_metric` attribute type"},"date_min":{"type":"string","description":"Minimum date allowed when the attribute type is `pim_catalog_date`","x-validation-rules":"The datetime format follows the ISO-8601 norm","x-warning":"Only for `pim_catalog_date` attribute type","format":"date-time"},"date_max":{"type":"string","description":"Maximum date allowed when the attribute type is `pim_catalog_date`","x-validation-rules":"The datetime format follows the ISO-8601 norm","x-warning":"Only for `pim_catalog_date` attribute type","format":"date-time"},"allowed_extensions":{"type":"array","description":"Extensions allowed when the attribute type is `pim_catalog_file` or `pim_catalog_image`","x-warning":"Only for `pim_catalog_file` or `pim_catalog_image` attribute types","items":{"type":"string"}},"max_file_size":{"type":"string","description":"Max file size in MB when the attribute type is `pim_catalog_file` or `pim_catalog_image`","x-warning":"Only for `pim_catalog_file` or `pim_catalog_image` attribute types"},"reference_data_name":{"type":"string","description":"Reference entity code when the attribute type is `akeneo_reference_entity` or `akeneo_reference_entity_collection` OR Asset family code when the attribute type is `pim_catalog_asset_collection`","x-validation-rules":"Required only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types","x-warning":"Only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types"},"default_value":{"type":"boolean","description":"Default value for a Yes/No attribute, applied when creating a new product or product model (only available since the 5.0)","x-warning":"Only for `pim_catalog_boolean` attribute type","x-from-version":"5.0"},"table_configuration":{"type":"array","description":"Configuration of the Table attribute (columns)","x-validation-rules":"Required only for `pim_catalog_table` attribute type","x-warning":"Only for `pim_catalog_table` attribute type","items":{"type":"object","required":["code","data_type"],"properties":{"code":{"type":"string","description":"Column code"},"data_type":{"type":"string","enum":["select","text","number","boolean"],"description":"Column data type"},"validations":{"type":"object","description":"User defined validation constraints on the cell content","default":{},"properties":{"min":{"type":"number","description":"minimum value of a numeric cell","x-validation-rules":"only for `number` data type columns"},"max":{"type":"number","description":"maximum value of a numeric cell","x-validation-rules":"only for `number` data type columns"},"decimals_allowed":{"type":"boolean","description":"whether the value of a numeric cell can hold a decimal part","x-validation-rules":"only for `number` data type columns"},"max_length":{"type":"number","description":"maximum length of a text cell","x-validation-rules":"only for `text` data type columns"}}},"labels":{"type":"object","description":"Column labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Column label for the locale `localeCode`"}}},"is_required_for_completeness":{"type":"boolean","description":"Defines if the column should be entirely filled for the attribute to be considered complete","x-warning":"This value is always true for the first column in a table configuration","default":false}}}},"is_main_identifier":{"type":"boolean","description":"Is this attribute main identifier when attribute type is `pim_catalog_identifier`"}},"example":{"code":"release_date","type":"pim_catalog_date","group":"marketing","group_labels":{"en_US":"Marketing","fr_FR":"Marketing"},"unique":false,"useable_as_grid_filter":true,"allowed_extensions":[],"metric_family":null,"default_metric_unit":null,"reference_data_name":null,"available_locales":[],"max_characters":null,"validation_rule":null,"validation_regexp":null,"wysiwyg_enabled":null,"number_min":null,"number_max":null,"decimals_allowed":null,"negative_allowed":null,"date_min":"2017-06-28T08:00:00","date_max":"2017-08-08T22:00:00","max_file_size":null,"minimum_input_length":null,"sort_order":1,"localizable":false,"scopable":false,"default_value":null,"labels":{"en_US":"Sale date","fr_FR":"Date des soldes"}}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}},"patch":{"summary":"Update/create several attributes","operationId":"patch_attributes","tags":["Attribute"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to update and/or create several attributes at once.","x-body-by-line":"Contains several lines, each line is an attribute in JSON standard format","parameters":[{"name":"body","in":"body","schema":{"x-examples":{"x-example-1":"{\"code\":\"description\",\"useable_as_grid_filter\":true}","x-example-2":"{\"code\":\"short_description\",\"group\":\"marketig\"}","x-example-3":"{\"code\":\"release_date\",\"date_min\":\"2017-06-28T08:00:00\"}"},"type":"object","required":["code","type","group"],"properties":{"code":{"type":"string","description":"Attribute code","x-immutable":true},"type":{"type":"string","description":"Attribute type. See type section for more details.","x-validation-rules":"The type is one of the following values","enum":["pim_catalog_identifier","pim_catalog_metric","pim_catalog_number","pim_catalog_reference_data_multi_select","pim_catalog_reference_data_simple_select","pim_catalog_simpleselect","pim_catalog_multiselect","pim_catalog_date","pim_catalog_textarea","pim_catalog_text","pim_catalog_file","pim_catalog_image","pim_catalog_price_collection","pim_catalog_boolean","akeneo_reference_entity","akeneo_reference_entity_collection","pim_catalog_asset_collection"],"x-immutable":true},"labels":{"type":"object","description":"Attribute labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute label for the locale `localeCode`"}}},"group":{"type":"string","description":"Attribute group","x-validation-rules":"It is the code of an existing group"},"group_labels":{"type":"object","description":"Group labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","x-read-only":true,"default":{},"properties":{"localeCode":{"type":"string","description":"Group label for the locale `localeCode`"}}},"sort_order":{"type":"integer","description":"Order of the attribute in its group","x-validation-rules":"It is a positive integer","default":0},"localizable":{"type":"boolean","description":"Whether the attribute is localizable, i.e. can have one value by locale","default":false,"x-immutable":true},"scopable":{"type":"boolean","description":"Whether the attribute is scopable, i.e. can have one value by channel","default":false,"x-immutable":true},"available_locales":{"type":"array","description":"To make the attribute locale specfic, specify here for which locales it is specific","x-validation-rules":"Each string of the array is an existing and activated locale","items":{"type":"string"}},"unique":{"type":"boolean","description":"Whether two values for the attribute cannot be the same","x-immutable":true},"useable_as_grid_filter":{"type":"boolean","description":"Whether the attribute can be used as a filter for the product grid in the PIM user interface"},"max_characters":{"type":"integer","description":"Number maximum of characters allowed for the value of the attribute when the attribute type is `pim_catalog_text`, `pim_catalog_textarea` or `pim_catalog_identifier`","x-warning":"Only for `pim_catalog_text`, `pim_catalog_textarea` or `pim_catalog_identifier` attribute types"},"validation_rule":{"type":"string","description":"Validation rule type used to validate any attribute value when the attribute type is `pim_catalog_text` or `pim_catalog_identifier`","x-validation-rules":"Equal to `regexp` when the attribute type is equal to `pim_catalog_identifier`","x-warning":"Only for `pim_catalog_text` or `pim_catalog_identifier` attribute types"},"validation_regexp":{"type":"string","description":"Regexp expression used to validate any attribute value when the attribute type is `pim_catalog_text` or `pim_catalog_identifier`","x-validation-rules":"Required when the property `validation_rule` is equal to `regexp`","x-warning":"Only for `pim_catalog_text` or `pim_catalog_identifier` attribute types"},"wysiwyg_enabled":{"type":"boolean","description":"Whether the WYSIWYG interface is shown when the attribute type is `pim_catalog_textarea`","x-warning":"Only for `pim_catalog_textarea` attribute type"},"number_min":{"type":"string","description":"Minimum integer value allowed when the attribute type is `pim_catalog_metric`, `pim_catalog_price` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric`, `pim_catalog_price_collection` or `pim_catalog_number` attribute types"},"number_max":{"type":"string","description":"Maximum integer value allowed when the attribute type is `pim_catalog_metric`, `pim_catalog_price` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric`, `pim_catalog_price_collection` or `pim_catalog_number` attribute types"},"decimals_allowed":{"type":"boolean","description":"Whether decimals are allowed when the attribute type is `pim_catalog_metric`, `pim_catalog_price` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric`, `pim_catalog_price_collection` or `pim_catalog_number` attribute types"},"negative_allowed":{"type":"boolean","description":"Whether negative values are allowed when the attribute type is `pim_catalog_metric` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric` or `pim_catalog_number` attribute types"},"metric_family":{"type":"string","description":"Metric family when the attribute type is `pim_catalog_metric`","x-immutable":true,"x-validation-rules":"Required for `pim_catalog_metric` attribute type","x-warning":"Only for `pim_catalog_metric` attribute type"},"default_metric_unit":{"type":"string","description":"Default metric unit when the attribute type is `pim_catalog_metric`","x-validation-rules":"Required for `pim_catalog_metric` attribute type","x-warning":"Only for `pim_catalog_metric` attribute type"},"date_min":{"type":"string","description":"Minimum date allowed when the attribute type is `pim_catalog_date`","x-validation-rules":"The datetime format follows the ISO-8601 norm","x-warning":"Only for `pim_catalog_date` attribute type","format":"date-time"},"date_max":{"type":"string","description":"Maximum date allowed when the attribute type is `pim_catalog_date`","x-validation-rules":"The datetime format follows the ISO-8601 norm","x-warning":"Only for `pim_catalog_date` attribute type","format":"date-time"},"allowed_extensions":{"type":"array","description":"Extensions allowed when the attribute type is `pim_catalog_file` or `pim_catalog_image`","x-warning":"Only for `pim_catalog_file` or `pim_catalog_image` attribute types","items":{"type":"string"}},"max_file_size":{"type":"string","description":"Max file size in MB when the attribute type is `pim_catalog_file` or `pim_catalog_image`","x-warning":"Only for `pim_catalog_file` or `pim_catalog_image` attribute types"},"reference_data_name":{"type":"string","description":"Reference entity code when the attribute type is `akeneo_reference_entity` or `akeneo_reference_entity_collection` OR Asset family code when the attribute type is `pim_catalog_asset_collection`","x-validation-rules":"Required only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types","x-warning":"Only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types"},"default_value":{"type":"boolean","description":"Default value for a Yes/No attribute, applied when creating a new product or product model (only available since the 5.0)","x-warning":"Only for `pim_catalog_boolean` attribute type","x-from-version":"5.0"},"table_configuration":{"type":"array","description":"Configuration of the Table attribute (columns)","x-validation-rules":"Required only for `pim_catalog_table` attribute type","x-warning":"Only for `pim_catalog_table` attribute type","items":{"type":"object","required":["code","data_type"],"properties":{"code":{"type":"string","description":"Column code"},"data_type":{"type":"string","enum":["select","text","number","boolean"],"description":"Column data type"},"validations":{"type":"object","description":"User defined validation constraints on the cell content","default":{},"properties":{"min":{"type":"number","description":"minimum value of a numeric cell","x-validation-rules":"only for `number` data type columns"},"max":{"type":"number","description":"maximum value of a numeric cell","x-validation-rules":"only for `number` data type columns"},"decimals_allowed":{"type":"boolean","description":"whether the value of a numeric cell can hold a decimal part","x-validation-rules":"only for `number` data type columns"},"max_length":{"type":"number","description":"maximum length of a text cell","x-validation-rules":"only for `text` data type columns"}}},"labels":{"type":"object","description":"Column labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Column label for the locale `localeCode`"}}},"is_required_for_completeness":{"type":"boolean","description":"Defines if the column should be entirely filled for the attribute to be considered complete","x-warning":"This value is always true for the first column in a table configuration","default":false}}}},"is_main_identifier":{"type":"boolean","description":"Is this attribute main identifier when attribute type is `pim_catalog_identifier`"}},"example":{"code":"release_date","type":"pim_catalog_date","group":"marketing","group_labels":{"en_US":"Marketing","fr_FR":"Marketing"},"unique":false,"useable_as_grid_filter":true,"allowed_extensions":[],"metric_family":null,"default_metric_unit":null,"reference_data_name":null,"available_locales":[],"max_characters":null,"validation_rule":null,"validation_regexp":null,"wysiwyg_enabled":null,"number_min":null,"number_max":null,"decimals_allowed":null,"negative_allowed":null,"date_min":"2017-06-28T08:00:00","date_max":"2017-08-08T22:00:00","max_file_size":null,"minimum_input_length":null,"sort_order":1,"localizable":false,"scopable":false,"default_value":null,"labels":{"en_US":"Sale date","fr_FR":"Date des soldes"}}}}],"responses":{"200":{"description":"OK","x-details":"Returns a plain text response whose lines are JSON containing the status of each update or creation","x-no-entity":true,"schema":{"type":"object","properties":{"line":{"type":"integer","description":"Line number"},"identifier":{"type":"string","description":"Resource identifier, only filled when the resource is a product"},"code":{"type":"string","description":"Resource code, only filled when the resource is not a product"},"status_code":{"type":"integer","description":"HTTP status code, see Client errors to understand the meaning of each code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"x-example-1":"{\"line\":1,\"code\":\"description\",\"status_code\":201}","x-example-2":"{\"line\":2,\"code\":\"short_description\",\"status_code\":422,\"message\":\"Group \\\"marketig\\\" does not exist.\"}","x-example-3":"{\"line\":3,\"code\":\"release_date\",\"status_code\":204}"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"413":{"description":"Request Entity Too Large","x-details":"There are too many resources to process (max 100) or the line of JSON is too long (max 1 000 000 characters)","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":413,"message":"Too many resources to process, 100 is the maximum allowed."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/vnd.akeneo.collection+json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/vnd.akeneo.collection+json’ is allowed."}}}}},"/api/rest/v1/attributes/{code}":{"get":{"summary":"Get an attribute","operationId":"get_attributes__code_","description":"This endpoint allows you to get the information about a given attribute.","tags":["Attribute"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"},{"name":"with_table_select_options","in":"query","description":"Return the options of 'select' column types (of a table attribute) in the response. (Only available since the 7.0 version)","default":false,"type":"boolean","required":false,"x-from-version":"7.0"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the attribute in JSON standard format","schema":{"type":"object","required":["code","type","group"],"properties":{"code":{"type":"string","description":"Attribute code","x-immutable":true},"type":{"type":"string","description":"Attribute type. See type section for more details.","x-validation-rules":"The type is one of the following values","enum":["pim_catalog_identifier","pim_catalog_metric","pim_catalog_number","pim_catalog_reference_data_multi_select","pim_catalog_reference_data_simple_select","pim_catalog_simpleselect","pim_catalog_multiselect","pim_catalog_date","pim_catalog_textarea","pim_catalog_text","pim_catalog_file","pim_catalog_image","pim_catalog_price_collection","pim_catalog_boolean","akeneo_reference_entity","akeneo_reference_entity_collection","pim_catalog_asset_collection"],"x-immutable":true},"labels":{"type":"object","description":"Attribute labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute label for the locale `localeCode`"}}},"group":{"type":"string","description":"Attribute group","x-validation-rules":"It is the code of an existing group"},"group_labels":{"type":"object","description":"Group labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","x-read-only":true,"default":{},"properties":{"localeCode":{"type":"string","description":"Group label for the locale `localeCode`"}}},"sort_order":{"type":"integer","description":"Order of the attribute in its group","x-validation-rules":"It is a positive integer","default":0},"localizable":{"type":"boolean","description":"Whether the attribute is localizable, i.e. can have one value by locale","default":false,"x-immutable":true},"scopable":{"type":"boolean","description":"Whether the attribute is scopable, i.e. can have one value by channel","default":false,"x-immutable":true},"available_locales":{"type":"array","description":"To make the attribute locale specfic, specify here for which locales it is specific","x-validation-rules":"Each string of the array is an existing and activated locale","items":{"type":"string"}},"unique":{"type":"boolean","description":"Whether two values for the attribute cannot be the same","x-immutable":true},"useable_as_grid_filter":{"type":"boolean","description":"Whether the attribute can be used as a filter for the product grid in the PIM user interface"},"max_characters":{"type":"integer","description":"Number maximum of characters allowed for the value of the attribute when the attribute type is `pim_catalog_text`, `pim_catalog_textarea` or `pim_catalog_identifier`","x-warning":"Only for `pim_catalog_text`, `pim_catalog_textarea` or `pim_catalog_identifier` attribute types"},"validation_rule":{"type":"string","description":"Validation rule type used to validate any attribute value when the attribute type is `pim_catalog_text` or `pim_catalog_identifier`","x-validation-rules":"Equal to `regexp` when the attribute type is equal to `pim_catalog_identifier`","x-warning":"Only for `pim_catalog_text` or `pim_catalog_identifier` attribute types"},"validation_regexp":{"type":"string","description":"Regexp expression used to validate any attribute value when the attribute type is `pim_catalog_text` or `pim_catalog_identifier`","x-validation-rules":"Required when the property `validation_rule` is equal to `regexp`","x-warning":"Only for `pim_catalog_text` or `pim_catalog_identifier` attribute types"},"wysiwyg_enabled":{"type":"boolean","description":"Whether the WYSIWYG interface is shown when the attribute type is `pim_catalog_textarea`","x-warning":"Only for `pim_catalog_textarea` attribute type"},"number_min":{"type":"string","description":"Minimum integer value allowed when the attribute type is `pim_catalog_metric`, `pim_catalog_price` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric`, `pim_catalog_price_collection` or `pim_catalog_number` attribute types"},"number_max":{"type":"string","description":"Maximum integer value allowed when the attribute type is `pim_catalog_metric`, `pim_catalog_price` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric`, `pim_catalog_price_collection` or `pim_catalog_number` attribute types"},"decimals_allowed":{"type":"boolean","description":"Whether decimals are allowed when the attribute type is `pim_catalog_metric`, `pim_catalog_price` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric`, `pim_catalog_price_collection` or `pim_catalog_number` attribute types"},"negative_allowed":{"type":"boolean","description":"Whether negative values are allowed when the attribute type is `pim_catalog_metric` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric` or `pim_catalog_number` attribute types"},"metric_family":{"type":"string","description":"Metric family when the attribute type is `pim_catalog_metric`","x-immutable":true,"x-validation-rules":"Required for `pim_catalog_metric` attribute type","x-warning":"Only for `pim_catalog_metric` attribute type"},"default_metric_unit":{"type":"string","description":"Default metric unit when the attribute type is `pim_catalog_metric`","x-validation-rules":"Required for `pim_catalog_metric` attribute type","x-warning":"Only for `pim_catalog_metric` attribute type"},"date_min":{"type":"string","description":"Minimum date allowed when the attribute type is `pim_catalog_date`","x-validation-rules":"The datetime format follows the ISO-8601 norm","x-warning":"Only for `pim_catalog_date` attribute type","format":"date-time"},"date_max":{"type":"string","description":"Maximum date allowed when the attribute type is `pim_catalog_date`","x-validation-rules":"The datetime format follows the ISO-8601 norm","x-warning":"Only for `pim_catalog_date` attribute type","format":"date-time"},"allowed_extensions":{"type":"array","description":"Extensions allowed when the attribute type is `pim_catalog_file` or `pim_catalog_image`","x-warning":"Only for `pim_catalog_file` or `pim_catalog_image` attribute types","items":{"type":"string"}},"max_file_size":{"type":"string","description":"Max file size in MB when the attribute type is `pim_catalog_file` or `pim_catalog_image`","x-warning":"Only for `pim_catalog_file` or `pim_catalog_image` attribute types"},"reference_data_name":{"type":"string","description":"Reference entity code when the attribute type is `akeneo_reference_entity` or `akeneo_reference_entity_collection` OR Asset family code when the attribute type is `pim_catalog_asset_collection`","x-validation-rules":"Required only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types","x-warning":"Only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types"},"default_value":{"type":"boolean","description":"Default value for a Yes/No attribute, applied when creating a new product or product model (only available since the 5.0)","x-warning":"Only for `pim_catalog_boolean` attribute type","x-from-version":"5.0"},"table_configuration":{"type":"array","description":"Configuration of the Table attribute (columns)","x-validation-rules":"Required only for `pim_catalog_table` attribute type","x-warning":"Only for `pim_catalog_table` attribute type","items":{"type":"object","required":["code","data_type"],"properties":{"code":{"type":"string","description":"Column code"},"data_type":{"type":"string","enum":["select","text","number","boolean"],"description":"Column data type"},"validations":{"type":"object","description":"User defined validation constraints on the cell content","default":{},"properties":{"min":{"type":"number","description":"minimum value of a numeric cell","x-validation-rules":"only for `number` data type columns"},"max":{"type":"number","description":"maximum value of a numeric cell","x-validation-rules":"only for `number` data type columns"},"decimals_allowed":{"type":"boolean","description":"whether the value of a numeric cell can hold a decimal part","x-validation-rules":"only for `number` data type columns"},"max_length":{"type":"number","description":"maximum length of a text cell","x-validation-rules":"only for `text` data type columns"}}},"labels":{"type":"object","description":"Column labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Column label for the locale `localeCode`"}}},"is_required_for_completeness":{"type":"boolean","description":"Defines if the column should be entirely filled for the attribute to be considered complete","x-warning":"This value is always true for the first column in a table configuration","default":false}}}},"is_main_identifier":{"type":"boolean","description":"Is this attribute main identifier when attribute type is `pim_catalog_identifier`"}},"example":{"code":"release_date","type":"pim_catalog_date","group":"marketing","group_labels":{"en_US":"Marketing","fr_FR":"Marketing"},"unique":false,"useable_as_grid_filter":true,"allowed_extensions":[],"metric_family":null,"default_metric_unit":null,"reference_data_name":null,"available_locales":[],"max_characters":null,"validation_rule":null,"validation_regexp":null,"wysiwyg_enabled":null,"number_min":null,"number_max":null,"decimals_allowed":null,"negative_allowed":null,"date_min":"2017-06-28T08:00:00","date_max":"2017-08-08T22:00:00","max_file_size":null,"minimum_input_length":null,"sort_order":1,"localizable":false,"scopable":false,"default_value":null,"labels":{"en_US":"Sale date","fr_FR":"Date des soldes"}}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"patch":{"summary":"Update/create an attribute","operationId":"patch_attributes__code_","tags":["Attribute"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to update a given attribute. Know more about Update behavior. Note that if no attribute exists for the given code, it creates it.","parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"},{"name":"body","in":"body","required":true,"schema":{"type":"object","required":["code","type","group"],"properties":{"code":{"type":"string","description":"Attribute code","x-immutable":true},"type":{"type":"string","description":"Attribute type. See type section for more details.","x-validation-rules":"The type is one of the following values","enum":["pim_catalog_identifier","pim_catalog_metric","pim_catalog_number","pim_catalog_reference_data_multi_select","pim_catalog_reference_data_simple_select","pim_catalog_simpleselect","pim_catalog_multiselect","pim_catalog_date","pim_catalog_textarea","pim_catalog_text","pim_catalog_file","pim_catalog_image","pim_catalog_price_collection","pim_catalog_boolean","akeneo_reference_entity","akeneo_reference_entity_collection","pim_catalog_asset_collection"],"x-immutable":true},"labels":{"type":"object","description":"Attribute labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute label for the locale `localeCode`"}}},"group":{"type":"string","description":"Attribute group","x-validation-rules":"It is the code of an existing group"},"group_labels":{"type":"object","description":"Group labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","x-read-only":true,"default":{},"properties":{"localeCode":{"type":"string","description":"Group label for the locale `localeCode`"}}},"sort_order":{"type":"integer","description":"Order of the attribute in its group","x-validation-rules":"It is a positive integer","default":0},"localizable":{"type":"boolean","description":"Whether the attribute is localizable, i.e. can have one value by locale","default":false,"x-immutable":true},"scopable":{"type":"boolean","description":"Whether the attribute is scopable, i.e. can have one value by channel","default":false,"x-immutable":true},"available_locales":{"type":"array","description":"To make the attribute locale specfic, specify here for which locales it is specific","x-validation-rules":"Each string of the array is an existing and activated locale","items":{"type":"string"}},"unique":{"type":"boolean","description":"Whether two values for the attribute cannot be the same","x-immutable":true},"useable_as_grid_filter":{"type":"boolean","description":"Whether the attribute can be used as a filter for the product grid in the PIM user interface"},"max_characters":{"type":"integer","description":"Number maximum of characters allowed for the value of the attribute when the attribute type is `pim_catalog_text`, `pim_catalog_textarea` or `pim_catalog_identifier`","x-warning":"Only for `pim_catalog_text`, `pim_catalog_textarea` or `pim_catalog_identifier` attribute types"},"validation_rule":{"type":"string","description":"Validation rule type used to validate any attribute value when the attribute type is `pim_catalog_text` or `pim_catalog_identifier`","x-validation-rules":"Equal to `regexp` when the attribute type is equal to `pim_catalog_identifier`","x-warning":"Only for `pim_catalog_text` or `pim_catalog_identifier` attribute types"},"validation_regexp":{"type":"string","description":"Regexp expression used to validate any attribute value when the attribute type is `pim_catalog_text` or `pim_catalog_identifier`","x-validation-rules":"Required when the property `validation_rule` is equal to `regexp`","x-warning":"Only for `pim_catalog_text` or `pim_catalog_identifier` attribute types"},"wysiwyg_enabled":{"type":"boolean","description":"Whether the WYSIWYG interface is shown when the attribute type is `pim_catalog_textarea`","x-warning":"Only for `pim_catalog_textarea` attribute type"},"number_min":{"type":"string","description":"Minimum integer value allowed when the attribute type is `pim_catalog_metric`, `pim_catalog_price` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric`, `pim_catalog_price_collection` or `pim_catalog_number` attribute types"},"number_max":{"type":"string","description":"Maximum integer value allowed when the attribute type is `pim_catalog_metric`, `pim_catalog_price` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric`, `pim_catalog_price_collection` or `pim_catalog_number` attribute types"},"decimals_allowed":{"type":"boolean","description":"Whether decimals are allowed when the attribute type is `pim_catalog_metric`, `pim_catalog_price` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric`, `pim_catalog_price_collection` or `pim_catalog_number` attribute types"},"negative_allowed":{"type":"boolean","description":"Whether negative values are allowed when the attribute type is `pim_catalog_metric` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric` or `pim_catalog_number` attribute types"},"metric_family":{"type":"string","description":"Metric family when the attribute type is `pim_catalog_metric`","x-immutable":true,"x-validation-rules":"Required for `pim_catalog_metric` attribute type","x-warning":"Only for `pim_catalog_metric` attribute type"},"default_metric_unit":{"type":"string","description":"Default metric unit when the attribute type is `pim_catalog_metric`","x-validation-rules":"Required for `pim_catalog_metric` attribute type","x-warning":"Only for `pim_catalog_metric` attribute type"},"date_min":{"type":"string","description":"Minimum date allowed when the attribute type is `pim_catalog_date`","x-validation-rules":"The datetime format follows the ISO-8601 norm","x-warning":"Only for `pim_catalog_date` attribute type","format":"date-time"},"date_max":{"type":"string","description":"Maximum date allowed when the attribute type is `pim_catalog_date`","x-validation-rules":"The datetime format follows the ISO-8601 norm","x-warning":"Only for `pim_catalog_date` attribute type","format":"date-time"},"allowed_extensions":{"type":"array","description":"Extensions allowed when the attribute type is `pim_catalog_file` or `pim_catalog_image`","x-warning":"Only for `pim_catalog_file` or `pim_catalog_image` attribute types","items":{"type":"string"}},"max_file_size":{"type":"string","description":"Max file size in MB when the attribute type is `pim_catalog_file` or `pim_catalog_image`","x-warning":"Only for `pim_catalog_file` or `pim_catalog_image` attribute types"},"reference_data_name":{"type":"string","description":"Reference entity code when the attribute type is `akeneo_reference_entity` or `akeneo_reference_entity_collection` OR Asset family code when the attribute type is `pim_catalog_asset_collection`","x-validation-rules":"Required only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types","x-warning":"Only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types"},"default_value":{"type":"boolean","description":"Default value for a Yes/No attribute, applied when creating a new product or product model (only available since the 5.0)","x-warning":"Only for `pim_catalog_boolean` attribute type","x-from-version":"5.0"},"table_configuration":{"type":"array","description":"Configuration of the Table attribute (columns)","x-validation-rules":"Required only for `pim_catalog_table` attribute type","x-warning":"Only for `pim_catalog_table` attribute type","items":{"type":"object","required":["code","data_type"],"properties":{"code":{"type":"string","description":"Column code"},"data_type":{"type":"string","enum":["select","text","number","boolean"],"description":"Column data type"},"validations":{"type":"object","description":"User defined validation constraints on the cell content","default":{},"properties":{"min":{"type":"number","description":"minimum value of a numeric cell","x-validation-rules":"only for `number` data type columns"},"max":{"type":"number","description":"maximum value of a numeric cell","x-validation-rules":"only for `number` data type columns"},"decimals_allowed":{"type":"boolean","description":"whether the value of a numeric cell can hold a decimal part","x-validation-rules":"only for `number` data type columns"},"max_length":{"type":"number","description":"maximum length of a text cell","x-validation-rules":"only for `text` data type columns"}}},"labels":{"type":"object","description":"Column labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Column label for the locale `localeCode`"}}},"is_required_for_completeness":{"type":"boolean","description":"Defines if the column should be entirely filled for the attribute to be considered complete","x-warning":"This value is always true for the first column in a table configuration","default":false}}}},"is_main_identifier":{"type":"boolean","description":"Is this attribute main identifier when attribute type is `pim_catalog_identifier`"}},"example":{"code":"release_date","type":"pim_catalog_date","group":"marketing","group_labels":{"en_US":"Marketing","fr_FR":"Marketing"},"unique":false,"useable_as_grid_filter":true,"allowed_extensions":[],"metric_family":null,"default_metric_unit":null,"reference_data_name":null,"available_locales":[],"max_characters":null,"validation_rule":null,"validation_regexp":null,"wysiwyg_enabled":null,"number_min":null,"number_max":null,"decimals_allowed":null,"negative_allowed":null,"date_min":"2017-06-28T08:00:00","date_max":"2017-08-08T22:00:00","max_file_size":null,"minimum_input_length":null,"sort_order":1,"localizable":false,"scopable":false,"default_value":null,"labels":{"en_US":"Sale date","fr_FR":"Date des soldes"}}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"204":{"description":"No content to return","x-details":"Means that the update was successful","headers":{"Location":{"description":"URI of the updated resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/attributes/{attribute_code}/options":{"get":{"summary":"Get list of attribute options","operationId":"get_attributes__attribute_code__options","description":"This endpoint allows you to get a list of attribute options. Attribute options are paginated and sorted by code.","tags":["Attribute option"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"attribute_code","in":"path","description":"Code of the attribute","required":true,"type":"string"},{"name":"page","in":"query","description":"Number of the page to retrieve when using the `page` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"integer","default":1},{"name":"limit","in":"query","description":"Number of results by page, see Pagination section","required":false,"type":"integer","minimum":1,"maximum":100,"default":10},{"name":"with_count","in":"query","description":"Return the count of items in the response. Be carefull with that, on a big catalog, it can decrease performance in a significative way","default":false,"type":"boolean","required":false}],"responses":{"200":{"description":"Return attribute options paginated","schema":{"title":"Attribute Options","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"previous":{"type":"object","properties":{"href":{"type":"string","description":"URI of the previous page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}},"current_page":{"type":"integer","description":"Current page number"}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Code of option"},"attribute":{"type":"string","description":"Code of attribute related to the attribute option","x-validation-rules":"It is the same attribute code as the one given as path parameter"},"sort_order":{"type":"integer","description":"Order of attribute option","x-validation-rules":"It is a positive integer"},"labels":{"type":"object","description":"Attribute option labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute option label for the locale `localeCode`"}}}},"example":{"code":"black","attribute":"a_simple_select","sort_order":2,"labels":{"en_US":"Black","fr_FR":"Noir"}}}]}}}}}}]},"examples":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/attributes/color/options?page=3&limit=3"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/attributes/color/options?page=1&limit=3"},"previous":{"href":"https://demo.akeneo.com/api/rest/v1/attributes/color/options?page=2&limit=3"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/attributes/color/options?page=4&limit=3"}},"current_page":3,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/attributes/color/options/red"}},"code":"red","attribute":"a_simple_select","sort_order":1,"labels":{"en_US":"Red","fr_FR":"Rouge"}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/attributes/color/options/black"}},"code":"black","attribute":"a_simple_select","sort_order":2,"labels":{"en_US":"Black","fr_FR":"Noir"}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/attributes/color/options/purple"}},"code":"purple","attribute":"a_simple_select","sort_order":3,"labels":{"en_US":"Purple","fr_FR":"Violet"}}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"post":{"summary":"Create a new attribute option","operationId":"post_attributes__attribute_code__options","description":"This endpoint allows you to create a new attribute option.","tags":["Attribute option"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"attribute_code","in":"path","description":"Code of the attribute","required":true,"type":"string"},{"name":"body","in":"body","schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Code of option"},"attribute":{"type":"string","description":"Code of attribute related to the attribute option","x-validation-rules":"It is the same attribute code as the one given as path parameter"},"sort_order":{"type":"integer","description":"Order of attribute option","x-validation-rules":"It is a positive integer"},"labels":{"type":"object","description":"Attribute option labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute option label for the locale `localeCode`"}}}},"example":{"code":"black","attribute":"a_simple_select","sort_order":2,"labels":{"en_US":"Black","fr_FR":"Noir"}}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}},"patch":{"summary":"Update/create several attribute options","operationId":"patch_attributes__attribute_code__options","tags":["Attribute option"],"x-versions":["2.1","2.2","2.3","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to update several attribute options at once. Please note that this endpoint applies a rate limit of 3 concurrent API requests per second.","x-body-by-line":"Contains several lines, each line is an attribute option in JSON standard format","parameters":[{"name":"attribute_code","in":"path","description":"Code of the attribute","required":true,"type":"string"},{"name":"body","in":"body","schema":{"x-examples":{"x-example-1":"{\"code\":\"black\", \"attribute\":\"a_simple_select\", \"labels\":{\"en_US\": \"Black\",\"fr_FR\": \"Noir\"}}","x-example-2":"{\"code\":\"red\", \"label\":{\"en_US\": \"Red\",\"fr_FR\": \"Rouge\"}}","x-example-3":"{\"code\":\"yellow\", \"labels\":{\"en_US\": \"Yellow\",\"fr_FR\": \"Jaune\"}}"},"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Code of option"},"attribute":{"type":"string","description":"Code of attribute related to the attribute option","x-validation-rules":"It is the same attribute code as the one given as path parameter"},"sort_order":{"type":"integer","description":"Order of attribute option","x-validation-rules":"It is a positive integer"},"labels":{"type":"object","description":"Attribute option labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute option label for the locale `localeCode`"}}}},"example":{"code":"black","attribute":"a_simple_select","sort_order":2,"labels":{"en_US":"Black","fr_FR":"Noir"}}}}],"responses":{"200":{"description":"OK","x-details":"Returns a plain text response whose lines are JSON containing the status of each update or creation","x-no-entity":true,"schema":{"type":"object","properties":{"line":{"type":"integer","description":"Line number"},"identifier":{"type":"string","description":"Resource identifier, only filled when the resource is a product"},"code":{"type":"string","description":"Resource code, only filled when the resource is not a product"},"status_code":{"type":"integer","description":"HTTP status code, see Client errors to understand the meaning of each code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"x-example-1":"{\"line\":1,\"code\":\"black\",\"status_code\":201}","x-example-2":"{\"line\":2,\"code\":\"red\",\"status_code\":422,\"message\":\"Property \\\"label\\\" does not exist. Check the API format documentation.\"}","x-example-3":"{\"line\":3,\"code\":\"yellow\",\"status_code\":204}"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"413":{"description":"Request Entity Too Large","x-details":"There are too many resources to process (max 100) or the line of JSON is too long (max 1 000 000 characters)","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":413,"message":"Too many resources to process, 100 is the maximum allowed."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/vnd.akeneo.collection+json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/vnd.akeneo.collection+json’ is allowed."}},"429":{"description":"Too many requests","x-details":"There are too many requests on this endpoint","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":429,"message":"You have exceeded the limit of API requests per second."}}}}},"/api/rest/v1/attributes/{attribute_code}/options/{code}":{"get":{"summary":"Get an attribute option","operationId":"get_attributes__attribute_code__options__code_","description":"This endpoint allows you to get the information about a given attribute option.","tags":["Attribute option"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"attribute_code","in":"path","description":"Code of the attribute","required":true,"type":"string"},{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the attribute option in JSON standard format","schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Code of option"},"attribute":{"type":"string","description":"Code of attribute related to the attribute option","x-validation-rules":"It is the same attribute code as the one given as path parameter"},"sort_order":{"type":"integer","description":"Order of attribute option","x-validation-rules":"It is a positive integer"},"labels":{"type":"object","description":"Attribute option labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute option label for the locale `localeCode`"}}}},"example":{"code":"black","attribute":"a_simple_select","sort_order":2,"labels":{"en_US":"Black","fr_FR":"Noir"}}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"patch":{"summary":"Update/create an attribute option","operationId":"patch_attributes__attribute_code__options__code_","tags":["Attribute option"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to update a given attribute option. Know more about Update behavior. Note that if no attribute option exists for the given code, it creates it. Please note that this endpoint applies a rate limit of 3 concurrent API requests per second.","parameters":[{"name":"attribute_code","in":"path","description":"Code of the attribute","required":true,"type":"string"},{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"},{"name":"body","in":"body","required":true,"schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Code of option"},"attribute":{"type":"string","description":"Code of attribute related to the attribute option","x-validation-rules":"It is the same attribute code as the one given as path parameter"},"sort_order":{"type":"integer","description":"Order of attribute option","x-validation-rules":"It is a positive integer"},"labels":{"type":"object","description":"Attribute option labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute option label for the locale `localeCode`"}}}},"example":{"code":"black","attribute":"a_simple_select","sort_order":2,"labels":{"en_US":"Black","fr_FR":"Noir"}}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"204":{"description":"No content to return","x-details":"Means that the update was successful","headers":{"Location":{"description":"URI of the updated resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}},"429":{"description":"Too many requests","x-details":"There are too many requests on this endpoint","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":429,"message":"You have exceeded the limit of API requests per second."}}}}},"/api/rest/v1/attribute-groups":{"get":{"summary":"Get list of attribute groups","operationId":"attribute_groups_get_list","description":"This endpoint allows you to get a list of attribute groups. Attribute groups are paginated and sorted by code.","tags":["Attribute group"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"search","in":"query","description":"Filter attribute groups, for more details see the Filters section.","required":false,"type":"string"},{"name":"page","in":"query","description":"Number of the page to retrieve when using the `page` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"integer","default":1},{"name":"limit","in":"query","description":"Number of results by page, see Pagination section","required":false,"type":"integer","minimum":1,"maximum":100,"default":10},{"name":"with_count","in":"query","description":"Return the count of items in the response. Be carefull with that, on a big catalog, it can decrease performance in a significative way","default":false,"type":"boolean","required":false}],"responses":{"200":{"description":"Return attribute groups paginated","schema":{"title":"Attribute groups","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"previous":{"type":"object","properties":{"href":{"type":"string","description":"URI of the previous page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}},"current_page":{"type":"integer","description":"Current page number"}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Attribute group code","x-immutable":true},"sort_order":{"type":"integer","description":"Attribute group order among other attribute groups","x-validation-rules":"It is a positive integer","default":0},"attributes":{"type":"array","description":"Attribute codes that compose the attribute group","x-validation-rules":"Each string of the array is an existing attribute code, an attribute can only be in one attribute group","items":{"type":"string"},"default":[]},"labels":{"type":"object","description":"Attribute group labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute group label for the locale `localeCode`"}}}},"example":{"code":"marketing","sort_order":4,"attributes":["sku","name","description","response_time","release_date","price"],"labels":{"en_US":"Marketing","fr_FR":"Marketing"}}}]}}}}}}]},"examples":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/attribute-groups?page=3&limit=2"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/attribute-groups?page=1&limit=2"},"previous":{"href":"https://demo.akeneo.com/api/rest/v1/attribute-groups?page=2&limit=2"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/attribute-groups?page=4&limit=2"}},"current_page":3,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/attribute-groups/marketing"}},"code":"marketing","sort_order":4,"attributes":["sku","name","description","response_time","release_date","price"],"labels":{"en_US":"Marketing","fr_FR":"Marketing"}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/attribute-groups/technical"}},"code":"technical","sort_order":5,"attributes":["weight","maximum_scan_size","color_scanning","power_requirements","maximum_print_size","sensor_type","total_megapixels","optical_zoom","camera_type"],"labels":{"en_US":"Technical","fr_FR":"Technique"}}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"post":{"summary":"Create a new attribute group","operationId":"attribute_groups_post","description":"This endpoint allows you to create a new attribute group.","tags":["Attribute group"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Attribute group code","x-immutable":true},"sort_order":{"type":"integer","description":"Attribute group order among other attribute groups","x-validation-rules":"It is a positive integer","default":0},"attributes":{"type":"array","description":"Attribute codes that compose the attribute group","x-validation-rules":"Each string of the array is an existing attribute code, an attribute can only be in one attribute group","items":{"type":"string"},"default":[]},"labels":{"type":"object","description":"Attribute group labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute group label for the locale `localeCode`"}}}},"example":{"code":"marketing","sort_order":4,"attributes":["sku","name","description","response_time","release_date","price"],"labels":{"en_US":"Marketing","fr_FR":"Marketing"}}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}},"patch":{"summary":"Update/create several attribute groups","operationId":"several_attribute_groups_patch","tags":["Attribute group"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to update and/or create several attribute groups at once.","x-body-by-line":"Contains several lines, each line is an attribute group in JSON standard format","parameters":[{"name":"body","in":"body","schema":{"x-examples":{"x-example-1":"{\"code\":\"technical\",\"labels\":{\"en_US\": \"Technical\", \"fr_FR\": \"Technique\"}}","x-example-2":"{\"code\":\"marketing\",\"type\":\"bar\"}","x-example-3":"{\"code\":\"design\",\"sort_order\":7}"},"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Attribute group code","x-immutable":true},"sort_order":{"type":"integer","description":"Attribute group order among other attribute groups","x-validation-rules":"It is a positive integer","default":0},"attributes":{"type":"array","description":"Attribute codes that compose the attribute group","x-validation-rules":"Each string of the array is an existing attribute code, an attribute can only be in one attribute group","items":{"type":"string"},"default":[]},"labels":{"type":"object","description":"Attribute group labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute group label for the locale `localeCode`"}}}},"example":{"code":"marketing","sort_order":4,"attributes":["sku","name","description","response_time","release_date","price"],"labels":{"en_US":"Marketing","fr_FR":"Marketing"}}}}],"responses":{"200":{"description":"OK","x-details":"Returns a plain text response whose lines are JSON containing the status of each update or creation","schema":{"type":"object","properties":{"line":{"type":"integer","description":"Line number"},"identifier":{"type":"string","description":"Resource identifier, only filled when the resource is a product"},"code":{"type":"string","description":"Resource code, only filled when the resource is not a product"},"status_code":{"type":"integer","description":"HTTP status code, see Client errors to understand the meaning of each code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"x-example-1":"{\"line\":1,\"code\":\"technical\",\"status_code\":201}","x-example-2":"{\"line\":2,\"code\":\"marketing\",\"status_code\":422,\"message\":\"Property \\\"type\\\" does not exist. Check the standard format documentation.\",\"_links\":{\"documentation\":{\"href\":\"http:\\/\\/api.akeneo.com\\/api-reference.html#patch_attribute_groups__code_\"}}}","x-example-3":"{\"line\":3,\"code\":\"design\",\"status_code\":204}"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"413":{"description":"Request Entity Too Large","x-details":"There are too many resources to process (max 100) or the line of JSON is too long (max 1 000 000 characters)","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":413,"message":"Too many resources to process, 100 is the maximum allowed."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/vnd.akeneo.collection+json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/vnd.akeneo.collection+json’ is allowed."}}}}},"/api/rest/v1/attribute-groups/{code}":{"get":{"summary":"Get an attribute group","operationId":"attribute_groups_get","description":"This endpoint allows you to get the information about a given attribute group.","tags":["Attribute group"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the attribute group in JSON standard format","schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Attribute group code","x-immutable":true},"sort_order":{"type":"integer","description":"Attribute group order among other attribute groups","x-validation-rules":"It is a positive integer","default":0},"attributes":{"type":"array","description":"Attribute codes that compose the attribute group","x-validation-rules":"Each string of the array is an existing attribute code, an attribute can only be in one attribute group","items":{"type":"string"},"default":[]},"labels":{"type":"object","description":"Attribute group labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute group label for the locale `localeCode`"}}}},"example":{"code":"marketing","sort_order":4,"attributes":["sku","name","description","response_time","release_date","price"],"labels":{"en_US":"Marketing","fr_FR":"Marketing"}}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"patch":{"summary":"Update/create an attribute group","operationId":"attribute_groups_patch","tags":["Attribute group"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to update a given attribute group. Know more about Update behavior. Note that if no attribute group exists for the given code, it creates it.","parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"},{"name":"body","in":"body","required":true,"schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Attribute group code","x-immutable":true},"sort_order":{"type":"integer","description":"Attribute group order among other attribute groups","x-validation-rules":"It is a positive integer","default":0},"attributes":{"type":"array","description":"Attribute codes that compose the attribute group","x-validation-rules":"Each string of the array is an existing attribute code, an attribute can only be in one attribute group","items":{"type":"string"},"default":[]},"labels":{"type":"object","description":"Attribute group labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute group label for the locale `localeCode`"}}}},"example":{"code":"marketing","sort_order":4,"attributes":["sku","name","description","response_time","release_date","price"],"labels":{"en_US":"Marketing","fr_FR":"Marketing"}}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"204":{"description":"No content to return","x-details":"Means that the update was successful","headers":{"Location":{"description":"URI of the updated resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/association-types":{"get":{"summary":"Get a list of association types","operationId":"association_types_get_list","description":"This endpoint allows you to get a list of association types. Association types are paginated and sorted by code.","tags":["Association type"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"page","in":"query","description":"Number of the page to retrieve when using the `page` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"integer","default":1},{"name":"limit","in":"query","description":"Number of results by page, see Pagination section","required":false,"type":"integer","minimum":1,"maximum":100,"default":10},{"name":"with_count","in":"query","description":"Return the count of items in the response. Be carefull with that, on a big catalog, it can decrease performance in a significative way","default":false,"type":"boolean","required":false}],"responses":{"200":{"description":"Return association types paginated","schema":{"title":"Association types","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"previous":{"type":"object","properties":{"href":{"type":"string","description":"URI of the previous page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}},"current_page":{"type":"integer","description":"Current page number"}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Association type code","x-immutable":true},"labels":{"type":"object","description":"Association type labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Association type label for the locale `localeCode`"}}},"is_quantified":{"type":"boolean","description":"When true, the association is a quantified association (Only available in the PIM Serenity version.)","default":false,"x-immutable":true},"is_two_way":{"type":"boolean","description":"When true, the association is a two-way association (Only available in the PIM Serenity version.)","default":false,"x-immutable":true}},"example":{"code":"upsell","labels":{"en_US":"Upsell","fr_FR":"Vente incitative"},"is_quantified":false,"is_two_way":false}}]}}}}}}]},"examples":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/association-types?page=1&limit=3"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/association-types?page=1&limit=3"}},"current_page":1,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/association-types/X_SELL"}},"code":"X_SELL","labels":{"en_US":"Cross sell","fr_FR":"Vente croisée"},"is_quantified":false,"is_two_way":false},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/association-types/UPSELL"}},"code":"UPSELL","labels":{"en_US":"Upsell","fr_FR":"Vente incitative"},"is_quantified":false,"is_two_way":false},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/association-types/SUBSTITUTION"}},"code":"SUBSTITUTION","labels":{"en_US":"Substitution","fr_FR":"Remplacement"},"is_quantified":false,"is_two_way":false}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"post":{"summary":"Create a new association type","operationId":"association_types_post","description":"This endpoint allows you to create a new association type.","tags":["Association type"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Association type code","x-immutable":true},"labels":{"type":"object","description":"Association type labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Association type label for the locale `localeCode`"}}},"is_quantified":{"type":"boolean","description":"When true, the association is a quantified association (Only available in the PIM Serenity version.)","default":false,"x-immutable":true},"is_two_way":{"type":"boolean","description":"When true, the association is a two-way association (Only available in the PIM Serenity version.)","default":false,"x-immutable":true}},"example":{"code":"upsell","labels":{"en_US":"Upsell","fr_FR":"Vente incitative"},"is_quantified":false,"is_two_way":false}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}},"patch":{"summary":"Update/create several association types","operationId":"several_association_types_patch","tags":["Association type"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to update and/or create several association types at once.","x-body-by-line":"Contains several lines, each line is an association type in JSON standard format","parameters":[{"name":"body","in":"body","schema":{"x-examples":{"x-example-1":"{\"code\":\"new_sell\"}","x-example-2":"{\"code\":\"substitution\", \"type\":\"bar\"}","x-example-3":"{\"code\":\"x_cross_sell\", \"is_two_way\": true, \"is_quantified\": false}"},"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Association type code","x-immutable":true},"labels":{"type":"object","description":"Association type labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Association type label for the locale `localeCode`"}}},"is_quantified":{"type":"boolean","description":"When true, the association is a quantified association (Only available in the PIM Serenity version.)","default":false,"x-immutable":true},"is_two_way":{"type":"boolean","description":"When true, the association is a two-way association (Only available in the PIM Serenity version.)","default":false,"x-immutable":true}},"example":{"code":"upsell","labels":{"en_US":"Upsell","fr_FR":"Vente incitative"},"is_quantified":false,"is_two_way":false}}}],"responses":{"200":{"description":"OK","x-details":"Returns a plain text response whose lines are JSON containing the status of each update or creation","schema":{"type":"object","properties":{"line":{"type":"integer","description":"Line number"},"identifier":{"type":"string","description":"Resource identifier, only filled when the resource is a product"},"code":{"type":"string","description":"Resource code, only filled when the resource is not a product"},"status_code":{"type":"integer","description":"HTTP status code, see Client errors to understand the meaning of each code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"x-example-1":"{\"line\":1,\"code\":\"new_sell\",\"status_code\":201}","x-example-2":"{\"line\":2,\"code\":\"substitution\",\"status_code\":422,\"message\":\"Property \\\"type\\\" does not exist. Check the standard format documentation.\",\"_links\":{\"documentation\":{\"href\":\"http:\\/\\/api.akeneo.com\\/api-reference.html#patch_association_types__code_\"}}}","x-example-3":"{\"line\":3,\"code\":\"x_cross_sell\",\"status_code\":204}"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"413":{"description":"Request Entity Too Large","x-details":"There are too many resources to process (max 100) or the line of JSON is too long (max 1 000 000 characters)","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":413,"message":"Too many resources to process, 100 is the maximum allowed."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/vnd.akeneo.collection+json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/vnd.akeneo.collection+json’ is allowed."}}}}},"/api/rest/v1/association-types/{code}":{"get":{"summary":"Get an association type","operationId":"association_types_get","description":"This endpoint allows you to get the information about a given association type.","tags":["Association type"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the association type in JSON standard format","schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Association type code","x-immutable":true},"labels":{"type":"object","description":"Association type labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Association type label for the locale `localeCode`"}}},"is_quantified":{"type":"boolean","description":"When true, the association is a quantified association (Only available in the PIM Serenity version.)","default":false,"x-immutable":true},"is_two_way":{"type":"boolean","description":"When true, the association is a two-way association (Only available in the PIM Serenity version.)","default":false,"x-immutable":true}},"example":{"code":"upsell","labels":{"en_US":"Upsell","fr_FR":"Vente incitative"},"is_quantified":false,"is_two_way":false}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"patch":{"summary":"Update/create an association type","operationId":"association_types_patch","tags":["Association type"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to update a given association type. Know more about Update behavior. Note that if no association type exists for the given code, it creates it.","parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"},{"name":"body","in":"body","required":true,"schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Association type code","x-immutable":true},"labels":{"type":"object","description":"Association type labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Association type label for the locale `localeCode`"}}},"is_quantified":{"type":"boolean","description":"When true, the association is a quantified association (Only available in the PIM Serenity version.)","default":false,"x-immutable":true},"is_two_way":{"type":"boolean","description":"When true, the association is a two-way association (Only available in the PIM Serenity version.)","default":false,"x-immutable":true}},"example":{"code":"upsell","labels":{"en_US":"Upsell","fr_FR":"Vente incitative"},"is_quantified":false,"is_two_way":false}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"204":{"description":"No content to return","x-details":"Means that the update was successful","headers":{"Location":{"description":"URI of the updated resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/channels":{"get":{"summary":"Get a list of channels","operationId":"get_channels","description":"This endpoint allows you to get a list of channels. Channels are paginated and sorted by code.","tags":["Channel"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"page","in":"query","description":"Number of the page to retrieve when using the `page` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"integer","default":1},{"name":"limit","in":"query","description":"Number of results by page, see Pagination section","required":false,"type":"integer","minimum":1,"maximum":100,"default":10},{"name":"with_count","in":"query","description":"Return the count of items in the response. Be carefull with that, on a big catalog, it can decrease performance in a significative way","default":false,"type":"boolean","required":false}],"responses":{"200":{"description":"Return channels paginated","schema":{"title":"Channels","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"previous":{"type":"object","properties":{"href":{"type":"string","description":"URI of the previous page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}},"current_page":{"type":"integer","description":"Current page number"}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code","category_tree","locales","currencies"],"properties":{"code":{"type":"string","description":"Channel code","x-immutable":true},"locales":{"type":"array","description":"Codes of activated locales for the channel","x-validation-rules":"• Each string of the array is an existing locale code • At least one locale in the array","items":{"type":"string"}},"currencies":{"type":"array","description":"Codes of activated currencies for the channel","x-validation-rules":"• Each string of the array is an existing currency code • At least one currency in the array","items":{"type":"string"}},"category_tree":{"type":"string","description":"Code of the category tree linked to the channel","x-validation-rules":"It is the code of an existing category code that is a tree (a category without parent)"},"conversion_units":{"type":"object","description":"Units to which the given metric attributes should be converted when exporting products","x-validation-rules":"• The `attributeCode` is the code of an existing attribute whose type is `pim_catalog_metric` • The strings are existing unit codes.","properties":{"attributeCode":{"type":"string","description":"Conversion unit code used to convert the values of the attribute `attributeCode` when exporting via the channel"}}},"labels":{"type":"object","description":"Channel labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Channel label for the locale `localeCode`"}}}},"example":{"code":"ecommerce","currencies":["USD","EUR"],"locales":["de_DE","en_US","fr_FR"],"category_tree":"master","conversion_units":{"weight":"KILOGRAM"},"labels":{"en_US":"Ecommerce","de_DE":"Ecommerce","fr_FR":"Ecommerce"}}}]}}}}}}]},"examples":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/channels?page=1&limit=3"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/channels?page=1&limit=3"}},"current_page":1,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/channels/ecommerce"}},"code":"ecommerce","currencies":["USD","EUR"],"locales":["en_US","fr_FR","de_DE"],"category_tree":"master","conversion_units":{"a_metric":"KILOWATT","a_metric_negative":"CELSIUS","a_metric_to_not_convert":null},"labels":{"en_US":"Ecommerce","fr_FR":"E-commerce","de_DE":"E-commerce"}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/channels/mobile"}},"code":"mobile","currencies":["USD","EUR"],"locales":["en_US","fr_FR","de_DE"],"category_tree":"master","conversion_units":{"a_metric":"KILOWATT","a_metric_negative":"CELSIUS","a_metric_to_not_convert":null},"labels":{"en_US":"Mobile","fr_FR":"Mobile","de_DE":"Mobile"}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/channels/print"}},"code":"print","currencies":["USD","EUR"],"locales":["en_US","fr_FR","de_DE"],"category_tree":"master","conversion_units":{},"labels":{"en_US":"Print","fr_FR":"Print","de_DE":"Print"}}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"post":{"summary":"Create a new channel","operationId":"channels_post","description":"This endpoint allows you to create a new channel.","tags":["Channel"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","required":["code","category_tree","locales","currencies"],"properties":{"code":{"type":"string","description":"Channel code","x-immutable":true},"locales":{"type":"array","description":"Codes of activated locales for the channel","x-validation-rules":"• Each string of the array is an existing locale code • At least one locale in the array","items":{"type":"string"}},"currencies":{"type":"array","description":"Codes of activated currencies for the channel","x-validation-rules":"• Each string of the array is an existing currency code • At least one currency in the array","items":{"type":"string"}},"category_tree":{"type":"string","description":"Code of the category tree linked to the channel","x-validation-rules":"It is the code of an existing category code that is a tree (a category without parent)"},"conversion_units":{"type":"object","description":"Units to which the given metric attributes should be converted when exporting products","x-validation-rules":"• The `attributeCode` is the code of an existing attribute whose type is `pim_catalog_metric` • The strings are existing unit codes.","properties":{"attributeCode":{"type":"string","description":"Conversion unit code used to convert the values of the attribute `attributeCode` when exporting via the channel"}}},"labels":{"type":"object","description":"Channel labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Channel label for the locale `localeCode`"}}}},"example":{"code":"ecommerce","currencies":["USD","EUR"],"locales":["de_DE","en_US","fr_FR"],"category_tree":"master","conversion_units":{"weight":"KILOGRAM"},"labels":{"en_US":"Ecommerce","de_DE":"Ecommerce","fr_FR":"Ecommerce"}}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}},"patch":{"summary":"Update/create several channels","operationId":"several_channels_patch","tags":["Channel"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to update and/or create several channels at once.","x-body-by-line":"Contains several lines, each line is a channel in JSON standard format","parameters":[{"name":"body","in":"body","schema":{"x-examples":{"x-example-1":"{\"code\":\"ecommerce_fr\", \"category_tree\": \"master\", \"currencies\": [\"EUR\"], \"locales\": [\"fr_FR\"], \"labels\":{\"fr_FR\": \"Ecommerce Fr\"}}","x-example-2":"{\"code\":\"ecommerce_ch\", \"type\":\"bar\"}","x-example-3":"{\"code\":\"tablet\", \"labels\":{\"en_US\": \"Tablet\", \"fr_FR\": \"Tablette\"}}"},"type":"object","required":["code","category_tree","locales","currencies"],"properties":{"code":{"type":"string","description":"Channel code","x-immutable":true},"locales":{"type":"array","description":"Codes of activated locales for the channel","x-validation-rules":"• Each string of the array is an existing locale code • At least one locale in the array","items":{"type":"string"}},"currencies":{"type":"array","description":"Codes of activated currencies for the channel","x-validation-rules":"• Each string of the array is an existing currency code • At least one currency in the array","items":{"type":"string"}},"category_tree":{"type":"string","description":"Code of the category tree linked to the channel","x-validation-rules":"It is the code of an existing category code that is a tree (a category without parent)"},"conversion_units":{"type":"object","description":"Units to which the given metric attributes should be converted when exporting products","x-validation-rules":"• The `attributeCode` is the code of an existing attribute whose type is `pim_catalog_metric` • The strings are existing unit codes.","properties":{"attributeCode":{"type":"string","description":"Conversion unit code used to convert the values of the attribute `attributeCode` when exporting via the channel"}}},"labels":{"type":"object","description":"Channel labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Channel label for the locale `localeCode`"}}}},"example":{"code":"ecommerce","currencies":["USD","EUR"],"locales":["de_DE","en_US","fr_FR"],"category_tree":"master","conversion_units":{"weight":"KILOGRAM"},"labels":{"en_US":"Ecommerce","de_DE":"Ecommerce","fr_FR":"Ecommerce"}}}}],"responses":{"200":{"description":"OK","x-details":"Returns a plain text response whose lines are JSON containing the status of each update or creation","schema":{"type":"object","properties":{"line":{"type":"integer","description":"Line number"},"identifier":{"type":"string","description":"Resource identifier, only filled when the resource is a product"},"code":{"type":"string","description":"Resource code, only filled when the resource is not a product"},"status_code":{"type":"integer","description":"HTTP status code, see Client errors to understand the meaning of each code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"x-example-1":"{\"line\":1,\"code\":\"ecommerce_fr\",\"status_code\":201}","x-example-2":"{\"line\":2,\"code\":\"ecommerce_ch\",\"status_code\":422,\"message\":\"Property \\\"type\\\" does not exist. Check the standard format documentation.\",\"_links\":{\"documentation\":{\"href\":\"http:\\/\\/api.akeneo.com\\/api-reference.html#patch_channels__code_\"}}}","x-example-3":"{\"line\":3,\"code\":\"tablet\",\"status_code\":204}"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"413":{"description":"Request Entity Too Large","x-details":"There are too many resources to process (max 100) or the line of JSON is too long (max 1 000 000 characters)","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":413,"message":"Too many resources to process, 100 is the maximum allowed."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/vnd.akeneo.collection+json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/vnd.akeneo.collection+json’ is allowed."}}}}},"/api/rest/v1/channels/{code}":{"get":{"summary":"Get a channel","operationId":"get_channels__code_","description":"This endpoint allows you to get the information about a given channel.","tags":["Channel"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the channel in JSON standard format","schema":{"type":"object","required":["code","category_tree","locales","currencies"],"properties":{"code":{"type":"string","description":"Channel code","x-immutable":true},"locales":{"type":"array","description":"Codes of activated locales for the channel","x-validation-rules":"• Each string of the array is an existing locale code • At least one locale in the array","items":{"type":"string"}},"currencies":{"type":"array","description":"Codes of activated currencies for the channel","x-validation-rules":"• Each string of the array is an existing currency code • At least one currency in the array","items":{"type":"string"}},"category_tree":{"type":"string","description":"Code of the category tree linked to the channel","x-validation-rules":"It is the code of an existing category code that is a tree (a category without parent)"},"conversion_units":{"type":"object","description":"Units to which the given metric attributes should be converted when exporting products","x-validation-rules":"• The `attributeCode` is the code of an existing attribute whose type is `pim_catalog_metric` • The strings are existing unit codes.","properties":{"attributeCode":{"type":"string","description":"Conversion unit code used to convert the values of the attribute `attributeCode` when exporting via the channel"}}},"labels":{"type":"object","description":"Channel labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Channel label for the locale `localeCode`"}}}},"example":{"code":"ecommerce","currencies":["USD","EUR"],"locales":["de_DE","en_US","fr_FR"],"category_tree":"master","conversion_units":{"weight":"KILOGRAM"},"labels":{"en_US":"Ecommerce","de_DE":"Ecommerce","fr_FR":"Ecommerce"}}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"patch":{"summary":"Update/create a channel","operationId":"channels_patch","tags":["Channel"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to update a given channel. Know more about Update behavior. Note that if no channel exists for the given code, it creates it.","parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"},{"name":"body","in":"body","required":true,"schema":{"type":"object","required":["code","category_tree","locales","currencies"],"properties":{"code":{"type":"string","description":"Channel code","x-immutable":true},"locales":{"type":"array","description":"Codes of activated locales for the channel","x-validation-rules":"• Each string of the array is an existing locale code • At least one locale in the array","items":{"type":"string"}},"currencies":{"type":"array","description":"Codes of activated currencies for the channel","x-validation-rules":"• Each string of the array is an existing currency code • At least one currency in the array","items":{"type":"string"}},"category_tree":{"type":"string","description":"Code of the category tree linked to the channel","x-validation-rules":"It is the code of an existing category code that is a tree (a category without parent)"},"conversion_units":{"type":"object","description":"Units to which the given metric attributes should be converted when exporting products","x-validation-rules":"• The `attributeCode` is the code of an existing attribute whose type is `pim_catalog_metric` • The strings are existing unit codes.","properties":{"attributeCode":{"type":"string","description":"Conversion unit code used to convert the values of the attribute `attributeCode` when exporting via the channel"}}},"labels":{"type":"object","description":"Channel labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Channel label for the locale `localeCode`"}}}},"example":{"code":"ecommerce","currencies":["USD","EUR"],"locales":["de_DE","en_US","fr_FR"],"category_tree":"master","conversion_units":{"weight":"KILOGRAM"},"labels":{"en_US":"Ecommerce","de_DE":"Ecommerce","fr_FR":"Ecommerce"}}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"204":{"description":"No content to return","x-details":"Means that the update was successful","headers":{"Location":{"description":"URI of the updated resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/locales":{"get":{"summary":"Get a list of locales","operationId":"get_locales","description":"This endpoint allows you to get a list of locales. Locales are paginated and sorted by code.","tags":["Locale"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"search","in":"query","description":"Filter locales, for more details see the Filters section","required":false,"type":"string"},{"name":"page","in":"query","description":"Number of the page to retrieve when using the `page` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"integer","default":1},{"name":"limit","in":"query","description":"Number of results by page, see Pagination section","required":false,"type":"integer","minimum":1,"maximum":100,"default":10},{"name":"with_count","in":"query","description":"Return the count of items in the response. Be carefull with that, on a big catalog, it can decrease performance in a significative way","default":false,"type":"boolean","required":false}],"responses":{"200":{"description":"Return locales paginated","schema":{"title":"Locales","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"previous":{"type":"object","properties":{"href":{"type":"string","description":"URI of the previous page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}},"current_page":{"type":"integer","description":"Current page number"}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Locale code","x-immutable":true},"enabled":{"type":"boolean","description":"Whether the locale is enabled","default":false}},"example":{"code":"en_US","enable":true}}]}}}}}}]},"examples":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/locales?page=2&limit=4"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/locales?page=1&limit=4"},"previous":{"href":"https://demo.akeneo.com/api/rest/v1/locales?page=1&limit=4"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/locales?page=2&limit=4"}},"current_page":2,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/locales/en_US"}},"code":"en_US","enabled":true},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/locales/fr_FR"}},"code":"fr_FR","enabled":true},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/locales/de_DE"}},"code":"de_DE","enabled":true},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/locales/af_ZA"}},"code":"af_ZA","enabled":false}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}}},"/api/rest/v1/locales/{code}":{"get":{"summary":"Get a locale","operationId":"get_locales__code_","description":"This endpoint allows you to get the information about a given locale.","tags":["Locale"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the locale in JSON standard format","schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Locale code","x-immutable":true},"enabled":{"type":"boolean","description":"Whether the locale is enabled","default":false}},"example":{"code":"en_US","enable":true}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}}},"/api/rest/v1/categories":{"get":{"summary":"Get list of categories","operationId":"get_categories","description":"This endpoint allows you to get a list of categories. Categories are paginated and sorted by `root/left`.","tags":["Category"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"search","in":"query","description":"Filter categories, for more details see the Filters section.","required":false,"type":"string"},{"name":"page","in":"query","description":"Number of the page to retrieve when using the `page` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"integer","default":1},{"name":"limit","in":"query","description":"Number of results by page, see Pagination section","required":false,"type":"integer","minimum":1,"maximum":100,"default":10},{"name":"with_count","in":"query","description":"Return the count of items in the response. Be carefull with that, on a big catalog, it can decrease performance in a significative way","default":false,"type":"boolean","required":false},{"name":"with_position","in":"query","description":"Return information about category position into its category tree (only available since the 7.0 version)","required":false,"type":"boolean","x-from-version":"7.0"},{"name":"with_enriched_attributes","in":"query","description":"Return attribute values of the category (only available on SaaS platforms)","required":false,"type":"boolean","x-from-version":"SaaS"}],"responses":{"200":{"description":"Return categories paginated","schema":{"title":"Categories","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"previous":{"type":"object","properties":{"href":{"type":"string","description":"URI of the previous page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}},"current_page":{"type":"integer","description":"Current page number"}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Category code","x-immutable":true},"parent":{"type":"string","description":"Category code of the parent's category","x-validation-rules":"• It is either equal to `null` or to an existing category code. • If equal to an existing category code, it cannot reference itself.","default":"null"},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"position":{"type":"integer","description":"Position of the category in its level, start from 1 (only available since the 7.0 version and when query parameter \"with_position\" is set to \"true\")","x-read-only":true},"labels":{"type":"object","description":"Category labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Category label for the locale `localeCode`"}}},"values":{"type":"object","description":"Attribute values","default":null,"properties":{"attributeCode|attributeUuid|channelCode|localeCode":{"type":"array","items":{"type":"object","properties":{"data":{"type":"object","description":"Attribute value"},"type":{"type":"string","description":"The attribute type"},"locale":{"type":"string","description":"Locale code of the attribute value"},"channel":{"type":"string","description":"Channel code of the attribute value"},"attribute_code":{"type":"string","description":"The attribute code with its uuid (attributeCode|attributeUuid)"}}}}}}},"example":{"code":"winter_collection","parent":null,"updated":"2021-05-22T12:48:00+02:00","position":1,"labels":{"en_US":"Winter collection","fr_FR":"Collection hiver"},"values":{"description|96b88bf4-c2b7-4b64-a1f9-5d4876c02c26|ecommerce|en_US":{"data":"

Winter collection description

\n","type":"textarea","channel":"ecommerce","locale":"en_US","attribute_code":"description|96b88bf4-c2b7-4b64-a1f9-5d4876c02c26"},"image_1|871b8686-79b5-415c-9c6f-a38f8732dfb7|ecommerce|en_US":{"data":{"size":1401359,"extension":"jpg","file_path":"2/d/c/7/2dc791671d726e7438219d5dc7fd51a53d6bf2bb_IMG_7860.jpg","mime_type":"image/jpeg","original_filename":"IMG_7860.jpg"},"type":"image","channel":"ecommerce","locale":"en_US","attribute_code":"image_1|871b8686-79b5-415c-9c6f-a38f8732dfb7"}}}}]}}}}}}]},"examples":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/categories?page=2&limit=5"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/categories?page=1&limit=5"},"previous":{"href":"https://demo.akeneo.com/api/rest/v1/categories?page=1&limit=5"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/categories?page=3&limit=5"}},"current_page":2,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/categories/winter_collection"}},"code":"winter_collection","parent":null,"updated":"2021-05-21T11:32:00+02:00","position":1,"labels":{"en_US":"Winter collection","fr_FR":"Collection hiver","de_DE":"Winter-Kollektion"},"values":{"description|96b88bf4-c2b7-4b64-a1f9-5d4876c02c26|ecommerce|en_US":{"data":"

Winter collection description

\n","type":"textarea","channel":"ecommerce","locale":"en_US","attribute_code":"description|96b88bf4-c2b7-4b64-a1f9-5d4876c02c26"},"image_1|871b8686-79b5-415c-9c6f-a38f8732dfb7|ecommerce|en_US":{"data":{"size":1401359,"extension":"jpg","file_path":"2/d/c/7/2dc791671d726e7438219d5dc7fd51a53d6bf2bb_IMG_7860.jpg","mime_type":"image/jpeg","original_filename":"IMG_7860.jpg"},"type":"image","channel":"ecommerce","locale":"en_US","attribute_code":"image_1|871b8686-79b5-415c-9c6f-a38f8732dfb7"}}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/categories/woman"}},"code":"woman","parent":"winter_collection","updated":"2021-04-21T10:41:02+02:00","position":1,"labels":{"en_US":"Woman","fr_FR":"Femme","de_DE":"Damen"},"values":{}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/categories/man"}},"code":"man","parent":"winter_collection","updated":"2021-03-02T12:59:59+02:00","position":2,"labels":{"en_US":"Man","fr_FR":"Homme","de_DE":"Herren"},"values":{}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/categories/kids"}},"code":"kids","parent":"winter_collection","updated":"2021-01-03T12:40:00+02:00","position":3,"labels":{"en_US":"Kids","fr_FR":"Enfant","de_DE":"Kinder"},"values":{}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/categories/summer_collection"}},"code":"summer_collection","parent":null,"updated":"2021-04-04T09:42:00+02:00","position":1,"labels":{"en_US":"Summer collection","fr_FR":"Collection été","de_DE":"Sommer-Kollektion"},"values":{}}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"post":{"summary":"Create a new category","operationId":"post_categories","description":"This endpoint allows you to create a new category.","tags":["Category"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Category code","x-immutable":true},"parent":{"type":"string","description":"Category code of the parent's category","x-validation-rules":"• It is either equal to `null` or to an existing category code. • If equal to an existing category code, it cannot reference itself.","default":"null"},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"position":{"type":"integer","description":"Position of the category in its level, start from 1 (only available since the 7.0 version and when query parameter \"with_position\" is set to \"true\")","x-read-only":true},"labels":{"type":"object","description":"Category labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Category label for the locale `localeCode`"}}},"values":{"type":"array","description":"Attribute values (only available on SaaS).","default":[],"items":{"type":"object","properties":{"data":{"type":"string","description":"Attribute value. It should be a `string` for Text and Text Area attributes, a `boolean` for Yes/No attribute and for Image attribute use the create category media file endpoint. It can also be `null` to remove the value."},"locale":{"type":"string","description":"Locale code of the attribute value."},"channel":{"type":"string","description":"Channel code of the attribute value."},"attribute_code":{"type":"string","description":"The attribute code."}}}}},"example":{"code":"winter_collection","parent":null,"labels":{"en_US":"Winter collection","fr_FR":"Collection hiver"},"values":[{"data":"

Winter collection description

","channel":"ecommerce","locale":"en_US","attribute_code":"a_text_area_attribute"},{"data":false,"channel":"ecommerce","locale":null,"attribute_code":"a_boolean_attribute"},{"data":null,"channel":null,"locale":null,"attribute_code":"an_image_attribute"}]}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}},"patch":{"summary":"Update/create several categories","operationId":"patch_categories","tags":["Category"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to update several categories at once.","x-body-by-line":"Contains several lines, each line is a category in JSON standard format","parameters":[{"name":"body","in":"body","schema":{"x-examples":{"x-example-1":"{\"code\":\"spring_collection\",\"parent\":null}","x-example-2":"{\"code\":\"woman\",\"parent\":\"spring_collection\"}","x-example-3":"{\"code\":\"man\",\"parent\":\"spring_collection\"}"},"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Category code","x-immutable":true},"parent":{"type":"string","description":"Category code of the parent's category","x-validation-rules":"• It is either equal to `null` or to an existing category code. • If equal to an existing category code, it cannot reference itself.","default":"null"},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"position":{"type":"integer","description":"Position of the category in its level, start from 1 (only available since the 7.0 version and when query parameter \"with_position\" is set to \"true\")","x-read-only":true},"labels":{"type":"object","description":"Category labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Category label for the locale `localeCode`"}}},"values":{"type":"array","description":"Attribute values (only available on SaaS).","default":[],"items":{"type":"object","properties":{"data":{"type":"string","description":"Attribute value. It should be a `string` for Text and Text Area attributes, a `boolean` for Yes/No attribute and for Image attribute use the create category media file endpoint. It can also be `null` to remove the value."},"locale":{"type":"string","description":"Locale code of the attribute value."},"channel":{"type":"string","description":"Channel code of the attribute value."},"attribute_code":{"type":"string","description":"The attribute code."}}}}},"example":{"code":"winter_collection","parent":null,"labels":{"en_US":"Winter collection","fr_FR":"Collection hiver"},"values":[{"data":"

Winter collection description

","channel":"ecommerce","locale":"en_US","attribute_code":"a_text_area_attribute"},{"data":false,"channel":"ecommerce","locale":null,"attribute_code":"a_boolean_attribute"},{"data":null,"channel":null,"locale":null,"attribute_code":"an_image_attribute"}]}}}],"responses":{"200":{"description":"OK","x-details":"Returns a plain text response whose lines are JSON containing the status of each update or creation","x-no-entity":true,"schema":{"type":"object","properties":{"line":{"type":"integer","description":"Line number"},"identifier":{"type":"string","description":"Resource identifier, only filled when the resource is a product"},"code":{"type":"string","description":"Resource code, only filled when the resource is not a product"},"status_code":{"type":"integer","description":"HTTP status code, see Client errors to understand the meaning of each code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"x-example-1":"{\"line\":1,\"code\":\"spring_collection\",\"status_code\":201}","x-example-2":"{\"line\":2,\"code\":\"woman\",\"status_code\":422,\"message\":\"Category \\\"spring_collectionn\\\" does not exist.\"}","x-example-3":"{\"line\":3,\"code\":\"man\",\"status_code\":204}"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"413":{"description":"Request Entity Too Large","x-details":"There are too many resources to process (max 100) or the line of JSON is too long (max 1 000 000 characters)","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":413,"message":"Too many resources to process, 100 is the maximum allowed."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/vnd.akeneo.collection+json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/vnd.akeneo.collection+json’ is allowed."}}}}},"/api/rest/v1/categories/{code}":{"get":{"summary":"Get a category","operationId":"get_categories__code_","description":"This endpoint allows you to get the information about a given category.","tags":["Category"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"},{"name":"with_position","in":"query","description":"Return information about category position into its category tree (only available since the 7.0 version)","required":false,"type":"boolean","x-from-version":"7.0"},{"name":"with_enriched_attributes","in":"query","description":"Return attribute values of the category (only available on SaaS platforms)","required":false,"type":"boolean","x-from-version":"SaaS"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the category in JSON standard format","schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Category code","x-immutable":true},"parent":{"type":"string","description":"Category code of the parent's category","x-validation-rules":"• It is either equal to `null` or to an existing category code. • If equal to an existing category code, it cannot reference itself.","default":"null"},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"position":{"type":"integer","description":"Position of the category in its level, start from 1 (only available since the 7.0 version and when query parameter \"with_position\" is set to \"true\")","x-read-only":true},"labels":{"type":"object","description":"Category labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Category label for the locale `localeCode`"}}},"values":{"type":"object","description":"Attribute values","default":null,"properties":{"attributeCode|attributeUuid|channelCode|localeCode":{"type":"array","items":{"type":"object","properties":{"data":{"type":"object","description":"Attribute value"},"type":{"type":"string","description":"The attribute type"},"locale":{"type":"string","description":"Locale code of the attribute value"},"channel":{"type":"string","description":"Channel code of the attribute value"},"attribute_code":{"type":"string","description":"The attribute code with its uuid (attributeCode|attributeUuid)"}}}}}}},"example":{"code":"winter_collection","parent":null,"updated":"2021-05-22T12:48:00+02:00","position":1,"labels":{"en_US":"Winter collection","fr_FR":"Collection hiver"},"values":{"description|96b88bf4-c2b7-4b64-a1f9-5d4876c02c26|ecommerce|en_US":{"data":"

Winter collection description

\n","type":"textarea","channel":"ecommerce","locale":"en_US","attribute_code":"description|96b88bf4-c2b7-4b64-a1f9-5d4876c02c26"},"image_1|871b8686-79b5-415c-9c6f-a38f8732dfb7|ecommerce|en_US":{"data":{"size":1401359,"extension":"jpg","file_path":"2/d/c/7/2dc791671d726e7438219d5dc7fd51a53d6bf2bb_IMG_7860.jpg","mime_type":"image/jpeg","original_filename":"IMG_7860.jpg"},"type":"image","channel":"ecommerce","locale":"en_US","attribute_code":"image_1|871b8686-79b5-415c-9c6f-a38f8732dfb7"}}}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"patch":{"summary":"Update/create a category","operationId":"patch_categories__code_","tags":["Category"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to update a given category. Know more about Update behavior. Note that if no category exists for the given code, it creates it.","parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"},{"name":"body","in":"body","required":true,"schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Category code","x-immutable":true},"parent":{"type":"string","description":"Category code of the parent's category","x-validation-rules":"• It is either equal to `null` or to an existing category code. • If equal to an existing category code, it cannot reference itself.","default":"null"},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"position":{"type":"integer","description":"Position of the category in its level, start from 1 (only available since the 7.0 version and when query parameter \"with_position\" is set to \"true\")","x-read-only":true},"labels":{"type":"object","description":"Category labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Category label for the locale `localeCode`"}}},"values":{"type":"array","description":"Attribute values (only available on SaaS).","default":[],"items":{"type":"object","properties":{"data":{"type":"string","description":"Attribute value. It should be a `string` for Text and Text Area attributes, a `boolean` for Yes/No attribute and for Image attribute use the create category media file endpoint. It can also be `null` to remove the value."},"locale":{"type":"string","description":"Locale code of the attribute value."},"channel":{"type":"string","description":"Channel code of the attribute value."},"attribute_code":{"type":"string","description":"The attribute code."}}}}},"example":{"code":"winter_collection","parent":null,"labels":{"en_US":"Winter collection","fr_FR":"Collection hiver"},"values":[{"data":"

Winter collection description

","channel":"ecommerce","locale":"en_US","attribute_code":"a_text_area_attribute"},{"data":false,"channel":"ecommerce","locale":null,"attribute_code":"a_boolean_attribute"},{"data":null,"channel":null,"locale":null,"attribute_code":"an_image_attribute"}]}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"204":{"description":"No content to return","x-details":"Means that the update was successful","headers":{"Location":{"description":"URI of the updated resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/category-media-files":{"post":{"summary":"Create a category media file","operationId":"post_category_media_files","description":"This endpoint allows you to create a new media file and associate it to an attribute value of a given enriched category.","tags":["Category"],"x-versions":["SaaS"],"parameters":[{"name":"Content-type","in":"header","type":"string","description":"Equal to 'multipart/form-data'.","required":true},{"name":"body","in":"body","x-form-data":true,"schema":{"required":["file"],"properties":{"category":{"type":"string","description":"The category to which the media file will be associated. It is a JSON string that follows this format '{\"code\":\"category code\", \"attribute_code\":\"attribute code\", \"channel\":\"channel code or null\", \"locale\":\"locale code or null\"}'."},"file":{"type":"string","description":"The binary of the file.","format":"binary"}}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `multipart/form-data`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘multipart/form-data’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/category-media-files/{file_path}/download":{"get":{"summary":"Download a category media file","operationId":"get_category_media_files__file_path__download","description":"This endpoint allows you to download a given media file that is used as an attribute value of a enriched category.","x-content-type":"Mime-type of the media file","tags":["Category"],"x-versions":["SaaS"],"parameters":[{"name":"file_path","in":"path","description":"Path of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the binary of the media file","x-content-type":"Mime-type of the media file"},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}}}}},"/api/rest/v1/currencies":{"get":{"summary":"Get a list of currencies","operationId":"currencies_get_list","description":"This endpoint allows you to get a list of currencies. Currencies are paginated and sorted by code.","tags":["Currency"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"search","in":"query","description":"Filter currencies, for more details see the Filters section","required":false,"type":"string"},{"name":"page","in":"query","description":"Number of the page to retrieve when using the `page` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"integer","default":1},{"name":"limit","in":"query","description":"Number of results by page, see Pagination section","required":false,"type":"integer","minimum":1,"maximum":100,"default":10},{"name":"with_count","in":"query","description":"Return the count of items in the response. Be carefull with that, on a big catalog, it can decrease performance in a significative way","default":false,"type":"boolean","required":false}],"responses":{"200":{"description":"Return currencies paginated","schema":{"title":"Currencies","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"previous":{"type":"object","properties":{"href":{"type":"string","description":"URI of the previous page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}},"current_page":{"type":"integer","description":"Current page number"}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Currency code","x-immutable":true},"enabled":{"type":"boolean","description":"Whether the currency is enabled"},"label":{"type":"string","description":"Currency label"}},"example":{"code":"EUR","enabled":true,"label":"EUR (Euro)"}}]}}}}}}]},"examples":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/currencies?page=1&limit=3"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/currencies?page=1&limit=3"}},"current_page":1,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/currencies/ADP"}},"code":"ADP","enabled":true,"label":"ADP (Andorran Peseta)"},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/currencies/AED"}},"code":"AED","enabled":true,"label":"AED (United Arab Emirates Dirham)"},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/currencies/AFA"}},"code":"AFA","enabled":false,"label":"AFA (Afghan Afghani (1927–2002))"}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}}},"/api/rest/v1/currencies/{code}":{"get":{"summary":"Get a currency","operationId":"currencies_get","description":"This endpoint allows you to get the information about a given currency.","tags":["Currency"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the currency in JSON standard format","schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Currency code","x-immutable":true},"enabled":{"type":"boolean","description":"Whether the currency is enabled"},"label":{"type":"string","description":"Currency label"}},"example":{"code":"EUR","enabled":true,"label":"EUR (Euro)"}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}}},"/api/rest/v1/measure-families":{"get":{"summary":"Get list of measure familiy","operationId":"measure_families_get_list","description":"This endpoint allows you to get a list of measure families. Measure families are paginated and sorted by code.","tags":["Measure family"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"responses":{"200":{"description":"Return measure families paginated","schema":{"title":"Measure Families","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"previous":{"type":"object","properties":{"href":{"type":"string","description":"URI of the previous page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}},"current_page":{"type":"integer","description":"Current page number"}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Measure family code","x-immutable":true},"standard":{"type":"string","description":"Measure family standard","x-immutable":true},"units":{"type":"array","description":"Family units","items":{"type":"object","properties":{"code":{"type":"string","description":"Measure code","x-immutable":true},"convert":{"type":"object","description":"Mathematic operation to convert the unit into the standard unit"},"symbol":{"type":"string","description":"Measure symbol","x-immutable":true}}}}},"example":{"code":"Area","standard":"SQUARE_METER","units":[{"code":"SQUARE_MILLIMETER","convert":{"mul":"0.001"},"symbol":"mm²"},{"code":"SQUARE_CENTIMETER","convert":{"mul":"0.001"},"symbol":"cm²"}]}}]}}}}}}]},"examples":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/measure-families?page=1&limit=1"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/measure-families?page=1&limit=1"}},"current_page":1,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/measure-families/Area"}},"code":"Area","standard":"SQUARE_METER","units":[{"code":"SQUARE_MILLIMETER","convert":{"mul":"0.000001"},"symbol":"mm²"},{"code":"SQUARE_CENTIMETER","convert":{"mul":"0.0001"},"symbol":"cm²"},{"code":"SQUARE_DECIMETER","convert":{"mul":"0.01"},"symbol":"dm²"},{"code":"SQUARE_METER","convert":{"mul":"1"},"symbol":"m²"},{"code":"CENTIARE","convert":{"mul":"1"},"symbol":"ca"},{"code":"SQUARE_DEKAMETER","convert":{"mul":"100"},"symbol":"dam²"},{"code":"ARE","convert":{"mul":"100"},"symbol":"a"},{"code":"SQUARE_HECTOMETER","convert":{"mul":"10000"},"symbol":"hm²"}]}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}}},"/api/rest/v1/measure-families/{code}":{"get":{"summary":"Get a measure family","operationId":"measure_families_get","description":"This endpoint allows you to get the information about a given measure family.","tags":["Measure family"],"x-versions":["2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the measure family in JSON standard format","schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Measure family code","x-immutable":true},"standard":{"type":"string","description":"Measure family standard","x-immutable":true},"units":{"type":"array","description":"Family units","items":{"type":"object","properties":{"code":{"type":"string","description":"Measure code","x-immutable":true},"convert":{"type":"object","description":"Mathematic operation to convert the unit into the standard unit"},"symbol":{"type":"string","description":"Measure symbol","x-immutable":true}}}}},"example":{"code":"Area","standard":"SQUARE_METER","units":[{"code":"SQUARE_MILLIMETER","convert":{"mul":"0.001"},"symbol":"mm²"},{"code":"SQUARE_CENTIMETER","convert":{"mul":"0.001"},"symbol":"cm²"}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}}},"/api/rest/v1/measurement-families":{"get":{"summary":"Get list of measurement families","operationId":"measurement_families_get_list","description":"This endpoint allows you to get a list of measurement families.","tags":["Measurement family"],"x-versions":["5.0","6.0","7.0","SaaS"],"responses":{"200":{"description":"Return the measurement families","x-no-entity":true,"schema":{"type":"object","required":["code","standard_unit_code","units"],"properties":{"code":{"type":"string","description":"Measurement family code","x-immutable":true},"labels":{"type":"object","description":"Measurement family labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Measurement family label for the locale `localeCode`"}}},"standard_unit_code":{"type":"string","description":"Unit code used as the standard unit for this measurement family","x-immutable":true,"x-validation-rules":"The unit code exists in the list of the property `units`"},"units":{"type":"object","description":"Measurement units for this family with their conversion operations. More details here.","x-validation-rules":"A unit can't be added when a product attribute is linked to this measurement family","properties":{"unitCode":{"type":"object","properties":{"code":{"type":"string","description":"Measurement unit code. More details here.","x-immutable":true},"labels":{"type":"object","description":"Unit labels for each locale. More details here.","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Unit label for the locale `localeCode`"}}},"convert_from_standard":{"type":"array","description":"Calculation to convert the unit from the standard unit. More details here.","x-validation-rules":"• The conversion operations can't be updated when a product attribute is linked to this measurement family • At least one conversion operation per unit is required","items":{"type":"object","properties":{"operator":{"type":"string","description":"Operator for a conversion operation to convert the unit in the standard unit","x-validation-rules":"The operator is one of the following values","enum":["mul","div","add","sub"]},"value":{"type":"string","description":"Value for a conversion operation to convert the unit in the standard unit"}}}},"symbol":{"type":"string","description":"Measurement unit symbol. More details here."}}}}}},"example":{"code":"AREA","labels":{"en_US":"Area","fr_FR":"Surface"},"standard_unit_code":"SQUARE_METER","units":{"SQUARE_MILLIMETER":{"code":"SQUARE_MILLIMETER","labels":{"en_US":"Square millimeter","fr_FR":"Millimètre carré"},"convert_from_standard":[{"operator":"mul","value":"0.000001"}],"symbol":"mm²"},"SQUARE_CENTIMETER":{"code":"SQUARE_CENTIMETER","labels":{"en_US":"Square centimeter","fr_FR":"Centimètre carré"},"convert_from_standard":[{"operator":"mul","value":"0.0001"}],"symbol":"cm²"},"SQUARE_METER":{"code":"SQUARE_METER","labels":{"en_US":"Square meter","fr_FR":"Mètre carré"},"convert_from_standard":[{"operator":"mul","value":"1"}],"symbol":"m²"}}}},"x-examples":[{"code":"AREA","labels":{"en_US":"Area","fr_FR":"Surface"},"standard_unit_code":"SQUARE_METER","units":{"SQUARE_MILLIMETER":{"code":"SQUARE_MILLIMETER","labels":{"en_US":"Square millimeter","fr_FR":"Millimètre carré"},"convert_from_standard":[{"operator":"mul","value":"0.000001"}],"symbol":"mm²"},"SQUARE_CENTIMETER":{"code":"SQUARE_CENTIMETER","labels":{"en_US":"Square centimeter","fr_FR":"Centimètre carré"},"convert_from_standard":[{"operator":"mul","value":"0.0001"}],"symbol":"cm²"},"SQUARE_METER":{"code":"SQUARE_METER","labels":{"en_US":"Square meter","fr_FR":"Mètre carré"},"convert_from_standard":[{"operator":"mul","value":"1"}],"symbol":"m²"}}}]},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"patch":{"summary":"Update/create several measurement families","operationId":"patch_measurement_families","tags":["Measurement family"],"x-versions":["5.0","6.0","7.0","SaaS"],"description":"This endpoint allows you to update and/or create several measurement families at once.","parameters":[{"name":"body","in":"body","schema":{"type":"array","items":{"type":"object","required":["code","standard_unit_code","units"],"properties":{"code":{"type":"string","description":"Measurement family code","x-immutable":true},"labels":{"type":"object","description":"Measurement family labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Measurement family label for the locale `localeCode`"}}},"standard_unit_code":{"type":"string","description":"Unit code used as the standard unit for this measurement family","x-immutable":true,"x-validation-rules":"The unit code exists in the list of the property `units`"},"units":{"type":"object","description":"Measurement units for this family with their conversion operations. More details here.","x-validation-rules":"A unit can't be added when a product attribute is linked to this measurement family","properties":{"unitCode":{"type":"object","properties":{"code":{"type":"string","description":"Measurement unit code. More details here.","x-immutable":true},"labels":{"type":"object","description":"Unit labels for each locale. More details here.","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Unit label for the locale `localeCode`"}}},"convert_from_standard":{"type":"array","description":"Calculation to convert the unit from the standard unit. More details here.","x-validation-rules":"• The conversion operations can't be updated when a product attribute is linked to this measurement family • At least one conversion operation per unit is required","items":{"type":"object","properties":{"operator":{"type":"string","description":"Operator for a conversion operation to convert the unit in the standard unit","x-validation-rules":"The operator is one of the following values","enum":["mul","div","add","sub"]},"value":{"type":"string","description":"Value for a conversion operation to convert the unit in the standard unit"}}}},"symbol":{"type":"string","description":"Measurement unit symbol. More details here."}}}}}},"example":{"code":"AREA","labels":{"en_US":"Area","fr_FR":"Surface"},"standard_unit_code":"SQUARE_METER","units":{"SQUARE_MILLIMETER":{"code":"SQUARE_MILLIMETER","labels":{"en_US":"Square millimeter","fr_FR":"Millimètre carré"},"convert_from_standard":[{"operator":"mul","value":"0.000001"}],"symbol":"mm²"},"SQUARE_CENTIMETER":{"code":"SQUARE_CENTIMETER","labels":{"en_US":"Square centimeter","fr_FR":"Centimètre carré"},"convert_from_standard":[{"operator":"mul","value":"0.0001"}],"symbol":"cm²"},"SQUARE_METER":{"code":"SQUARE_METER","labels":{"en_US":"Square meter","fr_FR":"Mètre carré"},"convert_from_standard":[{"operator":"mul","value":"1"}],"symbol":"m²"}}}},"example":[{"code":"AREA","labels":{"en_US":"Area","fr_FR":"Surface"},"standard_unit_code":"SQUARE_METER","units":{"SQUARE_MILLIMETER":{"code":"SQUARE_MILLIMETER","labels":{"en_US":"Square millimeter","fr_FR":"Millimètre carré"},"convert_from_standard":[{"operator":"mul","value":"0.000001"}],"symbol":"mm²"},"SQUARE_CENTIMETER":{"code":"SQUARE_CENTIMETER","labels":{"en_US":"Square centimeter","fr_FR":"Centimètre carré"},"convert_from_standard":[{"operator":"mul","value":"0.0001"}],"symbol":"cm²"},"SQUARE_METER":{"code":"SQUARE_METER","labels":{"en_US":"Square meter","fr_FR":"Mètre carré"},"convert_from_standard":[{"operator":"mul","value":"1"}],"symbol":"m²"}}}]}}],"responses":{"200":{"description":"OK","x-details":"Returns a JSON containing the status of each update or creation","x-no-entity":true,"schema":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Resource code"},"status_code":{"type":"integer","description":"HTTP status code, see Client errors to understand the meaning of each code"},"message":{"type":"string","description":"Message explaining the error"},"errors":{"type":"array","description":"List of errors","items":{"type":"object","properties":{"property":{"type":"string"},"message":{"type":"string"}}}}}}},"x-examples":[{"code":"Angle","status_code":201},{"code":"Force","status_code":204},{"code":"Area","status_code":422,"message":"The measurement family has data that does not comply with the business rules.","errors":[{"property":"standard_unit_code","message":"The standard unit code of the \"Angle\" measurement family cannot be changed"}]}]},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"413":{"description":"Request Entity Too Large","x-details":"There are too many resources to process (max 100) or the line of JSON is too long (max 1 000 000 characters)","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":413,"message":"Too many resources to process, 100 is the maximum allowed."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/vnd.akeneo.collection+json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/vnd.akeneo.collection+json’ is allowed."}}}}},"/api/rest/v1/reference-entities":{"get":{"summary":"Get list of reference entities","operationId":"get_reference_entities","description":"This endpoint allows you to get a list of reference entities. Reference entities are paginated.","tags":["Reference entity"],"x-versions":["3.x","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"parameters":[{"name":"search_after","in":"query","description":"Cursor when using the `search_after` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"string","default":"cursor to the first page"}],"responses":{"200":{"description":"Return reference entities paginated","schema":{"title":"Reference Entities","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}},"image_download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the binaries of the reference entity image file"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Reference entity code","x-immutable":true},"labels":{"type":"object","description":"Reference entity labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Reference entity label for the locale `localeCode`"}}},"image":{"type":"string","description":"Code of the reference entity image","default":null}},"example":{"code":"brands","labels":{"en_US":"Brands","fr_FR":"Marques"},"image":"0/2/d/6/54d81dc888ba1501a8g765f3ab5797569f3bv756c_ref_img.png"}}]}}}}}}]},"examples":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/reference-entities"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/reference-entities"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/reference-entities?search_after=2x055w%3D%3D"}},"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/reference-entities/brands"},"image_download":{"href":"https://demo.akeneo.com/api/rest/v1/reference-entities-media-files/0/2/d/6/54d81dc888ba1501a8g765f3ab5797569f3bv756c_ref_img.png"}},"code":"brands","labels":{"en_US":"Brands","fr_FR":"Marque"},"image":"0/2/d/6/54d81dc888ba1501a8g765f3ab5797569f3bv756c_ref_img.png"},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/reference-entities/designers"}},"code":"designers","labels":{"en_US":"Designers","fr_FR":"Designers"},"image":null},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/reference-entities/colors"}},"code":"colors","labels":{"en_US":"Colors","fr_FR":"Couleurs"},"image":null}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}}},"/api/rest/v1/reference-entities/{code}":{"get":{"summary":"Get a reference entity","operationId":"get_reference_entities__code_","tags":["Reference entity"],"x-versions":["3.x","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"description":"This endpoint allows you to get the information about a given reference entity.","parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the reference entity in JSON format.","schema":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","x-read-only":true,"properties":{"image_download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the binaries of the reference entity image file"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Reference entity code","x-immutable":true},"labels":{"type":"object","description":"Reference entity labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Reference entity label for the locale `localeCode`"}}},"image":{"type":"string","description":"Code of the reference entity image","default":null}},"example":{"code":"brands","labels":{"en_US":"Brands","fr_FR":"Marques"},"image":"0/2/d/6/54d81dc888ba1501a8g765f3ab5797569f3bv756c_ref_img.png"}}],"example":{"_links":{"image_download":{"href":"https://demo.akeneo.com/api/rest/v1/reference-entities-media-files/0/2/d/6/54d81dc888ba1501a8g765f3ab5797569f3bv756c_ref_img.png"}},"code":"brands","labels":{"en_US":"Brands","fr_FR":"Marques"},"image":"0/2/d/6/54d81dc888ba1501a8g765f3ab5797569f3bv756c_ref_img.png"}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"patch":{"summary":"Update/create a reference entity","operationId":"patch_reference_entity__code_","tags":["Reference entity"],"x-versions":["3.x","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"description":"This endpoint allows you to update a given reference entity. Note that if the reference entity does not already exist, it creates it.","parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"},{"name":"body","in":"body","required":true,"schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Reference entity code","x-immutable":true},"labels":{"type":"object","description":"Reference entity labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Reference entity label for the locale `localeCode`"}}},"image":{"type":"string","description":"Code of the reference entity image","default":null}},"example":{"code":"brands","labels":{"en_US":"Brands","fr_FR":"Marques"},"image":"0/2/d/6/54d81dc888ba1501a8g765f3ab5797569f3bv756c_ref_img.png"}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"204":{"description":"No content to return","x-details":"Means that the update was successful","headers":{"Location":{"description":"URI of the updated resource","type":"string"}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/reference-entities/{reference_entity_code}/attributes":{"get":{"summary":"Get the list of attributes of a given reference entity","operationId":"get_reference_entities__code__attributes","description":"This endpoint allows you to get the list of attributes of a given reference entity.","tags":["Reference entity attribute"],"x-versions":["3.x","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"parameters":[{"name":"reference_entity_code","in":"path","description":"Code of the reference entity","required":true,"type":"string"}],"responses":{"200":{"description":"Return the attributes of the given reference entity","x-no-entity":true,"schema":{"type":"array","items":{"type":"object","required":["code","type"],"properties":{"code":{"type":"string","description":"Attribute code","x-immutable":true},"labels":{"type":"object","description":"Attribute labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute label for the locale `localeCode`"}}},"type":{"type":"string","description":"Attribute type. See type section for more details.","enum":["text","image","number","single_option","multiple_options","reference_entity_single_link","reference_entity_multiple_links"],"x-immutable":true},"value_per_locale":{"type":"boolean","description":"Whether the attribute is localizable, i.e. can have one value by locale","default":false,"x-immutable":true},"value_per_channel":{"type":"boolean","description":"Whether the attribute is scopable, i.e. can have one value by channel","default":false,"x-immutable":true},"is_required_for_completeness":{"type":"boolean","description":"Whether the attribute should be part of the record's completeness calculation","default":false},"max_characters":{"type":"integer","description":"Maximum number of characters allowed for the value of the attribute when the attribute type is `text`","x-warning":"Only for `text` attribute type"},"is_textarea":{"type":"boolean","description":"Whether the UI should display a text area instead of a simple field when the attribute type is `text`","default":false,"x-warning":"Only for `text` attribute type"},"is_rich_text_editor":{"type":"boolean","description":"Whether the UI should display a rich text editor instead of a simple text area when the attribute type is `text`","x-validation-rules":"Required when the property `is_textarea` is equal to `true`","x-warning":"Only for `text` attribute type"},"validation_rule":{"type":"string","description":"Validation rule type used to validate the attribute value when the attribute type is `text`","default":"none","x-warning":"Only for `text` attribute type","enum":["email","url","regexp","none"]},"validation_regexp":{"type":"string","description":"Regexp expression used to validate the attribute value when the attribute type is `text`","default":null,"x-validation-rules":"Required when the property `validation_rule` is equal to `regexp`","x-warning":"Only for `text` attribute type"},"allowed_extensions":{"type":"array","description":"Extensions allowed when the attribute type is `image`","default":[],"x-warning":"Only for `image` attribute type","items":{"type":"string"}},"max_file_size":{"type":"string","description":"Max file size in MB when the attribute type is `image`","default":null,"x-warning":"Only for `image` attribute type"},"reference_entity_code":{"type":"string","description":"Code of the linked reference entity when the attribute type is `reference_entity_single_link` or `reference_entity_multiple_links`","default":null,"x-validation-rules":"Required when the attribute type is either `reference_entity_single_link` or `reference_entity_multiple_links`","x-warning":"Only for `reference_entity_single_link` and `reference_entity_multiple_links` attribute type","x-immutable":true},"decimals_allowed":{"type":"boolean","description":"Whether decimals are allowed when the attribute type is `number`","default":false,"x-warning":"Only for `number` attribute type"},"min_value":{"type":"string","description":"Minimum value allowed when the attribute type is `number`","default":null,"x-validation-rules":"The minimum value must be lower than the maximum value","x-warning":"Only for `number` attribute type"},"max_value":{"type":"string","description":"Maximum value allowed when the attribute type is `number`","default":null,"x-validation-rules":"The maximum value must be greater than the minimum value","x-warning":"Only for `number` attribute type"}},"example":{"code":"description","labels":{"en_US":"Description","fr_FR":"Description"},"type":"text","value_per_locale":true,"value_per_channel":false,"is_required_for_completeness":true,"max_characters":null,"is_textarea":true,"is_rich_text_editor":true,"validation_rule":"none","validation_regexp":null}}},"x-examples":[{"code":"description","labels":{"en_US":"Description","fr_FR":"Description"},"type":"text","value_per_locale":true,"value_per_channel":false,"is_required_for_completeness":true,"max_characters":null,"is_textarea":true,"is_rich_text_editor":true,"validation_rule":"none","validation_regexp":null},{"code":"country","labels":{"en_US":"Country","fr_FR":"Pays"},"type":"text","value_per_locale":false,"value_per_channel":false,"is_required_for_completeness":false},{"code":"creation_year","labels":{"en_US":"Creation year","fr_FR":"Année de création"},"type":"number","value_per_locale":false,"value_per_channel":false,"is_required_for_completeness":false,"decimals_allowed":false,"min_value":"1800","max_value":"2100"},{"code":"collection_overview","labels":{"en_US":"Collection overview","fr_FR":"Aperçu de la collection"},"type":"image","value_per_locale":true,"value_per_channel":false,"is_required_for_completeness":true,"allowed_extensions":["png"],"max_file_size":"1000"}]},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}}},"/api/rest/v1/reference-entities/{reference_entity_code}/attributes/{code}":{"get":{"summary":"Get an attribute of a given reference entity","operationId":"get_reference_entity_attributes__code_","tags":["Reference entity attribute"],"x-versions":["3.x","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"description":"This endpoint allows you to get the information about a given attribute for a given reference entity.","parameters":[{"name":"reference_entity_code","in":"path","description":"Code of the reference entity","required":true,"type":"string"},{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the reference entity attribute in JSON format","schema":{"type":"object","required":["code","type"],"properties":{"code":{"type":"string","description":"Attribute code","x-immutable":true},"labels":{"type":"object","description":"Attribute labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute label for the locale `localeCode`"}}},"type":{"type":"string","description":"Attribute type. See type section for more details.","enum":["text","image","number","single_option","multiple_options","reference_entity_single_link","reference_entity_multiple_links"],"x-immutable":true},"value_per_locale":{"type":"boolean","description":"Whether the attribute is localizable, i.e. can have one value by locale","default":false,"x-immutable":true},"value_per_channel":{"type":"boolean","description":"Whether the attribute is scopable, i.e. can have one value by channel","default":false,"x-immutable":true},"is_required_for_completeness":{"type":"boolean","description":"Whether the attribute should be part of the record's completeness calculation","default":false},"max_characters":{"type":"integer","description":"Maximum number of characters allowed for the value of the attribute when the attribute type is `text`","x-warning":"Only for `text` attribute type"},"is_textarea":{"type":"boolean","description":"Whether the UI should display a text area instead of a simple field when the attribute type is `text`","default":false,"x-warning":"Only for `text` attribute type"},"is_rich_text_editor":{"type":"boolean","description":"Whether the UI should display a rich text editor instead of a simple text area when the attribute type is `text`","x-validation-rules":"Required when the property `is_textarea` is equal to `true`","x-warning":"Only for `text` attribute type"},"validation_rule":{"type":"string","description":"Validation rule type used to validate the attribute value when the attribute type is `text`","default":"none","x-warning":"Only for `text` attribute type","enum":["email","url","regexp","none"]},"validation_regexp":{"type":"string","description":"Regexp expression used to validate the attribute value when the attribute type is `text`","default":null,"x-validation-rules":"Required when the property `validation_rule` is equal to `regexp`","x-warning":"Only for `text` attribute type"},"allowed_extensions":{"type":"array","description":"Extensions allowed when the attribute type is `image`","default":[],"x-warning":"Only for `image` attribute type","items":{"type":"string"}},"max_file_size":{"type":"string","description":"Max file size in MB when the attribute type is `image`","default":null,"x-warning":"Only for `image` attribute type"},"reference_entity_code":{"type":"string","description":"Code of the linked reference entity when the attribute type is `reference_entity_single_link` or `reference_entity_multiple_links`","default":null,"x-validation-rules":"Required when the attribute type is either `reference_entity_single_link` or `reference_entity_multiple_links`","x-warning":"Only for `reference_entity_single_link` and `reference_entity_multiple_links` attribute type","x-immutable":true},"decimals_allowed":{"type":"boolean","description":"Whether decimals are allowed when the attribute type is `number`","default":false,"x-warning":"Only for `number` attribute type"},"min_value":{"type":"string","description":"Minimum value allowed when the attribute type is `number`","default":null,"x-validation-rules":"The minimum value must be lower than the maximum value","x-warning":"Only for `number` attribute type"},"max_value":{"type":"string","description":"Maximum value allowed when the attribute type is `number`","default":null,"x-validation-rules":"The maximum value must be greater than the minimum value","x-warning":"Only for `number` attribute type"}},"example":{"code":"description","labels":{"en_US":"Description","fr_FR":"Description"},"type":"text","value_per_locale":true,"value_per_channel":false,"is_required_for_completeness":true,"max_characters":null,"is_textarea":true,"is_rich_text_editor":true,"validation_rule":"none","validation_regexp":null}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"patch":{"summary":"Update/create an attribute of a given reference entity","operationId":"patch_reference_entity_attributes__code_","tags":["Reference entity attribute"],"x-versions":["3.x","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"description":"This endpoint allows you to update a given attribute for a given renference entity. Note that if the attribute does not already exist for the given reference entity, it creates it.","parameters":[{"name":"reference_entity_code","in":"path","description":"Code of the reference entity","required":true,"type":"string"},{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"},{"name":"body","in":"body","required":true,"schema":{"type":"object","required":["code","type"],"properties":{"code":{"type":"string","description":"Attribute code","x-immutable":true},"labels":{"type":"object","description":"Attribute labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute label for the locale `localeCode`"}}},"type":{"type":"string","description":"Attribute type. See type section for more details.","enum":["text","image","number","single_option","multiple_options","reference_entity_single_link","reference_entity_multiple_links"],"x-immutable":true},"value_per_locale":{"type":"boolean","description":"Whether the attribute is localizable, i.e. can have one value by locale","default":false,"x-immutable":true},"value_per_channel":{"type":"boolean","description":"Whether the attribute is scopable, i.e. can have one value by channel","default":false,"x-immutable":true},"is_required_for_completeness":{"type":"boolean","description":"Whether the attribute should be part of the record's completeness calculation","default":false},"max_characters":{"type":"integer","description":"Maximum number of characters allowed for the value of the attribute when the attribute type is `text`","x-warning":"Only for `text` attribute type"},"is_textarea":{"type":"boolean","description":"Whether the UI should display a text area instead of a simple field when the attribute type is `text`","default":false,"x-warning":"Only for `text` attribute type"},"is_rich_text_editor":{"type":"boolean","description":"Whether the UI should display a rich text editor instead of a simple text area when the attribute type is `text`","x-validation-rules":"Required when the property `is_textarea` is equal to `true`","x-warning":"Only for `text` attribute type"},"validation_rule":{"type":"string","description":"Validation rule type used to validate the attribute value when the attribute type is `text`","default":"none","x-warning":"Only for `text` attribute type","enum":["email","url","regexp","none"]},"validation_regexp":{"type":"string","description":"Regexp expression used to validate the attribute value when the attribute type is `text`","default":null,"x-validation-rules":"Required when the property `validation_rule` is equal to `regexp`","x-warning":"Only for `text` attribute type"},"allowed_extensions":{"type":"array","description":"Extensions allowed when the attribute type is `image`","default":[],"x-warning":"Only for `image` attribute type","items":{"type":"string"}},"max_file_size":{"type":"string","description":"Max file size in MB when the attribute type is `image`","default":null,"x-warning":"Only for `image` attribute type"},"reference_entity_code":{"type":"string","description":"Code of the linked reference entity when the attribute type is `reference_entity_single_link` or `reference_entity_multiple_links`","default":null,"x-validation-rules":"Required when the attribute type is either `reference_entity_single_link` or `reference_entity_multiple_links`","x-warning":"Only for `reference_entity_single_link` and `reference_entity_multiple_links` attribute type","x-immutable":true},"decimals_allowed":{"type":"boolean","description":"Whether decimals are allowed when the attribute type is `number`","default":false,"x-warning":"Only for `number` attribute type"},"min_value":{"type":"string","description":"Minimum value allowed when the attribute type is `number`","default":null,"x-validation-rules":"The minimum value must be lower than the maximum value","x-warning":"Only for `number` attribute type"},"max_value":{"type":"string","description":"Maximum value allowed when the attribute type is `number`","default":null,"x-validation-rules":"The maximum value must be greater than the minimum value","x-warning":"Only for `number` attribute type"}},"example":{"code":"description","labels":{"en_US":"Description","fr_FR":"Description"},"type":"text","value_per_locale":true,"value_per_channel":false,"is_required_for_completeness":true,"max_characters":null,"is_textarea":true,"is_rich_text_editor":true,"validation_rule":"none","validation_regexp":null}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"204":{"description":"No content to return","x-details":"Means that the update was successful","headers":{"Location":{"description":"URI of the updated resource","type":"string"}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/reference-entities/{reference_entity_code}/attributes/{attribute_code}/options":{"get":{"summary":"Get a list of attribute options of a given attribute for a given reference entity","operationId":"get_reference_entity_attributes__attribute_code__options","description":"This endpoint allows you to get a list of attribute options for a given reference entity.","tags":["Reference entity attribute option"],"x-versions":["3.x","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"parameters":[{"name":"reference_entity_code","in":"path","description":"Code of the reference entity","required":true,"type":"string"},{"name":"attribute_code","in":"path","description":"Code of the attribute","required":true,"type":"string"}],"responses":{"200":{"description":"Return the options of the given attributes of the given reference entity","x-no-entity":true,"schema":{"type":"array","items":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Attribute's option code","x-immutable":true},"labels":{"type":"object","description":"Attribute labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute label for the locale `localeCode`"}}}},"example":{"code":"global_nomad","labels":{"en_US":"Global Nomad","fr_FR":"Nomade du Monde"}}}},"x-examples":[{"code":"woodland_retreat","labels":{"en_US":"Woodland Retreat","fr_FR":"Retraite dans les Bois"}},{"code":"new_nordic","labels":{"en_US":"New Nordic","fr_FR":"Renouveau Scandinave"}},{"code":"global_nomad","labels":{"en_US":"Global Nomad","fr_FR":"Nomade du Monde"}}]},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}}},"/api/rest/v1/reference-entities/{reference_entity_code}/attributes/{attribute_code}/options/{code}":{"get":{"summary":"Get an attribute option for a given attribute of a given reference entity","operationId":"get_reference_entity_attributes__attribute_code__options__code_","description":"This endpoint allows you to get the information about a given attribute option.","tags":["Reference entity attribute option"],"x-versions":["3.x","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"parameters":[{"name":"reference_entity_code","in":"path","description":"Code of the reference entity","required":true,"type":"string"},{"name":"attribute_code","in":"path","description":"Code of the attribute","required":true,"type":"string"},{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the reference entity attribute option in JSON format","schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Attribute's option code","x-immutable":true},"labels":{"type":"object","description":"Attribute labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute label for the locale `localeCode`"}}}},"example":{"code":"global_nomad","labels":{"en_US":"Global Nomad","fr_FR":"Nomade du Monde"}}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"patch":{"summary":"Update/create a reference entity attribute option","operationId":"patch_reference_entity_attributes__attribute_code__options__code_","tags":["Reference entity attribute option"],"x-versions":["3.x","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"description":"This endpoint allows you to update a given option for a given attribute and a given reference entity. Learn more about Update behavior. Note that if the option does not already exist for the given attribute of the given reference entity, it creates it.","parameters":[{"name":"reference_entity_code","in":"path","description":"Code of the reference entity","required":true,"type":"string"},{"name":"attribute_code","in":"path","description":"Code of the attribute","required":true,"type":"string"},{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"},{"name":"body","in":"body","required":true,"schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Attribute's option code","x-immutable":true},"labels":{"type":"object","description":"Attribute labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute label for the locale `localeCode`"}}}},"example":{"code":"global_nomad","labels":{"en_US":"Global Nomad","fr_FR":"Nomade du Monde"}}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"204":{"description":"No content to return","x-details":"Means that the update was successful","headers":{"Location":{"description":"URI of the updated resource","type":"string"}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/reference-entities/{reference_entity_code}/records":{"get":{"summary":"Get the list of the records of a reference entity","operationId":"get_reference_entity_records","tags":["Reference entity record"],"x-versions":["3.x","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"description":"This endpoint allows you to get a list of records of a given reference entity. Records are paginated and can be filtered.","parameters":[{"name":"search","in":"query","description":"Filter records of the reference entity, for more details see the Filters section","required":false,"type":"string"},{"name":"channel","in":"query","type":"string","description":"Filter attribute values to return scopable attributes for the given channel as well as the non localizable/non scopable attributes, for more details see the Filter attribute values by channel section","required":false},{"name":"locales","in":"query","type":"string","description":"Filter attribute values to return localizable attributes for the given locales as well as the non localizable/non scopable attributes, for more details see the Filter attribute values by locale section","required":false},{"name":"reference_entity_code","in":"path","description":"Code of the reference entity","required":true,"type":"string"},{"name":"search_after","in":"query","description":"Cursor when using the `search_after` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"string","default":"cursor to the first page"}],"responses":{"200":{"description":"Return the records of the given reference entity paginated","schema":{"title":"Reference entity record","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Code of the record","x-immutable":true},"values":{"type":"object","description":"Record attributes values, see Reference entity record values section for more details","x-validation-rules":"Validation rules detailed in Reference entity record values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","description":"Channel code of the reference entity record value"},"locale":{"type":"string","description":"Locale code of the reference entity record value"},"data":{"type":"object","description":"Reference entity record value. See the `data` format section for more details."}}}}}},"created":{"type":"string","description":"Date of creation.","format":"dateTime","default":null,"x-immutable":true,"x-read-only":true,"x-from-version":"5.0"},"updated":{"type":"string","description":"Date of the last update.","format":"dateTime","default":null,"x-read-only":true,"x-from-version":"5.0"}},"example":{"code":"kartell","values":{"label":[{"locale":"en_US","channel":null,"data":"Kartell"}],"image":[{"locale":null,"channel":null,"data":"0/c/b/0/0cb0c0e115dedba676f8d1ad8343ec207ab54c7b_image.jpg"}],"description":[{"locale":"en_US","channel":null,"data":"Kartell, the Italian furniture company that sells modern and remarkable pieces of furnitures."},{"locale":"fr_FR","channel":null,"data":"Kartell, l'éditeur de meuble italien spécialisé dans la signature de belle pièces au design contemporain."}],"country":[{"locale":null,"channel":null,"data":"italy"}],"collection_overview":[{"locale":null,"channel":null,"data":"5/1/d/8/51d81dc778ba1501a8f998f3ab5797569f3b9e25_img.png"}],"creation_year":[{"locale":null,"channel":null,"data":"1949"}]},"created":"2021-01-01T01:23:34+00:00","updated":"2021-02-03T23:45:60+00:00"}}]}}}}}}]},"examples":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/reference-entities/brands/records"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/reference-entities/brands/records"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/reference-entities/brands/records?search_after=2x088w%3D%3D"}},"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/reference-entities/brands/records/kartell"}},"code":"kartell","values":{"label":[{"locale":"en_US","channel":null,"data":"Kartell"}],"image":[{"locale":null,"channel":null,"data":"0/c/b/0/0cb0c0e115dedba676f8d1ad8343ec207ab54c7b_image.jpg"}],"description":[{"data":"The contemporary Italian furniture brand","locale":"en_US","channel":null},{"data":"L'éditeur de meubles comtemporain italien","locale":"fr_FR","channel":null}],"country":[{"locale":null,"channel":null,"data":"italy"}]},"created":"2021-01-01T01:23:34+00:00","updated":"2021-02-03T23:45:60+00:00"},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/reference-entities/brands/records/usm"}},"code":"usm","values":{"label":[{"locale":"en_US","channel":null,"data":"USM"}],"image":[{"locale":null,"channel":null,"data":"9/c/g/1/0cb0c0e115dedba76f8d1ad8343ec897abc43bv4_image.jpg"}],"description":[{"data":"Modular furniture from Switzerland for your home and office","locale":"en_US","channel":null},{"data":"L'éditeur de meubles modulaires suisse pour votre intérieur et pour les entreprises","locale":"fr_FR","channel":null}],"country":[{"locale":null,"channel":null,"data":"switzerland"}]},"created":"2021-01-01T01:23:34+00:00","updated":"2021-02-03T23:45:60+00:00"},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/reference-entities/brands/records/ligneroset"}},"code":"ligneroset","values":{"label":[{"locale":"en_US","channel":null,"data":"Ligne Roset"}],"image":[{"locale":null,"channel":null,"data":"4/b/0/1/0cb0c0e115dedde78b8d1ad8343ec980cd5daa54_image.jpg"}],"description":[{"data":"Very well known French brand of modern and luxury furniture","locale":"en_US","channel":null},{"data":"La marque renommée des meubles de luxe à la française","locale":"fr_FR","channel":null}],"country":[{"locale":null,"channel":null,"data":"france"}]},"created":"2021-01-01T01:23:34+00:00","updated":"2021-02-03T23:45:60+00:00"}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"patch":{"summary":"Update/create several reference entity records","operationId":"patch_reference_entity_records","tags":["Reference entity record"],"x-versions":["3.x","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"description":"This endpoint allows you to update and/or create several records of one given reference entity at once. Learn more about Update behavior. Note that if the record does not already exist for the given reference entity, it creates it.","parameters":[{"name":"reference_entity_code","in":"path","description":"Code of the reference entity","required":true,"type":"string"},{"name":"body","in":"body","required":true,"schema":{"type":"array","items":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Code of the record","x-immutable":true},"values":{"type":"object","description":"Record attributes values, see Reference entity record values section for more details","x-validation-rules":"Validation rules detailed in Reference entity record values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","description":"Channel code of the reference entity record value"},"locale":{"type":"string","description":"Locale code of the reference entity record value"},"data":{"type":"object","description":"Reference entity record value. See the `data` format section for more details."}}}}}},"created":{"type":"string","description":"Date of creation.","format":"dateTime","default":null,"x-immutable":true,"x-read-only":true,"x-from-version":"5.0"},"updated":{"type":"string","description":"Date of the last update.","format":"dateTime","default":null,"x-read-only":true,"x-from-version":"5.0"}},"example":{"code":"kartell","values":{"label":[{"locale":"en_US","channel":null,"data":"Kartell"}],"image":[{"locale":null,"channel":null,"data":"0/c/b/0/0cb0c0e115dedba676f8d1ad8343ec207ab54c7b_image.jpg"}],"description":[{"locale":"en_US","channel":null,"data":"Kartell, the Italian furniture company that sells modern and remarkable pieces of furnitures."},{"locale":"fr_FR","channel":null,"data":"Kartell, l'éditeur de meuble italien spécialisé dans la signature de belle pièces au design contemporain."}],"country":[{"locale":null,"channel":null,"data":"italy"}],"collection_overview":[{"locale":null,"channel":null,"data":"5/1/d/8/51d81dc778ba1501a8f998f3ab5797569f3b9e25_img.png"}],"creation_year":[{"locale":null,"channel":null,"data":"1949"}]},"created":"2021-01-01T01:23:34+00:00","updated":"2021-02-03T23:45:60+00:00"}},"example":[{"code":"kartell","values":{"label":[{"locale":"en_US","channel":null,"data":"Kartell"}],"image":[{"locale":null,"channel":null,"data":"0/c/b/0/0cb0c0e115dedba676f8d1ad8343ec207ab54c7b_image.jpg"}],"description":[{"locale":"en_US","channel":null,"data":"Kartell, the Italian furniture company that sells modern and remarkable pieces of furnitures."},{"locale":"fr_FR","channel":null,"data":"Kartell, l'éditeur de meuble italien spécialisé dans la signature de belle pièces au design contemporain."}],"country":[{"locale":null,"channel":null,"data":"italy"}],"collection_overview":[{"locale":null,"channel":null,"data":"5/1/d/8/51d81dc778ba1501a8f998f3ab5797569f3b9e25_img.png"}],"creation_year":[{"locale":null,"channel":null,"data":"1949"}]}},{"code":"ligneroset","values":{"label":[{"locale":"en_US","channel":null,"data":"Ligne Roset"}],"image":[{"locale":null,"channel":null,"data":"4/b/0/1/0cb0c0e115dedde78b8d1ad8343ec980cd5daa54_image.jpg"}],"description":[{"data":"Very well known French brand of modern and luxury furniture","locale":"en_US","channel":null},{"data":"La marque renommée des meubles de luxe à la française","locale":"fr_FR","channel":null}],"country":[{"locale":null,"channel":null,"data":"france"}],"creation_year":[{"locale":null,"channel":null,"data":"1860"}]}},{"code":"usm","values":{"label":[{"locale":"en_US","channel":null,"data":"USM"}],"image":[{"locale":null,"channel":null,"data":"9/c/g/1/0cb0c0e115dedba76f8d1ad8343ec897abc43bv4_image.jpg"}],"description":[{"data":"Modular furniture from Switzerland for your home and office","locale":"en_US","channel":null},{"data":"L'éditeur de meubles modulaires suisse pour votre intérieur et pour les entreprises","locale":"fr_FR","channel":null}],"country":[{"locale":null,"channel":null,"data":"switzerland"}],"creation_year":[{"locale":null,"channel":null,"data":"1885"}]}}]}}],"responses":{"200":{"description":"OK","x-details":"Returns an JSON array in which each object gives you the status of each record creation or update","x-no-entity":true,"schema":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Resource code"},"status_code":{"type":"integer","description":"HTTP status code, see Client errors to understand the meaning of each code"},"message":{"type":"string","description":"Message explaining the error"}}}},"x-examples":[{"code":"kartell","status_code":204},{"code":"ligneroset","status_code":422,"message":"Property 'group' does not exist."},{"code":"usm","status_code":201}]},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"413":{"description":"Request Entity Too Large","x-details":"There are too many resources to process (max 100) or the line of JSON is too long (max 1 000 000 characters)","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":413,"message":"Too many resources to process, 100 is the maximum allowed."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/vnd.akeneo.collection+json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/vnd.akeneo.collection+json’ is allowed."}}}}},"/api/rest/v1/reference-entities/{reference_entity_code}/records/{code}":{"get":{"summary":"Get a record of a given reference entity","operationId":"get_reference_entity_records__code_","tags":["Reference entity record"],"x-versions":["3.x","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"description":"This endpoint allows you to get the information about a given record for a given reference entity.","parameters":[{"name":"reference_entity_code","in":"path","description":"Code of the reference entity","required":true,"type":"string"},{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the product in JSON standard format","schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Code of the record","x-immutable":true},"values":{"type":"object","description":"Record attributes values, see Reference entity record values section for more details","x-validation-rules":"Validation rules detailed in Reference entity record values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","description":"Channel code of the reference entity record value"},"locale":{"type":"string","description":"Locale code of the reference entity record value"},"data":{"type":"object","description":"Reference entity record value. See the `data` format section for more details."}}}}}},"created":{"type":"string","description":"Date of creation.","format":"dateTime","default":null,"x-immutable":true,"x-read-only":true,"x-from-version":"5.0"},"updated":{"type":"string","description":"Date of the last update.","format":"dateTime","default":null,"x-read-only":true,"x-from-version":"5.0"}},"example":{"code":"kartell","values":{"label":[{"locale":"en_US","channel":null,"data":"Kartell"}],"image":[{"locale":null,"channel":null,"data":"0/c/b/0/0cb0c0e115dedba676f8d1ad8343ec207ab54c7b_image.jpg"}],"description":[{"locale":"en_US","channel":null,"data":"Kartell, the Italian furniture company that sells modern and remarkable pieces of furnitures."},{"locale":"fr_FR","channel":null,"data":"Kartell, l'éditeur de meuble italien spécialisé dans la signature de belle pièces au design contemporain."}],"country":[{"locale":null,"channel":null,"data":"italy"}],"collection_overview":[{"locale":null,"channel":null,"data":"5/1/d/8/51d81dc778ba1501a8f998f3ab5797569f3b9e25_img.png"}],"creation_year":[{"locale":null,"channel":null,"data":"1949"}]},"created":"2021-01-01T01:23:34+00:00","updated":"2021-02-03T23:45:60+00:00"}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"patch":{"summary":"Update/create a record of a given reference entity","operationId":"patch_reference_entity_records__code_","tags":["Reference entity record"],"x-versions":["3.x","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"description":"This endpoint allows you to update a given record of a given renference entity. Learn more about Update behavior. Note that if the record does not already exist for the given reference entity, it creates it.","parameters":[{"name":"reference_entity_code","in":"path","description":"Code of the reference entity","required":true,"type":"string"},{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"},{"name":"body","in":"body","required":true,"schema":{"example":{"code":"kartell","values":{"label":[{"locale":"en_US","channel":null,"data":"Kartell"}],"image":[{"locale":null,"channel":null,"data":"0/c/b/0/0cb0c0e115dedba676f8d1ad8343ec207ab54c7b_image.jpg"}],"description":[{"locale":"en_US","channel":null,"data":"Kartell, the Italian furniture company that sells modern and remarkable pieces of furnitures."},{"locale":"fr_FR","channel":null,"data":"Kartell, l'éditeur de meuble italien spécialisé dans la signature de belle pièces au design contemporain."}],"country":[{"locale":null,"channel":null,"data":"italy"}],"collection_overview":[{"locale":null,"channel":null,"data":"5/1/d/8/51d81dc778ba1501a8f998f3ab5797569f3b9e25_img.png"}],"creation_year":[{"locale":null,"channel":null,"data":"1949"}]}},"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Code of the record","x-immutable":true},"values":{"type":"object","description":"Record attributes values, see Reference entity record values section for more details","x-validation-rules":"Validation rules detailed in Reference entity record values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","description":"Channel code of the reference entity record value"},"locale":{"type":"string","description":"Locale code of the reference entity record value"},"data":{"type":"object","description":"Reference entity record value. See the `data` format section for more details."}}}}}},"created":{"type":"string","description":"Date of creation.","format":"dateTime","default":null,"x-immutable":true,"x-read-only":true,"x-from-version":"5.0"},"updated":{"type":"string","description":"Date of the last update.","format":"dateTime","default":null,"x-read-only":true,"x-from-version":"5.0"}}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"204":{"description":"No content to return","x-details":"Means that the update was successful","headers":{"Location":{"description":"URI of the updated resource","type":"string"}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/reference-entities-media-files":{"post":{"summary":"Create a new media file for a reference entity or a record","operationId":"post_reference_entity_media_files","description":"This endpoint allows you to create a new media file and associate it to the image of a reference entity, or to the main image or to an attribute value of a record.","tags":["Reference entity media file"],"x-versions":["3.x","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"parameters":[{"name":"Content-type","in":"header","type":"string","description":"Equal to 'multipart/form-data', no other value allowed","required":true},{"name":"body","in":"body","x-form-data":true,"schema":{"required":["file"],"properties":{"file":{"type":"string","description":"The binary of the media file","format":"binary"}}}}],"responses":{"201":{"description":"Created","x-details":"Means that the media file creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"},"Reference-entities-media-file-code":{"description":"Code of the media file","type":"string"}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `multipart/form-data`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘multipart/form-data’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/reference-entities-media-files/{code}":{"get":{"summary":"Download the media file associated to a reference entity or a record","operationId":"get_reference_entity_media_files__code","description":"This endpoint allows you to download a given media file that is associated with a reference entity or a record.","x-content-type":"Mime-type of the media file","tags":["Reference entity media file"],"x-versions":["3.x","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the binary of the media file","x-content-type":"Mime-type of the media file"},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}}}}},"/api/rest/v1/asset-families":{"get":{"summary":"Get list of asset families","operationId":"get_asset_families","description":"This endpoint allows you to get a list of asset families. Asset families are paginated.","tags":["Asset family"],"x-versions":["3.2","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"parameters":[{"name":"search_after","in":"query","description":"Cursor when using the `search_after` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"string","default":"cursor to the first page"}],"responses":{"200":{"description":"Return asset families paginated","schema":{"title":"Asset families","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Asset family code","x-immutable":true},"labels":{"type":"object","description":"Asset family labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Asset family label for the locale `localeCode`"}}},"attribute_as_main_media":{"type":"string","description":"Attribute code that is used as the main media of the asset family.","x-validation-rules":"It should be the code of an attribute that belongs to this family, and it must be a media file or a media link attribute type.","default":"First media file or media link attribute that was created"},"naming_convention":{"type":"object","description":"The naming convention ran over the asset code or the main media filename upon each asset creation, in order to automatically set several values in asset attributes. To learn more and see the format of this property, take a look at here.","x-validation-rules":"To know more about the validation of this property, take a look at our naming convention format.","default":{},"properties":{"source":{"type":"object","description":"The string on which the naming convention should be applied. More details here."},"pattern":{"type":"string","description":"The regular expression that should be applied on the source. More details here."},"abort_asset_creation_on_error":{"type":"boolean","description":"Whether the asset should be created if the naming convention failed to apply. More details here."}}},"product_link_rules":{"type":"array","description":"The rules that will be run after the asset creation, in order to automatically link the assets of this family to a set of products. To understand the format of this property, see here.","x-validation-rules":"To know more about the validation of this property, take a look at our product link rule format.","default":[],"items":{"type":"object","properties":{"product_selections":{"type":"array","description":"The product selection to which the assets of the asset family to be automatically linked. More details here.","items":{"type":"object","required":["field","operator","value"],"properties":{"field":{"type":"string"},"operator":{"type":"string"},"value":{"type":"string"},"locale":{"type":"string"},"channel":{"type":"string"}}}},"assign_assets_to":{"type":"array","description":"The product value in which your assets will be assigned. More details here.","items":{"type":"object","required":["attribute","mode"],"properties":{"attribute":{"type":"string"},"locale":{"type":"string"},"channel":{"type":"string"},"mode":{"type":"string"}}}}}}},"transformations":{"type":"array","description":"The transformations to perform on source files in order to generate new files into your asset attributes (only available since v4.0). To understand the format of this property, see here.","x-validation-rules":"To know more about the validation of this property, take a look at our transformation format.","x-from-version":"4.0","default":[],"items":{"type":"object","required":["label","target","source","operations"],"properties":{"label":{"type":"string","description":"The name of the transformation"},"filename_suffix":{"type":"string","description":"The suffix that will be appended to the source filename to generate the target filename. More details here."},"filename_prefix":{"type":"string","description":"The prefix that will be prepended to the source filename to generate the target filename. More details here."},"source":{"type":"object","required":["attribute","channel","locale"],"description":"The attribute value in which is stored the media file you want to use as the source file for your transformation. More details here.","properties":{"attribute":{"type":"string"},"channel":{"type":"string"},"locale":{"type":"string"}}},"target":{"type":"object","required":["attribute","channel","locale"],"description":"The attribute value in which the PIM will generate the new transformed file, aka the target file. More details here.","properties":{"attribute":{"type":"string"},"channel":{"type":"string"},"locale":{"type":"string"}}},"operations":{"type":"object","description":"The transformations that should be applied to your source file to generate the target file. More details here.","x-validation-rules":"Should contain at least one operation","properties":{"type":{"type":"string"},"parameters":{"type":"object","properties":{"colorspace":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"},"ratio":{"type":"integer"},"resolution-unit":{"type":"string"},"resolution-x":{"type":"integer"},"resolution-y":{"type":"integer"},"quality":{"type":"integer"}}}}}}}}},"example":{"code":"model_pictures","labels":{"en_US":"Model pictures","fr_FR":"Photographies en pied"},"attribute_as_main_media":"main_image","naming_convention":{"source":{"property":"code","channel":null,"locale":null},"pattern":"/(?P.*)-.*/","abort_asset_creation_on_error":true},"product_link_rules":[{"product_selections":[{"field":"sku","operator":"EQUALS","value":"{{product_ref}}"}],"assign_assets_to":[{"attribute":"model_pictures","mode":"replace"}]}],"transformations":[{"label":"Thumbnail plus black and white transformation","filename_suffix":"_thumbnailBW","source":{"attribute":"main_image","channel":null,"locale":null},"target":{"attribute":"thumbnail","channel":null,"locale":null},"operations":[{"type":"thumbnail","parameters":{"width":150,"height":150}},{"type":"colorspace","parameters":{"colorspace":"grey"}}]}]}}]}}}}}}]},"examples":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/asset-families"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/asset-families"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/asset-families?search_after=2x055w%3D%3D"}},"_embedded":{"_items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/asset-families/packshots"}},"code":"packshots","labels":{"en_US":"Packshots","fr_FR":"Plans produit"},"“naming_convention”":{"source":{"property":"code","channel":null,"locale":null},"pattern":"/(?P.*)\\.jpg/","abort_asset_creation_on_error":true},"product_link_rules":[{"product_selections":[{"field":"sku","operator":"=","value":"{{product_ref}}"}],"assign_assets_to":[{"attribute":"{{my_product_attribute}}","mode":"add"}]}],"transformations":[{"label":"My transformation","filename_suffix":"_thumbnailBW","source":{"attribute":"main_image","locale":null,"channel":null},"target":{"attribute":"thumbnail","locale":null,"channel":null},"operations":[{"type":"thumbnail","parameters":{"width":150,"height":150}},{"type":"colorspace","parameters":{"colorspace":"grey"}}]}]},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/asset-families/videos"}},"code":"videos","labels":{"en_US":"Videos","fr_FR":"Vidéos"},"product_link_rules":[{"product_selections":[{"field":"categories","operator":"IN","value":["{{category}}"]}],"assign_assets_to":[{"attribute":"presentation_video","locale":"{{locale}}","mode":"replace"}]}]},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/asset-families/user_guides"}},"code":"user_guides","labels":{"en_US":"User guides","fr_FR":"Guides utilisateur"},"product_link_rules":[{"product_selections":[{"field":"sku","operator":"=","value":"{{product_ref}}"}],"assign_assets_to":[{"attribute":"user_instructions","locale":"{{locale}}","mode":"replace"}]}]}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}}},"/api/rest/v1/asset-families/{code}":{"get":{"summary":"Get an asset family","operationId":"get_asset_family__code_","tags":["Asset family"],"x-versions":["3.2","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"description":"This endpoint allows you to get the information about a given asset family.","parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the asset family in JSON format.","schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Asset family code","x-immutable":true},"labels":{"type":"object","description":"Asset family labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Asset family label for the locale `localeCode`"}}},"attribute_as_main_media":{"type":"string","description":"Attribute code that is used as the main media of the asset family.","x-validation-rules":"It should be the code of an attribute that belongs to this family, and it must be a media file or a media link attribute type.","default":"First media file or media link attribute that was created"},"naming_convention":{"type":"object","description":"The naming convention ran over the asset code or the main media filename upon each asset creation, in order to automatically set several values in asset attributes. To learn more and see the format of this property, take a look at here.","x-validation-rules":"To know more about the validation of this property, take a look at our naming convention format.","default":{},"properties":{"source":{"type":"object","description":"The string on which the naming convention should be applied. More details here."},"pattern":{"type":"string","description":"The regular expression that should be applied on the source. More details here."},"abort_asset_creation_on_error":{"type":"boolean","description":"Whether the asset should be created if the naming convention failed to apply. More details here."}}},"product_link_rules":{"type":"array","description":"The rules that will be run after the asset creation, in order to automatically link the assets of this family to a set of products. To understand the format of this property, see here.","x-validation-rules":"To know more about the validation of this property, take a look at our product link rule format.","default":[],"items":{"type":"object","properties":{"product_selections":{"type":"array","description":"The product selection to which the assets of the asset family to be automatically linked. More details here.","items":{"type":"object","required":["field","operator","value"],"properties":{"field":{"type":"string"},"operator":{"type":"string"},"value":{"type":"string"},"locale":{"type":"string"},"channel":{"type":"string"}}}},"assign_assets_to":{"type":"array","description":"The product value in which your assets will be assigned. More details here.","items":{"type":"object","required":["attribute","mode"],"properties":{"attribute":{"type":"string"},"locale":{"type":"string"},"channel":{"type":"string"},"mode":{"type":"string"}}}}}}},"transformations":{"type":"array","description":"The transformations to perform on source files in order to generate new files into your asset attributes (only available since v4.0). To understand the format of this property, see here.","x-validation-rules":"To know more about the validation of this property, take a look at our transformation format.","x-from-version":"4.0","default":[],"items":{"type":"object","required":["label","target","source","operations"],"properties":{"label":{"type":"string","description":"The name of the transformation"},"filename_suffix":{"type":"string","description":"The suffix that will be appended to the source filename to generate the target filename. More details here."},"filename_prefix":{"type":"string","description":"The prefix that will be prepended to the source filename to generate the target filename. More details here."},"source":{"type":"object","required":["attribute","channel","locale"],"description":"The attribute value in which is stored the media file you want to use as the source file for your transformation. More details here.","properties":{"attribute":{"type":"string"},"channel":{"type":"string"},"locale":{"type":"string"}}},"target":{"type":"object","required":["attribute","channel","locale"],"description":"The attribute value in which the PIM will generate the new transformed file, aka the target file. More details here.","properties":{"attribute":{"type":"string"},"channel":{"type":"string"},"locale":{"type":"string"}}},"operations":{"type":"object","description":"The transformations that should be applied to your source file to generate the target file. More details here.","x-validation-rules":"Should contain at least one operation","properties":{"type":{"type":"string"},"parameters":{"type":"object","properties":{"colorspace":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"},"ratio":{"type":"integer"},"resolution-unit":{"type":"string"},"resolution-x":{"type":"integer"},"resolution-y":{"type":"integer"},"quality":{"type":"integer"}}}}}}}}},"example":{"code":"model_pictures","labels":{"en_US":"Model pictures","fr_FR":"Photographies en pied"},"attribute_as_main_media":"main_image","naming_convention":{"source":{"property":"code","channel":null,"locale":null},"pattern":"/(?P.*)-.*/","abort_asset_creation_on_error":true},"product_link_rules":[{"product_selections":[{"field":"sku","operator":"EQUALS","value":"{{product_ref}}"}],"assign_assets_to":[{"attribute":"model_pictures","mode":"replace"}]}],"transformations":[{"label":"Thumbnail plus black and white transformation","filename_suffix":"_thumbnailBW","source":{"attribute":"main_image","channel":null,"locale":null},"target":{"attribute":"thumbnail","channel":null,"locale":null},"operations":[{"type":"thumbnail","parameters":{"width":150,"height":150}},{"type":"colorspace","parameters":{"colorspace":"grey"}}]}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"patch":{"summary":"Update/create an asset family","operationId":"patch_asset_family__code_","tags":["Asset family"],"x-versions":["3.2","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"description":"This endpoint allows you to update a given asset family. Note that if the asset family does not already exist, it creates it.","parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"},{"name":"body","in":"body","required":true,"schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Asset family code","x-immutable":true},"labels":{"type":"object","description":"Asset family labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Asset family label for the locale `localeCode`"}}},"attribute_as_main_media":{"type":"string","description":"Attribute code that is used as the main media of the asset family.","x-validation-rules":"It should be the code of an attribute that belongs to this family, and it must be a media file or a media link attribute type.","default":"First media file or media link attribute that was created"},"naming_convention":{"type":"object","description":"The naming convention ran over the asset code or the main media filename upon each asset creation, in order to automatically set several values in asset attributes. To learn more and see the format of this property, take a look at here.","x-validation-rules":"To know more about the validation of this property, take a look at our naming convention format.","default":{},"properties":{"source":{"type":"object","description":"The string on which the naming convention should be applied. More details here."},"pattern":{"type":"string","description":"The regular expression that should be applied on the source. More details here."},"abort_asset_creation_on_error":{"type":"boolean","description":"Whether the asset should be created if the naming convention failed to apply. More details here."}}},"product_link_rules":{"type":"array","description":"The rules that will be run after the asset creation, in order to automatically link the assets of this family to a set of products. To understand the format of this property, see here.","x-validation-rules":"To know more about the validation of this property, take a look at our product link rule format.","default":[],"items":{"type":"object","properties":{"product_selections":{"type":"array","description":"The product selection to which the assets of the asset family to be automatically linked. More details here.","items":{"type":"object","required":["field","operator","value"],"properties":{"field":{"type":"string"},"operator":{"type":"string"},"value":{"type":"string"},"locale":{"type":"string"},"channel":{"type":"string"}}}},"assign_assets_to":{"type":"array","description":"The product value in which your assets will be assigned. More details here.","items":{"type":"object","required":["attribute","mode"],"properties":{"attribute":{"type":"string"},"locale":{"type":"string"},"channel":{"type":"string"},"mode":{"type":"string"}}}}}}},"transformations":{"type":"array","description":"The transformations to perform on source files in order to generate new files into your asset attributes (only available since v4.0). To understand the format of this property, see here.","x-validation-rules":"To know more about the validation of this property, take a look at our transformation format.","x-from-version":"4.0","default":[],"items":{"type":"object","required":["label","target","source","operations"],"properties":{"label":{"type":"string","description":"The name of the transformation"},"filename_suffix":{"type":"string","description":"The suffix that will be appended to the source filename to generate the target filename. More details here."},"filename_prefix":{"type":"string","description":"The prefix that will be prepended to the source filename to generate the target filename. More details here."},"source":{"type":"object","required":["attribute","channel","locale"],"description":"The attribute value in which is stored the media file you want to use as the source file for your transformation. More details here.","properties":{"attribute":{"type":"string"},"channel":{"type":"string"},"locale":{"type":"string"}}},"target":{"type":"object","required":["attribute","channel","locale"],"description":"The attribute value in which the PIM will generate the new transformed file, aka the target file. More details here.","properties":{"attribute":{"type":"string"},"channel":{"type":"string"},"locale":{"type":"string"}}},"operations":{"type":"object","description":"The transformations that should be applied to your source file to generate the target file. More details here.","x-validation-rules":"Should contain at least one operation","properties":{"type":{"type":"string"},"parameters":{"type":"object","properties":{"colorspace":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"},"ratio":{"type":"integer"},"resolution-unit":{"type":"string"},"resolution-x":{"type":"integer"},"resolution-y":{"type":"integer"},"quality":{"type":"integer"}}}}}}}}},"example":{"code":"model_pictures","labels":{"en_US":"Model pictures","fr_FR":"Photographies en pied"},"attribute_as_main_media":"main_image","naming_convention":{"source":{"property":"code","channel":null,"locale":null},"pattern":"/(?P.*)-.*/","abort_asset_creation_on_error":true},"product_link_rules":[{"product_selections":[{"field":"sku","operator":"EQUALS","value":"{{product_ref}}"}],"assign_assets_to":[{"attribute":"model_pictures","mode":"replace"}]}],"transformations":[{"label":"Thumbnail plus black and white transformation","filename_suffix":"_thumbnailBW","source":{"attribute":"main_image","channel":null,"locale":null},"target":{"attribute":"thumbnail","channel":null,"locale":null},"operations":[{"type":"thumbnail","parameters":{"width":150,"height":150}},{"type":"colorspace","parameters":{"colorspace":"grey"}}]}]}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"204":{"description":"No content to return","x-details":"Means that the update was successful","headers":{"Location":{"description":"URI of the updated resource","type":"string"}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/asset-families/{asset_family_code}/attributes":{"get":{"summary":"Get the list of attributes of a given asset family","operationId":"get_asset_families__code__attributes","description":"This endpoint allows you to get the list of attributes of a given asset family.","tags":["Asset attribute"],"x-versions":["3.2","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"parameters":[{"name":"asset_family_code","in":"path","description":"Code of the asset family","required":true,"type":"string"}],"responses":{"200":{"description":"Return the attributes of the given asset family","x-no-entity":true,"schema":{"type":"array","items":{"type":"object","required":["code","type","media_type"],"properties":{"code":{"type":"string","description":"Attribute code","x-immutable":true},"labels":{"type":"object","description":"Attribute labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute label for the locale `localeCode`"}}},"type":{"type":"string","description":"Attribute type. See type section for more details.","enum":["text","media_link","number","media_file","single_option","multiple_options","boolean","date","record"],"x-immutable":true},"value_per_locale":{"type":"boolean","description":"Whether the attribute is localizable, i.e. can have one value by locale","default":false,"x-immutable":true},"value_per_channel":{"type":"boolean","description":"Whether the attribute is scopable, i.e. can have one value by channel","default":false,"x-immutable":true},"is_required_for_completeness":{"type":"boolean","description":"Whether the attribute should be part of the record's completeness calculation","default":false},"is_read_only":{"type":"boolean","description":"Whether the attribute should be in read only mode only in the UI, but you can still update it with the API","default":false},"max_characters":{"type":"integer","description":"Maximum number of characters allowed for the value of the attribute when the attribute type is `text`","x-warning":"Only for `text` attribute type"},"is_textarea":{"type":"boolean","description":"Whether the UI should display a text area instead of a simple field when the attribute type is `text`","default":false,"x-warning":"Only for `text` attribute type"},"is_rich_text_editor":{"type":"boolean","description":"Whether the UI should display a rich text editor instead of a simple text area when the attribute type is `text`","x-validation-rules":"Required when the property `is_textarea` is equal to `true`","x-warning":"Only for `text` attribute type"},"validation_rule":{"type":"string","description":"Validation rule type used to validate the attribute value when the attribute type is `text`","default":"none","x-warning":"Only for `text` attribute type","enum":["email","url","regexp","none"]},"validation_regexp":{"type":"string","description":"Regexp expression used to validate the attribute value when the attribute type is `text`","default":null,"x-validation-rules":"Required when the property `validation_rule` is equal to `regexp`","x-warning":"Only for `text` attribute type"},"allowed_extensions":{"type":"array","description":"Extensions allowed when the attribute type is `media_file`","default":[],"x-warning":"Only for `media_file` attribute type","items":{"type":"string"}},"max_file_size":{"type":"string","description":"Max file size in MB when the attribute type is `media_file`","default":null,"x-warning":"Only for `media_file` attribute type"},"decimals_allowed":{"type":"boolean","description":"Whether decimals are allowed when the attribute type is `number`","default":false,"x-warning":"Only for `number` attribute type"},"min_value":{"type":"string","description":"Minimum value allowed when the attribute type is `number`","default":null,"x-validation-rules":"The minimum value must be lower than the maximum value","x-warning":"Only for `number` attribute type"},"max_value":{"type":"string","description":"Maximum value allowed when the attribute type is `number`","default":null,"x-validation-rules":"The maximum value must be greater than the minimum value","x-warning":"Only for `number` attribute type"},"media_type":{"type":"string","description":"For the `media_link` attribute type, it is the type of the media behind the url, to allow its preview in the PIM. For the `media_file` attribute type, it is the type of the file.","enum":["image","pdf","youtube","vimeo","other"],"x-warning":"Only required for `media_link` and `media_file` attribute types"},"prefix":{"type":"string","description":"Prefix of the `media_link` attribute type. The common url root that prefixes the link to the media","default":null,"x-warning":"Only for `media_link` attribute type"},"suffix":{"type":"string","description":"Suffix of the `media_link` attribute type. The common url suffix for the media","default":null,"x-warning":"Only for `media_link` attribute type"},"reference_entity":{"type":"string","description":"Reference entity code for the `record` attribute type (see Reference entity).","default":null,"x-warning":"Only for `record` attribute type","x-from-version":"SaaS"}},"example":{"code":"model_is_wearing_size","labels":{"en_US":"Model is wearing size","fr_FR":"Le mannequin porte la taille"},"type":"single_option","value_per_locale":false,"value_per_channel":false,"is_required_for_completeness":true}}},"x-examples":[{"code":"model_is_wearing_size","labels":{"en_US":"Model is wearing size","fr_FR":"Le mannequin porte la taille"},"type":"single_option","value_per_locale":false,"value_per_channel":false,"is_required_for_completeness":true},{"code":"media_link","labels":{"en_US":"Media link","fr_FR":"Lien vers le média"},"type":"media_link","value_per_locale":false,"value_per_channel":false,"is_required_for_completeness":true,"prefix":"https://my-dam.com/","suffix":"?height=630&width=485","media_type":"image"},{"code":"warning_mention","labels":{"en_US":"Warning mention","fr_FR":"Phrase d'avertissement"},"type":"text","value_per_locale":true,"value_per_channel":false,"is_required_for_completeness":false,"max_characters":"50","is_textarea":false,"is_rich_text_editor":false,"validation_rule":"none","validation_regexp":null}]},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}}},"/api/rest/v1/asset-families/{asset_family_code}/attributes/{code}":{"get":{"summary":"Get an attribute of a given asset family","operationId":"get_asset_family_attributes__code_","tags":["Asset attribute"],"x-versions":["3.2","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"description":"This endpoint allows you to get the information about a given attribute for a given asset family.","parameters":[{"name":"asset_family_code","in":"path","description":"Code of the asset family","required":true,"type":"string"},{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the asset attribute in JSON format","schema":{"type":"object","required":["code","type","media_type"],"properties":{"code":{"type":"string","description":"Attribute code","x-immutable":true},"labels":{"type":"object","description":"Attribute labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute label for the locale `localeCode`"}}},"type":{"type":"string","description":"Attribute type. See type section for more details.","enum":["text","media_link","number","media_file","single_option","multiple_options","boolean","date","record"],"x-immutable":true},"value_per_locale":{"type":"boolean","description":"Whether the attribute is localizable, i.e. can have one value by locale","default":false,"x-immutable":true},"value_per_channel":{"type":"boolean","description":"Whether the attribute is scopable, i.e. can have one value by channel","default":false,"x-immutable":true},"is_required_for_completeness":{"type":"boolean","description":"Whether the attribute should be part of the record's completeness calculation","default":false},"is_read_only":{"type":"boolean","description":"Whether the attribute should be in read only mode only in the UI, but you can still update it with the API","default":false},"max_characters":{"type":"integer","description":"Maximum number of characters allowed for the value of the attribute when the attribute type is `text`","x-warning":"Only for `text` attribute type"},"is_textarea":{"type":"boolean","description":"Whether the UI should display a text area instead of a simple field when the attribute type is `text`","default":false,"x-warning":"Only for `text` attribute type"},"is_rich_text_editor":{"type":"boolean","description":"Whether the UI should display a rich text editor instead of a simple text area when the attribute type is `text`","x-validation-rules":"Required when the property `is_textarea` is equal to `true`","x-warning":"Only for `text` attribute type"},"validation_rule":{"type":"string","description":"Validation rule type used to validate the attribute value when the attribute type is `text`","default":"none","x-warning":"Only for `text` attribute type","enum":["email","url","regexp","none"]},"validation_regexp":{"type":"string","description":"Regexp expression used to validate the attribute value when the attribute type is `text`","default":null,"x-validation-rules":"Required when the property `validation_rule` is equal to `regexp`","x-warning":"Only for `text` attribute type"},"allowed_extensions":{"type":"array","description":"Extensions allowed when the attribute type is `media_file`","default":[],"x-warning":"Only for `media_file` attribute type","items":{"type":"string"}},"max_file_size":{"type":"string","description":"Max file size in MB when the attribute type is `media_file`","default":null,"x-warning":"Only for `media_file` attribute type"},"decimals_allowed":{"type":"boolean","description":"Whether decimals are allowed when the attribute type is `number`","default":false,"x-warning":"Only for `number` attribute type"},"min_value":{"type":"string","description":"Minimum value allowed when the attribute type is `number`","default":null,"x-validation-rules":"The minimum value must be lower than the maximum value","x-warning":"Only for `number` attribute type"},"max_value":{"type":"string","description":"Maximum value allowed when the attribute type is `number`","default":null,"x-validation-rules":"The maximum value must be greater than the minimum value","x-warning":"Only for `number` attribute type"},"media_type":{"type":"string","description":"For the `media_link` attribute type, it is the type of the media behind the url, to allow its preview in the PIM. For the `media_file` attribute type, it is the type of the file.","enum":["image","pdf","youtube","vimeo","other"],"x-warning":"Only required for `media_link` and `media_file` attribute types"},"prefix":{"type":"string","description":"Prefix of the `media_link` attribute type. The common url root that prefixes the link to the media","default":null,"x-warning":"Only for `media_link` attribute type"},"suffix":{"type":"string","description":"Suffix of the `media_link` attribute type. The common url suffix for the media","default":null,"x-warning":"Only for `media_link` attribute type"},"reference_entity":{"type":"string","description":"Reference entity code for the `record` attribute type (see Reference entity).","default":null,"x-warning":"Only for `record` attribute type","x-from-version":"SaaS"}},"example":{"code":"model_is_wearing_size","labels":{"en_US":"Model is wearing size","fr_FR":"Le mannequin porte la taille"},"type":"single_option","value_per_locale":false,"value_per_channel":false,"is_required_for_completeness":true}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"patch":{"summary":"Update/create an attribute of a given asset family","operationId":"patch_asset_family_attributes__code_","tags":["Asset attribute"],"x-versions":["3.2","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"description":"This endpoint allows you to update a given attribute for a given asset family. Note that if the attribute does not already exist for the given asset family, it creates it.","parameters":[{"name":"asset_family_code","in":"path","description":"Code of the asset family","required":true,"type":"string"},{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"},{"name":"body","in":"body","required":true,"schema":{"type":"object","required":["code","type","media_type"],"properties":{"code":{"type":"string","description":"Attribute code","x-immutable":true},"labels":{"type":"object","description":"Attribute labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute label for the locale `localeCode`"}}},"type":{"type":"string","description":"Attribute type. See type section for more details.","enum":["text","media_link","number","media_file","single_option","multiple_options","boolean","date","record"],"x-immutable":true},"value_per_locale":{"type":"boolean","description":"Whether the attribute is localizable, i.e. can have one value by locale","default":false,"x-immutable":true},"value_per_channel":{"type":"boolean","description":"Whether the attribute is scopable, i.e. can have one value by channel","default":false,"x-immutable":true},"is_required_for_completeness":{"type":"boolean","description":"Whether the attribute should be part of the record's completeness calculation","default":false},"is_read_only":{"type":"boolean","description":"Whether the attribute should be in read only mode only in the UI, but you can still update it with the API","default":false},"max_characters":{"type":"integer","description":"Maximum number of characters allowed for the value of the attribute when the attribute type is `text`","x-warning":"Only for `text` attribute type"},"is_textarea":{"type":"boolean","description":"Whether the UI should display a text area instead of a simple field when the attribute type is `text`","default":false,"x-warning":"Only for `text` attribute type"},"is_rich_text_editor":{"type":"boolean","description":"Whether the UI should display a rich text editor instead of a simple text area when the attribute type is `text`","x-validation-rules":"Required when the property `is_textarea` is equal to `true`","x-warning":"Only for `text` attribute type"},"validation_rule":{"type":"string","description":"Validation rule type used to validate the attribute value when the attribute type is `text`","default":"none","x-warning":"Only for `text` attribute type","enum":["email","url","regexp","none"]},"validation_regexp":{"type":"string","description":"Regexp expression used to validate the attribute value when the attribute type is `text`","default":null,"x-validation-rules":"Required when the property `validation_rule` is equal to `regexp`","x-warning":"Only for `text` attribute type"},"allowed_extensions":{"type":"array","description":"Extensions allowed when the attribute type is `media_file`","default":[],"x-warning":"Only for `media_file` attribute type","items":{"type":"string"}},"max_file_size":{"type":"string","description":"Max file size in MB when the attribute type is `media_file`","default":null,"x-warning":"Only for `media_file` attribute type"},"decimals_allowed":{"type":"boolean","description":"Whether decimals are allowed when the attribute type is `number`","default":false,"x-warning":"Only for `number` attribute type"},"min_value":{"type":"string","description":"Minimum value allowed when the attribute type is `number`","default":null,"x-validation-rules":"The minimum value must be lower than the maximum value","x-warning":"Only for `number` attribute type"},"max_value":{"type":"string","description":"Maximum value allowed when the attribute type is `number`","default":null,"x-validation-rules":"The maximum value must be greater than the minimum value","x-warning":"Only for `number` attribute type"},"media_type":{"type":"string","description":"For the `media_link` attribute type, it is the type of the media behind the url, to allow its preview in the PIM. For the `media_file` attribute type, it is the type of the file.","enum":["image","pdf","youtube","vimeo","other"],"x-warning":"Only required for `media_link` and `media_file` attribute types"},"prefix":{"type":"string","description":"Prefix of the `media_link` attribute type. The common url root that prefixes the link to the media","default":null,"x-warning":"Only for `media_link` attribute type"},"suffix":{"type":"string","description":"Suffix of the `media_link` attribute type. The common url suffix for the media","default":null,"x-warning":"Only for `media_link` attribute type"},"reference_entity":{"type":"string","description":"Reference entity code for the `record` attribute type (see Reference entity).","default":null,"x-warning":"Only for `record` attribute type","x-from-version":"SaaS"}},"example":{"code":"model_is_wearing_size","labels":{"en_US":"Model is wearing size","fr_FR":"Le mannequin porte la taille"},"type":"single_option","value_per_locale":false,"value_per_channel":false,"is_required_for_completeness":true}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"204":{"description":"No content to return","x-details":"Means that the update was successful","headers":{"Location":{"description":"URI of the updated resource","type":"string"}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/asset-families/{asset_family_code}/attributes/{attribute_code}/options":{"get":{"summary":"Get a list of attribute options of a given attribute for a given asset family","operationId":"get_asset_family_attributes__attribute_code__options","description":"This endpoint allows you to get a list of attribute options for a given asset family.","tags":["Asset attribute option"],"x-versions":["3.2","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"parameters":[{"name":"asset_family_code","in":"path","description":"Code of the asset family","required":true,"type":"string"},{"name":"attribute_code","in":"path","description":"Code of the attribute","required":true,"type":"string"}],"responses":{"200":{"description":"Return the options of the given attribute of the given asset family","x-no-entity":true,"schema":{"type":"array","items":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Attribute's option code","x-immutable":true},"labels":{"type":"object","description":"Attribute labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute label for the locale `localeCode`"}}}},"example":{"code":"small","labels":{"en_US":"S","fr_FR":"S"}}}},"x-examples":[{"code":"unique_size","labels":{"en_US":"Unique size","fr_FR":"Taille unique"}},{"code":"size_27","labels":{"en_US":"Size 27","fr_FR":"Taille 36"}},{"code":"small","labels":{"en_US":"S","fr_FR":"S"}}]},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}}},"/api/rest/v1/asset-families/{asset_family_code}/attributes/{attribute_code}/options/{code}":{"get":{"summary":"Get an attribute option for a given attribute of a given asset family","operationId":"get_asset_attributes__attribute_code__options__code_","description":"This endpoint allows you to get the information about a given asset attribute option.","tags":["Asset attribute option"],"x-versions":["3.2","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"parameters":[{"name":"asset_family_code","in":"path","description":"Code of the asset family","required":true,"type":"string"},{"name":"attribute_code","in":"path","description":"Code of the attribute","required":true,"type":"string"},{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the asset attribute option in JSON format","schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Attribute's option code","x-immutable":true},"labels":{"type":"object","description":"Attribute labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute label for the locale `localeCode`"}}}},"example":{"code":"small","labels":{"en_US":"S","fr_FR":"S"}}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"patch":{"summary":"Update/create an asset attribute option for a given asset family","operationId":"patch_asset_attributes__attribute_code__options__code_","tags":["Asset attribute option"],"x-versions":["3.2","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"description":"This endpoint allows you to update a given option for a given attribute and a given asset family. Learn more about the Update behavior. Note that if the option does not already exist for the given attribute of the given asset family, it creates it.","parameters":[{"name":"asset_family_code","in":"path","description":"Code of the asset family","required":true,"type":"string"},{"name":"attribute_code","in":"path","description":"Code of the attribute","required":true,"type":"string"},{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"},{"name":"body","in":"body","required":true,"schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Attribute's option code","x-immutable":true},"labels":{"type":"object","description":"Attribute labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute label for the locale `localeCode`"}}}},"example":{"code":"small","labels":{"en_US":"S","fr_FR":"S"}}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"204":{"description":"No content to return","x-details":"Means that the update was successful","headers":{"Location":{"description":"URI of the updated resource","type":"string"}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/asset-media-files":{"post":{"summary":"Create a new media file for an asset","operationId":"post_asset_media_files","description":"This endpoint allows you to create a new media file and associate it to a media file attribute value of an asset.","tags":["Asset media file"],"x-versions":["3.2","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"parameters":[{"name":"Content-type","in":"header","type":"string","description":"Equal to 'multipart/form-data', no other value allowed","required":true},{"name":"body","in":"body","x-form-data":true,"schema":{"required":["file"],"properties":{"file":{"type":"string","description":"The binary of the media file","format":"binary"}}}}],"responses":{"201":{"description":"Created","x-details":"Means that the media file creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"},"Asset-media-file-code":{"description":"Code of the media file","type":"string"}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `multipart/form-data`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘multipart/form-data’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/asset-media-files/{code}":{"get":{"summary":"Download the media file associated to an asset","operationId":"get_asset_media_files__code","description":"This endpoint allows you to download a given media file that is associated with an asset.","x-content-type":"Mime-type of the media file","tags":["Asset media file"],"x-versions":["3.2","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the binary of the media file","x-content-type":"Mime-type of the media file"},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}}}}},"/api/rest/v1/asset-families/{asset_family_code}/assets":{"get":{"summary":"Get the list of the assets of a given asset family","operationId":"get_assets","tags":["Asset"],"x-versions":["3.2","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"description":"This endpoint allows you to get a list of assets of a given asset family. Assets are paginated. This endpoint is case sensitive on the asset family code.","parameters":[{"name":"search","in":"query","description":"Filter assets, for more details see the Asset filters section","required":false,"type":"string"},{"name":"channel","in":"query","type":"string","description":"Filter asset values to return scopable asset attributes for the given channel as well as the non localizable/non scopable asset attributes, for more details see the Filter asset values by channel section","required":false},{"name":"locales","in":"query","type":"string","description":"Filter asset values to return localizable attributes for the given locales as well as the non localizable/non scopable asset attributes, for more details see the Filter asset values by locale section","required":false},{"name":"asset_family_code","in":"path","description":"Code of the asset family","required":true,"type":"string"},{"name":"search_after","in":"query","description":"Cursor when using the `search_after` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"string","default":"cursor to the first page"}],"responses":{"200":{"description":"Return the assets of the given asset family paginated","schema":{"title":"Asset","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}}}},{"properties":{"_embedded":{"type":"object","properties":{"_items":{"type":"array","items":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Code of the asset","x-immutable":true},"values":{"type":"object","description":"Asset attributes values, see the Focus on the asset values section for more details.","x-validation-rules":"Validation rules detailed in Asset attribute values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","description":"Channel code of the asset attribute value"},"locale":{"type":"string","description":"Locale code of the asset attribute value"},"data":{"type":"object","description":"Asset attribute value. See the `data` format section for more details."},"_links":{"type":"object","description":"Related links for the `media file` attribute values. See the `_links` format section for more details.","x-validation-rules":"The share link is returned for the **main** `media file` attribute when asset sharing is enabled"},"linked_data":{"type":"object","description":"Linked data for the `media link` attribute values. See the `linked_data` format section for more details.","x-from-version":"SaaS"}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true,"x-from-version":"6.0"},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true,"x-from-version":"6.0"}},"example":{"code":"sku_54628_picture1","values":{"media_preview":[{"locale":null,"channel":null,"data":"sku_54628_picture1.jpg"}],"model_wears_size":[{"locale":null,"channel":null,"data":"s"}],"photographer":[{"locale":null,"channel":null,"data":"ben_levy"}],"main_colors":[{"locale":null,"channel":null,"data":["red","purple"]}],"end_of_use_date":[{"locale":null,"channel":null,"data":"02/03/2021"}]},"created":"2021-05-31T09:23:34+00:00","updated":"2021-05-31T09:23:34+00:00"}}]}}}}}}]},"examples":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/asset-families/model_pictures/assets"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/asset-families/model_pictures/assets"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/asset-families/model_pictures/assets?search_after=2x088w%3D%3D"}},"_embedded":{"_items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/asset-families/model_pictures/assets/allie_jean_model_picture"}},"code":"allie_jean_model_picture","values":{"media_file":[{"locale":null,"channel":null,"data":"0/0/9/d/009d38fe8c97e16f6b48bbf8f6cf8a9564401cc9_allie_jean_model_picture.png","_links":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/asset-media-files/0/0/9/d/009d38fe8c97e16f6b48bbf8f6cf8a9564401cc9_allie_jean_model_picture.png"},"share_link":{"href":"https://demo.asset.akeneo.com/model_pictures/allie_jean_model_picture.png"}}}],"media_link":[{"locale":null,"channel":null,"data":"allie_jean_model_picture.png","linked_data":{"full_url":"https://example.com/allie_jean_model_picture.png","prefix":"https://example.com/","suffix":null}}],"model_is_wearing_size":[{"locale":null,"channel":null,"data":"size_27"}],"warning_mention":[{"data":"Photo not retouched","locale":"en_US","channel":null},{"data":"Photo non retouchée","locale":"fr_FR","channel":null}]},"created":"2021-05-31T09:23:34+00:00","updated":"2021-05-31T09:23:34+00:00"},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/asset-families/model_pictures/assets/amy_socks_model_picture"}},"code":"amy_socks_model_picture","values":{"media_file":[{"locale":null,"channel":null,"data":"0/0/9/d/009d38fe8c97e16f6b48bbf8f6cf8a9564401cc9_amy_socks_model_picture.png","_links":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/asset-media-files/0/0/9/d/009d38fe8c97e16f6b48bbf8f6cf8a9564401cc9_amy_socks_model_picture.png"},"share_link":{"href":"https://demo.asset.akeneo.com/model_pictures/amy_socks_model_picture.jpg"}}}],"media_link":[{"locale":null,"channel":null,"data":"amy_socks_model_picture.png","linked_data":{"full_url":"https://example.com/amy_socks_model_picture.png","prefix":"https://example.com/","suffix":null}}],"model_is_wearing_size":[{"locale":null,"channel":null,"data":"unique_size"}],"warning_mention":[{"data":"Photo not retouched","locale":"en_US","channel":null},{"data":"Photo non retouchée","locale":"fr_FR","channel":null}]},"created":"2021-05-31T09:23:34+00:00","updated":"2021-05-31T09:23:34+00:00"},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/asset-families/model_pictures/assets/alice_blouse_model_picture"}},"code":"alice_blouse_model_picture","values":{"media_file":[{"locale":null,"channel":null,"data":"0/0/9/d/009d38fe8c97e16f6b48bbf8f6cf8a9564401cc9_alice_blouse_model_picture.png","_links":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/asset-media-files/0/0/9/d/009d38fe8c97e16f6b48bbf8f6cf8a9564401cc9_alice_blouse_model_picture.png"},"share_link":{"href":"https://demo.asset.akeneo.com/model_pictures/alice_blouse_model_picture.png"}}}],"media_link":[{"locale":null,"channel":null,"data":"alice_blouse_model_picture.png","linked_data":{"full_url":"https://example.com/alice_blouse_model_picture.png","prefix":"https://example.com/","suffix":null}}],"model_is_wearing_size":[{"locale":null,"channel":null,"data":"small"}],"warning_mention":[{"data":"Photo retouched","locale":"en_US","channel":null},{"data":"Photo non retouchée","locale":"fr_FR","channel":null}]},"created":"2021-05-31T09:23:34+00:00","updated":"2021-05-31T09:23:34+00:00"}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"patch":{"summary":"Update/create several assets","operationId":"patch_assets","tags":["Asset"],"x-versions":["3.2","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"description":"This endpoint allows you to update and/or create several assets of one given asset family at once. Learn more about the Update behavior. Note that if the asset does not already exist for the given asset family, it creates it. This endpoint is case sensitive on the asset family code.","parameters":[{"name":"asset_family_code","in":"path","description":"Code of the asset family","required":true,"type":"string"},{"name":"body","in":"body","required":true,"schema":{"type":"array","items":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Code of the asset","x-immutable":true},"values":{"type":"object","description":"Asset attributes values, see the Focus on the asset values section for more details.","x-validation-rules":"Validation rules detailed in Asset attribute values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","description":"Channel code of the asset attribute value"},"locale":{"type":"string","description":"Locale code of the asset attribute value"},"data":{"type":"object","description":"Asset attribute value. See the `data` format section for more details."},"_links":{"type":"object","description":"Related links for the `media file` attribute values. See the `_links` format section for more details.","x-validation-rules":"The share link is returned for the **main** `media file` attribute when asset sharing is enabled"},"linked_data":{"type":"object","description":"Linked data for the `media link` attribute values. See the `linked_data` format section for more details.","x-from-version":"SaaS"}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true,"x-from-version":"6.0"},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true,"x-from-version":"6.0"}},"example":{"code":"sku_54628_picture1","values":{"media_preview":[{"locale":null,"channel":null,"data":"sku_54628_picture1.jpg"}],"model_wears_size":[{"locale":null,"channel":null,"data":"s"}],"photographer":[{"locale":null,"channel":null,"data":"ben_levy"}],"main_colors":[{"locale":null,"channel":null,"data":["red","purple"]}],"end_of_use_date":[{"locale":null,"channel":null,"data":"02/03/2021"}]},"created":"2021-05-31T09:23:34+00:00","updated":"2021-05-31T09:23:34+00:00"}},"example":[{"code":"sku_54628_picture1","values":{"media_preview":[{"locale":null,"channel":null,"data":"sku_54628_picture1.jpg"}],"model_wears_size":[{"locale":null,"channel":null,"data":"s"}],"photographer":[{"locale":null,"channel":null,"data":"ben_levy"}],"main_colors":[{"locale":null,"channel":null,"data":["red","purple"]}],"end_of_use_date":[{"locale":null,"channel":null,"data":"02/03/2021"}]},"created":"2021-05-31T09:23:34+00:00","updated":"2021-05-31T09:23:34+00:00"},{"code":"sku_54628_picture2","values":{"media_preview":[{"locale":null,"channel":null,"data":"sku_54628_picture2.jpg"}],"model_wears_size":[{"locale":null,"channel":null,"data":"s"}],"photographer":[{"locale":null,"channel":null,"data":"ben_levy"}],"main_colors":[{"locale":null,"channel":null,"data":["blue","white"]}],"end_of_use_date":[{"locale":null,"channel":null,"data":"02/03/2021"}]},"created":"2021-05-31T09:23:34+00:00","updated":"2021-05-31T09:23:34+00:00"},{"code":"sku_54628_picture3","values":{"media_preview":[{"locale":null,"channel":null,"data":"sku_54628_picture3.jpg"}],"model_wears_size":[{"locale":null,"channel":null,"data":"s"}],"photographer":[{"locale":null,"channel":null,"data":"ben_levy"}],"main_colors":[{"locale":null,"channel":null,"data":["purple"]}],"end_of_use_date":[{"locale":null,"channel":null,"data":"02/03/2021"}]},"created":"2021-05-31T09:23:34+00:00","updated":"2021-05-31T09:23:34+00:00"}]}}],"responses":{"200":{"description":"OK","x-details":"Returns an JSON array in which each object gives you the status of each asset creation or update","x-no-entity":true,"schema":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Resource code"},"status_code":{"type":"integer","description":"HTTP status code, see Client errors to understand the meaning of each code"},"message":{"type":"string","description":"Message explaining the error"}}}},"x-examples":[{"code":"sku_54628_picture1","status_code":204},{"code":"sku_54628_picture2","status_code":422,"message":"Property 'group' does not exist."},{"code":"sku_54628_picture3","status_code":201}]},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"413":{"description":"Request Entity Too Large","x-details":"There are too many resources to process (max 100) or the line of JSON is too long (max 1 000 000 characters)","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":413,"message":"Too many resources to process, 100 is the maximum allowed."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/vnd.akeneo.collection+json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/vnd.akeneo.collection+json’ is allowed."}}}}},"/api/rest/v1/asset-families/{asset_family_code}/assets/{code}":{"get":{"summary":"Get an asset of a given asset family","operationId":"get_assets__code_","tags":["Asset"],"x-versions":["3.2","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"description":"This endpoint allows you to get the information about a given asset for a given asset family. This endpoint is case sensitive on the asset family code.","parameters":[{"name":"asset_family_code","in":"path","description":"Code of the asset family","required":true,"type":"string"},{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the asset in JSON standard format","schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Code of the asset","x-immutable":true},"values":{"type":"object","description":"Asset attributes values, see the Focus on the asset values section for more details.","x-validation-rules":"Validation rules detailed in Asset attribute values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","description":"Channel code of the asset attribute value"},"locale":{"type":"string","description":"Locale code of the asset attribute value"},"data":{"type":"object","description":"Asset attribute value. See the `data` format section for more details."},"_links":{"type":"object","description":"Related links for the `media file` attribute values. See the `_links` format section for more details.","x-validation-rules":"The share link is returned for the **main** `media file` attribute when asset sharing is enabled"},"linked_data":{"type":"object","description":"Linked data for the `media link` attribute values. See the `linked_data` format section for more details.","x-from-version":"SaaS"}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true,"x-from-version":"6.0"},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true,"x-from-version":"6.0"}},"example":{"code":"sku_54628_picture1","values":{"media_preview":[{"locale":null,"channel":null,"data":"sku_54628_picture1.jpg"}],"model_wears_size":[{"locale":null,"channel":null,"data":"s"}],"photographer":[{"locale":null,"channel":null,"data":"ben_levy"}],"main_colors":[{"locale":null,"channel":null,"data":["red","purple"]}],"end_of_use_date":[{"locale":null,"channel":null,"data":"02/03/2021"}]},"created":"2021-05-31T09:23:34+00:00","updated":"2021-05-31T09:23:34+00:00"}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"patch":{"summary":"Update/create an asset","operationId":"patch_asset__code_","tags":["Asset"],"x-versions":["3.2","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"description":"This endpoint allows you to update a given asset of a given asset family. Learn more about the Update behavior. Note that if the asset does not already exist for the given asset family, it creates it. This endpoint is case sensitive on the asset family code.","parameters":[{"name":"asset_family_code","in":"path","description":"Code of the asset family","required":true,"type":"string"},{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"},{"name":"body","in":"body","required":true,"schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Code of the asset","x-immutable":true},"values":{"type":"object","description":"Asset attributes values, see the Focus on the asset values section for more details.","x-validation-rules":"Validation rules detailed in Asset attribute values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","description":"Channel code of the asset attribute value"},"locale":{"type":"string","description":"Locale code of the asset attribute value"},"data":{"type":"object","description":"Asset attribute value. See the `data` format section for more details."},"_links":{"type":"object","description":"Related links for the `media file` attribute values. See the `_links` format section for more details.","x-validation-rules":"The share link is returned for the **main** `media file` attribute when asset sharing is enabled"},"linked_data":{"type":"object","description":"Linked data for the `media link` attribute values. See the `linked_data` format section for more details.","x-from-version":"SaaS"}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true,"x-from-version":"6.0"},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true,"x-from-version":"6.0"}},"example":{"code":"sku_54628_picture1","values":{"media_preview":[{"locale":null,"channel":null,"data":"sku_54628_picture1.jpg"}],"model_wears_size":[{"locale":null,"channel":null,"data":"s"}],"photographer":[{"locale":null,"channel":null,"data":"ben_levy"}],"main_colors":[{"locale":null,"channel":null,"data":["red","purple"]}],"end_of_use_date":[{"locale":null,"channel":null,"data":"02/03/2021"}]},"created":"2021-05-31T09:23:34+00:00","updated":"2021-05-31T09:23:34+00:00"}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"204":{"description":"No content to return","x-details":"Means that the update was successful","headers":{"Location":{"description":"URI of the updated resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}},"delete":{"summary":"Delete an asset","operationId":"delete_assets__code_","tags":["Asset"],"x-versions":["3.2","4.0","5.0","6.0","7.0","SaaS"],"x-ee":true,"description":"This endpoint allows you to delete a given asset. This endpoint is case sensitive on the asset family code.","parameters":[{"name":"asset_family_code","in":"path","description":"Code of the asset family","required":true,"type":"string"},{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"204":{"description":"No content to return","x-details":"Means that the deletion was successful"},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}}}}},"/api/rest/v1/assets":{"get":{"summary":"Get list of PAM assets","operationId":"get_pam_assets","description":"This endpoint allows you to get a list of PAM assets. PAM assets are paginated.","tags":["PAM asset"],"x-versions":["2.1","2.2","2.3","3.x"],"x-ee":true,"x-deprecated":true,"parameters":[{"name":"pagination_type","in":"query","description":"Pagination method type, see Pagination section","required":false,"type":"string","default":"page","x-validation-rules":"One of the following values","enum":["page","search_after"]},{"name":"page","in":"query","description":"Number of the page to retrieve when using the `page` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"integer","default":1},{"name":"search_after","in":"query","description":"Cursor when using the `search_after` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"string","default":"cursor to the first page"},{"name":"limit","in":"query","description":"Number of results by page, see Pagination section","required":false,"type":"integer","minimum":1,"maximum":100,"default":10},{"name":"with_count","in":"query","description":"Return the count of items in the response. Be carefull with that, on a big catalog, it can decrease performance in a significative way","default":false,"type":"boolean","required":false}],"responses":{"200":{"description":"Returns PAM assets paginated","schema":{"title":"PAM Assets","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"previous":{"type":"object","properties":{"href":{"type":"string","description":"URI of the previous page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}},"current_page":{"type":"integer","description":"Current page number"}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"PAM asset code","x-immutable":true},"categories":{"type":"array","description":"Codes of the PAM asset categories in which the asset is classified","x-validation-rules":"Each string of the array is equal to an existing asset category code","items":{"type":"string"},"default":[]},"description":{"type":"string","description":"Description of the PAM asset","default":null},"localizable":{"type":"boolean","description":"Whether the asset is localized or not, meaning if you want to have different reference files for each of your locale","default":false,"x-immutable":true},"tags":{"type":"array","description":"Tags of the PAM asset","items":{"type":"string"},"default":[]},"end_of_use":{"type":"string","description":"Date on which the PAM asset expire","format":"dateTime","default":null,"x-validation-rules":"The date follows the ISO 8601 format"},"variation_files":{"type":"array","description":"Variations of the PAM asset","x-read-only":true,"items":{"type":"object","properties":{"_link":{"type":"object","description":"Links to get and download the variation file","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the variation entity"}}},"download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the variation file"}}}}},"locale":{"type":"string","description":"Locale code of the variation"},"scope":{"type":"string","description":"Channel code of the variation"},"code":{"type":"string","description":"Code of the variation"}}}},"reference_files":{"type":"array","description":"Reference files of the PAM asset","x-read-only":true,"items":{"type":"object","properties":{"_link":{"type":"object","description":"Links to get and download the reference file","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the reference file entity"}}},"download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the reference file"}}}}},"locale":{"type":"string","description":"Locale code of the reference file"},"code":{"type":"string","description":"Code of the reference file"}}}}},"example":{"code":"tshirt_artemis_main_picture","categories":["tshirts_assets"],"description":"The main picture of the Artemis t-shirt","localizable":false,"tags":["tshirts","red","summer"],"end_of_use":"2019-09-01T00:00:00+0200","variation_files":[{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/ecommerce/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/ecommerce/no_locale"}},"locale":null,"scope":"e_commerce","code":"7/5/8/e/758e39d48va7b42a55001434fd3d7b6cf3189b7f_tshirt_artemis_main_picture_ecommerce.jpg"},{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/print/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/print/no_locale"}},"locale":null,"scope":"print","code":"7/5/8/e/759e39d48va7b42a55002434fd3d7b6cf3189b7f_tshirt_artemis_main_picture_print.jpg"}],"reference_files":[{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/reference-files/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/reference-files/no_locale"}},"locale":null,"code":"7/5/8/e/759e39d48va7b42a55002434fd3d7b6cf3189b7f_tshirt_artemis_main_picture.jpg"}]}}]}}}}}}]},"examples":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets?page=2&limit=3"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/assets?page=1&limit=3"},"previous":{"href":"https://demo.akeneo.com/api/rest/v1/assets?page=1&limit=3"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/assets?page=3&limit=3"}},"current_page":2,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture"}},"code":"tshirt_artemis_main_picture","categories":["tshirts_assets"],"description":"The main picture of the Artemis t-shirt","localizable":false,"tags":["tshirts","red","summer"],"end_of_use":"2019-09-01T00:00:00+0200","variation_files":[{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/ecommerce/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/ecommerce/no_locale"}},"locale":null,"scope":"e_commerce","code":"7/5/8/e/758e39d48va7b42a55001434fd3d7b6cf3189b7f_tshirt_artemis_main_picture_ecommerce.jpg"},{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/print/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/print/no_locale"}},"locale":null,"scope":"print","code":"7/5/8/e/759e39d48va7b42a55002434fd3d7b6cf3189b7f_tshirt_artemis_main_picture_print.jpg"}],"reference_files":[{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/reference-files/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/reference-files/no_locale"}},"locale":null,"code":"7/5/8/e/759e39d48va7b42a55002434fd3d7b6cf3189b7f_tshirt_artemis_main_picture.jpg"}]},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_profile_picture"}},"code":"tshirt_artemis_profile_picture","categories":["tshirts_assets"],"description":"The profile picture of the Artemis t-shirt","localizable":false,"tags":["tshirts","red","summer","profile_views"],"end_of_use":"2019-09-01T00:00:00+0200","variation_files":[{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_profile_picture/variation-files/ecommerce/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_profile_picture/variation-files/ecommerce/no_locale"}},"locale":null,"scope":"e_commerce","code":"7/5/8/e/758e39d48va7b42a55001434fd3d7b6cf3189b7f_tshirt_artemis_profile_picture_ecommerce.jpg"},{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_profile_picture/variation-files/print/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_profile_picture/variation-files/print/no_locale"}},"locale":null,"scope":"print","code":"7/5/8/e/759e39d48va7b42a55002434fd3d7b6cf3189b7f_tshirt_artemis_profile_picture_print.jpg"}],"reference_files":[{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_profile_picture/reference-files/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_profile_picture/reference-files/no_locale"}},"locale":null,"code":"7/5/8/e/759e39d48va7b42a55002434fd3d7b6cf3189b7f_tshirt_artemis_profile_picture.jpg"}]},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_maintenance_manual"}},"code":"tshirt_artemis_maintenance_manual","categories":["tshirts_assets"],"description":"The maintenance manual of the Artemis t-shirt","localizable":true,"tags":["tshirts","manuals"],"end_of_use":null,"variation_files":[],"reference_files":[{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_maintenance_manual/reference-files/en_US/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_maintenance_manual/reference-files/en_US"}},"locale":"en_US","code":"7/5/8/e/759e39d48va7b42a55002434fd3d7b6cf3189b7f_tshirt_artemis_maintenance_manual_en_US.pdf"},{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_maintenance_manual/reference-files/fr_FR/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_maintenance_manual/reference-files/fr_FR"}},"locale":"fr_FR","code":"7/5/8/e/759e39d48va7b42a55002434fd3d7b6cf3189b7f_tshirt_artemis_maintenance_manual_fr_FR.pdf"}]}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"post":{"summary":"Create a new PAM asset","operationId":"post_pam_assets","description":"This endpoint allows you to create a new PAM asset.","tags":["PAM asset"],"x-versions":["2.1","2.2","2.3","3.x"],"x-ee":true,"x-deprecated":true,"parameters":[{"name":"body","in":"body","schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"PAM asset code","x-immutable":true},"categories":{"type":"array","description":"Codes of the PAM asset categories in which the asset is classified","x-validation-rules":"Each string of the array is equal to an existing asset category code","items":{"type":"string"},"default":[]},"description":{"type":"string","description":"Description of the PAM asset","default":null},"localizable":{"type":"boolean","description":"Whether the asset is localized or not, meaning if you want to have different reference files for each of your locale","default":false,"x-immutable":true},"tags":{"type":"array","description":"Tags of the PAM asset","items":{"type":"string"},"default":[]},"end_of_use":{"type":"string","description":"Date on which the PAM asset expire","format":"dateTime","default":null,"x-validation-rules":"The date follows the ISO 8601 format"},"variation_files":{"type":"array","description":"Variations of the PAM asset","x-read-only":true,"items":{"type":"object","properties":{"_link":{"type":"object","description":"Links to get and download the variation file","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the variation entity"}}},"download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the variation file"}}}}},"locale":{"type":"string","description":"Locale code of the variation"},"scope":{"type":"string","description":"Channel code of the variation"},"code":{"type":"string","description":"Code of the variation"}}}},"reference_files":{"type":"array","description":"Reference files of the PAM asset","x-read-only":true,"items":{"type":"object","properties":{"_link":{"type":"object","description":"Links to get and download the reference file","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the reference file entity"}}},"download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the reference file"}}}}},"locale":{"type":"string","description":"Locale code of the reference file"},"code":{"type":"string","description":"Code of the reference file"}}}}},"example":{"code":"tshirt_artemis_main_picture","categories":["tshirts_assets"],"description":"The main picture of the Artemis t-shirt","localizable":false,"tags":["tshirts","red","summer"],"end_of_use":"2019-09-01T00:00:00+0200","variation_files":[{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/ecommerce/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/ecommerce/no_locale"}},"locale":null,"scope":"e_commerce","code":"7/5/8/e/758e39d48va7b42a55001434fd3d7b6cf3189b7f_tshirt_artemis_main_picture_ecommerce.jpg"},{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/print/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/print/no_locale"}},"locale":null,"scope":"print","code":"7/5/8/e/759e39d48va7b42a55002434fd3d7b6cf3189b7f_tshirt_artemis_main_picture_print.jpg"}],"reference_files":[{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/reference-files/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/reference-files/no_locale"}},"locale":null,"code":"7/5/8/e/759e39d48va7b42a55002434fd3d7b6cf3189b7f_tshirt_artemis_main_picture.jpg"}]}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}},"patch":{"summary":"Update/create several PAM assets","operationId":"patch_pam_assets","tags":["PAM asset"],"x-versions":["2.1","2.2","2.3","3.x"],"x-ee":true,"x-deprecated":true,"description":"This endpoint allows you to update several PAM assets at once.","x-body-by-line":"Contains several lines, each line is a PAM asset in JSON format","parameters":[{"name":"body","in":"body","schema":{"x-examples":{"x-example-1":"{\"code\":\"tshirt_aria_main_picture\",\"categories\":[\"tshirts_assets\"],\"tags\":[\"tshirts\", \"red\", \"summer\"]}","x-example-2":"{\"code\":\"tshirt_artemis_maintenance_manual\",\"categories\":[\"tshirts_assets\",\"short_sleeve\"]}","x-example-3":"{\"code\":\"tshirt_artemis_main_picture\",\"tags\":[\"tshirts\", \"red\", \"summer\",\"short_sleeve\"]}"},"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"PAM asset code","x-immutable":true},"categories":{"type":"array","description":"Codes of the PAM asset categories in which the asset is classified","x-validation-rules":"Each string of the array is equal to an existing asset category code","items":{"type":"string"},"default":[]},"description":{"type":"string","description":"Description of the PAM asset","default":null},"localizable":{"type":"boolean","description":"Whether the asset is localized or not, meaning if you want to have different reference files for each of your locale","default":false,"x-immutable":true},"tags":{"type":"array","description":"Tags of the PAM asset","items":{"type":"string"},"default":[]},"end_of_use":{"type":"string","description":"Date on which the PAM asset expire","format":"dateTime","default":null,"x-validation-rules":"The date follows the ISO 8601 format"},"variation_files":{"type":"array","description":"Variations of the PAM asset","x-read-only":true,"items":{"type":"object","properties":{"_link":{"type":"object","description":"Links to get and download the variation file","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the variation entity"}}},"download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the variation file"}}}}},"locale":{"type":"string","description":"Locale code of the variation"},"scope":{"type":"string","description":"Channel code of the variation"},"code":{"type":"string","description":"Code of the variation"}}}},"reference_files":{"type":"array","description":"Reference files of the PAM asset","x-read-only":true,"items":{"type":"object","properties":{"_link":{"type":"object","description":"Links to get and download the reference file","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the reference file entity"}}},"download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the reference file"}}}}},"locale":{"type":"string","description":"Locale code of the reference file"},"code":{"type":"string","description":"Code of the reference file"}}}}},"example":{"code":"tshirt_artemis_main_picture","categories":["tshirts_assets"],"description":"The main picture of the Artemis t-shirt","localizable":false,"tags":["tshirts","red","summer"],"end_of_use":"2019-09-01T00:00:00+0200","variation_files":[{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/ecommerce/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/ecommerce/no_locale"}},"locale":null,"scope":"e_commerce","code":"7/5/8/e/758e39d48va7b42a55001434fd3d7b6cf3189b7f_tshirt_artemis_main_picture_ecommerce.jpg"},{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/print/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/print/no_locale"}},"locale":null,"scope":"print","code":"7/5/8/e/759e39d48va7b42a55002434fd3d7b6cf3189b7f_tshirt_artemis_main_picture_print.jpg"}],"reference_files":[{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/reference-files/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/reference-files/no_locale"}},"locale":null,"code":"7/5/8/e/759e39d48va7b42a55002434fd3d7b6cf3189b7f_tshirt_artemis_main_picture.jpg"}]}}}],"responses":{"200":{"description":"OK","x-details":"Returns a plain text response whose lines are JSON containing the status of each update or creation","x-no-entity":true,"schema":{"type":"object","properties":{"line":{"type":"integer","description":"Line number"},"identifier":{"type":"string","description":"Resource identifier, only filled when the resource is a product"},"code":{"type":"string","description":"Resource code, only filled when the resource is not a product"},"status_code":{"type":"integer","description":"HTTP status code, see Client errors to understand the meaning of each code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"x-example-1":"{\"line\":1,\"code\":\"tshirt_aria_main_picture\",\"status_code\":201}","x-example-2":"{\"line\":2,\"code\":\"tshirt_artemis_maintenance_manual\",\"status_code\":422,\"message\":\"Category \"short_sleeve\" does not exist.\"}","x-example-3":"{\"line\":3,\"code\":\"tshirt_artemis_main_picture\",\"status_code\":204}"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"413":{"description":"Request Entity Too Large","x-details":"There are too many resources to process (max 100) or the line of JSON is too long (max 1 000 000 characters)","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":413,"message":"Too many resources to process, 100 is the maximum allowed."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/vnd.akeneo.collection+json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/vnd.akeneo.collection+json’ is allowed."}}}}},"/api/rest/v1/assets/{code}":{"get":{"summary":"Get a PAM asset","operationId":"get_pam_assets__code_","description":"This endpoint allows you to get the information about a given PAM asset.","tags":["PAM asset"],"x-versions":["2.1","2.2","2.3","3.x"],"x-ee":true,"x-deprecated":true,"parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the PAM asset in JSON format","schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"PAM asset code","x-immutable":true},"categories":{"type":"array","description":"Codes of the PAM asset categories in which the asset is classified","x-validation-rules":"Each string of the array is equal to an existing asset category code","items":{"type":"string"},"default":[]},"description":{"type":"string","description":"Description of the PAM asset","default":null},"localizable":{"type":"boolean","description":"Whether the asset is localized or not, meaning if you want to have different reference files for each of your locale","default":false,"x-immutable":true},"tags":{"type":"array","description":"Tags of the PAM asset","items":{"type":"string"},"default":[]},"end_of_use":{"type":"string","description":"Date on which the PAM asset expire","format":"dateTime","default":null,"x-validation-rules":"The date follows the ISO 8601 format"},"variation_files":{"type":"array","description":"Variations of the PAM asset","x-read-only":true,"items":{"type":"object","properties":{"_link":{"type":"object","description":"Links to get and download the variation file","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the variation entity"}}},"download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the variation file"}}}}},"locale":{"type":"string","description":"Locale code of the variation"},"scope":{"type":"string","description":"Channel code of the variation"},"code":{"type":"string","description":"Code of the variation"}}}},"reference_files":{"type":"array","description":"Reference files of the PAM asset","x-read-only":true,"items":{"type":"object","properties":{"_link":{"type":"object","description":"Links to get and download the reference file","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the reference file entity"}}},"download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the reference file"}}}}},"locale":{"type":"string","description":"Locale code of the reference file"},"code":{"type":"string","description":"Code of the reference file"}}}}},"example":{"code":"tshirt_artemis_main_picture","categories":["tshirts_assets"],"description":"The main picture of the Artemis t-shirt","localizable":false,"tags":["tshirts","red","summer"],"end_of_use":"2019-09-01T00:00:00+0200","variation_files":[{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/ecommerce/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/ecommerce/no_locale"}},"locale":null,"scope":"e_commerce","code":"7/5/8/e/758e39d48va7b42a55001434fd3d7b6cf3189b7f_tshirt_artemis_main_picture_ecommerce.jpg"},{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/print/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/print/no_locale"}},"locale":null,"scope":"print","code":"7/5/8/e/759e39d48va7b42a55002434fd3d7b6cf3189b7f_tshirt_artemis_main_picture_print.jpg"}],"reference_files":[{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/reference-files/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/reference-files/no_locale"}},"locale":null,"code":"7/5/8/e/759e39d48va7b42a55002434fd3d7b6cf3189b7f_tshirt_artemis_main_picture.jpg"}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"patch":{"summary":"Update/create a PAM asset","operationId":"patch_pam_assets__code_","tags":["PAM asset"],"x-versions":["2.1","2.2","2.3","3.x"],"x-ee":true,"x-deprecated":true,"description":"This endpoint allows you to update a given PAM asset. Know more about Update behavior. Note that if no asset exists for the given code, it creates it.","parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"},{"name":"body","in":"body","required":true,"schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"PAM asset code","x-immutable":true},"categories":{"type":"array","description":"Codes of the PAM asset categories in which the asset is classified","x-validation-rules":"Each string of the array is equal to an existing asset category code","items":{"type":"string"},"default":[]},"description":{"type":"string","description":"Description of the PAM asset","default":null},"localizable":{"type":"boolean","description":"Whether the asset is localized or not, meaning if you want to have different reference files for each of your locale","default":false,"x-immutable":true},"tags":{"type":"array","description":"Tags of the PAM asset","items":{"type":"string"},"default":[]},"end_of_use":{"type":"string","description":"Date on which the PAM asset expire","format":"dateTime","default":null,"x-validation-rules":"The date follows the ISO 8601 format"},"variation_files":{"type":"array","description":"Variations of the PAM asset","x-read-only":true,"items":{"type":"object","properties":{"_link":{"type":"object","description":"Links to get and download the variation file","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the variation entity"}}},"download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the variation file"}}}}},"locale":{"type":"string","description":"Locale code of the variation"},"scope":{"type":"string","description":"Channel code of the variation"},"code":{"type":"string","description":"Code of the variation"}}}},"reference_files":{"type":"array","description":"Reference files of the PAM asset","x-read-only":true,"items":{"type":"object","properties":{"_link":{"type":"object","description":"Links to get and download the reference file","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the reference file entity"}}},"download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the reference file"}}}}},"locale":{"type":"string","description":"Locale code of the reference file"},"code":{"type":"string","description":"Code of the reference file"}}}}},"example":{"code":"tshirt_artemis_main_picture","categories":["tshirts_assets"],"description":"The main picture of the Artemis t-shirt","localizable":false,"tags":["tshirts","red","summer"],"end_of_use":"2019-09-01T00:00:00+0200","variation_files":[{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/ecommerce/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/ecommerce/no_locale"}},"locale":null,"scope":"e_commerce","code":"7/5/8/e/758e39d48va7b42a55001434fd3d7b6cf3189b7f_tshirt_artemis_main_picture_ecommerce.jpg"},{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/print/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/print/no_locale"}},"locale":null,"scope":"print","code":"7/5/8/e/759e39d48va7b42a55002434fd3d7b6cf3189b7f_tshirt_artemis_main_picture_print.jpg"}],"reference_files":[{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/reference-files/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/reference-files/no_locale"}},"locale":null,"code":"7/5/8/e/759e39d48va7b42a55002434fd3d7b6cf3189b7f_tshirt_artemis_main_picture.jpg"}]}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"204":{"description":"No content to return","x-details":"Means that the update was successful","headers":{"Location":{"description":"URI of the updated resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/assets/{asset_code}/reference-files/{locale_code}":{"get":{"summary":"Get a reference file","operationId":"get_reference_files__locale_code_","description":"This endpoint allows you to get the information about a reference file of a given PAM asset.","tags":["PAM asset reference file"],"x-versions":["2.1","2.2","2.3","3.x"],"x-ee":true,"x-deprecated":true,"parameters":[{"name":"asset_code","in":"path","description":"Code of the asset","required":true,"type":"string"},{"name":"locale_code","in":"path","description":"Code of the locale if the asset is localizable or equal to `no-locale` if the asset is not localizable","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the reference file in JSON format","schema":{"type":"object","properties":{"code":{"type":"string","description":"Code of the PAM asset reference file","x-immutable":true},"locale":{"type":"string","description":"Locale of the PAM asset reference file, equal to `null` if the asset is not localizable"},"_link":{"type":"object","description":"Links to get and download the reference file","properties":{"download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the reference file"}}}}}},"example":{"code":"7/5/8/e/759e39d48va7b42a55002434fd3d7b6cf3189b7f_tshirt_artemis_main_picture.jpg","locale":null,"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/reference-files/no_locale/download"}}}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"post":{"summary":"Upload a new reference file","operationId":"post_reference_files__locale_code_","description":"This endpoint allows you to upload a new reference file for a given PAM asset and locale. It will also automatically generate all the variation files corresponding to this reference file.","tags":["PAM asset reference file"],"x-versions":["2.1","2.2","2.3","3.x"],"x-ee":true,"x-deprecated":true,"parameters":[{"name":"asset_code","in":"path","description":"Code of the asset","required":true,"type":"string"},{"name":"locale_code","in":"path","description":"Code of the locale if the asset is localizable or equal to `no-locale` if the asset is not localizable","required":true,"type":"string"},{"name":"Content-type","in":"header","type":"string","description":"Equal to 'multipart/form-data', no other value allowed","required":true},{"name":"body","in":"body","x-form-data":true,"schema":{"required":["file"],"properties":{"file":{"type":"string","description":"The binaries of the file","format":"binary"}}}}],"responses":{"201":{"description":"Uploaded","x-details":"Means that the reference file upload was successful. Beware that even if the reference file upload is complete, some variation files generations could have failed. If so, you will see a warning message in the response body.","headers":{"Location":{"description":"URI of the created resource","type":"string"}},"x-no-entity":true,"schema":{"type":"object","properties":{"message":{"type":"string","description":"Message explaining the warning"},"errors":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","description":"Channel for which the variation file generation failed"},"locale":{"type":"string","description":"Locale for which the variation file generation failed"},"message":{"type":"string","description":"Message explaining why the variation file generation failed"}}}}}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `multipart/form-data`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘multipart/form-data’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/assets/{asset_code}/reference-files/{locale_code}/download":{"get":{"summary":"Download a reference file","operationId":"get_reference_files__channel_code__locale_code__download","description":"This endpoint allows you to download a given reference file.","x-content-type":"Mime-type of the reference file","tags":["PAM asset reference file"],"x-versions":["2.1","2.2","2.3","3.x"],"x-ee":true,"x-deprecated":true,"parameters":[{"name":"asset_code","in":"path","description":"Code of the asset","required":true,"type":"string"},{"name":"locale_code","in":"path","description":"Code of the locale if the asset is localizable or equal to `no-locale` if the asset is not localizable","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the binary of the reference file","x-content-type":"Mime-type of the reference file"},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}}}}},"/api/rest/v1/assets/{asset_code}/variation-files/{channel_code}/{locale_code}":{"get":{"summary":"Get a variation file","operationId":"get_variation_files__channel_code__locale_code","description":"This endpoint allows you to get the information about a variation file of a given PAM asset.","tags":["PAM asset variation file"],"x-versions":["2.1","2.2","2.3","3.x"],"x-ee":true,"x-deprecated":true,"parameters":[{"name":"asset_code","in":"path","description":"Code of the asset","required":true,"type":"string"},{"name":"channel_code","in":"path","description":"Code of the channel","required":true,"type":"string"},{"name":"locale_code","in":"path","description":"Code of the locale if the asset is localizable or equal to `no-locale` if the asset is not localizable","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the variation file in JSON format","schema":{"type":"object","properties":{"code":{"type":"string","description":"Code of the PAM asset variation file","x-immutable":true},"locale":{"type":"string","description":"Locale of the PAM asset variation file, equal to `null` if the asset is not localizable"},"scope":{"type":"string","description":"Channel of the PAM asset variation file"},"_link":{"type":"object","description":"Links to get and download the reference file","properties":{"download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the variation file"}}}}}},"example":{"code":"7/5/8/e/758e39d48va7b42a55001434fd3d7b6cf3189b7f_tshirt_artemis_main_picture_ecommerce.jpg","locale":null,"scope":"ecommerce","_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/ecommerce/no_locale/download"}}}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"post":{"summary":"Upload a new variation file","operationId":"post_variation_files__channel_code__locale_code_","description":"This endpoint allows you to upload a new variation file for a given PAM asset, channel and locale.","tags":["PAM asset variation file"],"x-versions":["2.1","2.2","2.3","3.x"],"x-ee":true,"x-deprecated":true,"parameters":[{"name":"asset_code","in":"path","description":"Code of the asset","required":true,"type":"string"},{"name":"channel_code","in":"path","description":"Code of the channel","required":true,"type":"string"},{"name":"locale_code","in":"path","description":"Code of the locale if the asset is localizable or equal to `no-locale` if the asset is not localizable","required":true,"type":"string"},{"name":"Content-type","in":"header","type":"string","description":"Equal to 'multipart/form-data', no other value allowed","required":true},{"name":"body","in":"body","x-form-data":true,"schema":{"required":["file"],"properties":{"file":{"type":"string","description":"The binaries of the file","format":"binary"}}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `multipart/form-data`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘multipart/form-data’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/assets/{asset_code}/variation-files/{channel_code}/{locale_code}/download":{"get":{"summary":"Download a variation file","operationId":"get_variation_files__channel_code__locale_code__download","description":"This endpoint allows you to download a given variation file.","x-content-type":"Mime-type of the variation file","tags":["PAM asset variation file"],"x-versions":["2.1","2.2","2.3","3.x"],"x-ee":true,"x-deprecated":true,"parameters":[{"name":"asset_code","in":"path","description":"Code of the asset","required":true,"type":"string"},{"name":"channel_code","in":"path","description":"Code of the channel","required":true,"type":"string"},{"name":"locale_code","in":"path","description":"Code of the locale if the asset is localizable or equal to `no-locale` if the asset is not localizable","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the binary of the variation file","x-content-type":"Mime-type of the variation file"},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}}}}},"/api/rest/v1/asset-categories":{"get":{"summary":"Get list of PAM asset categories","operationId":"get_asset_categories","description":"This endpoint allows you to get a list of PAM asset categories. PAM asset categories are paginated and sorted by `root/left`.","tags":["PAM asset category"],"x-versions":["2.1","2.2","2.3","3.x"],"x-ee":true,"x-deprecated":true,"parameters":[{"name":"page","in":"query","description":"Number of the page to retrieve when using the `page` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"integer","default":1},{"name":"limit","in":"query","description":"Number of results by page, see Pagination section","required":false,"type":"integer","minimum":1,"maximum":100,"default":10},{"name":"with_count","in":"query","description":"Return the count of items in the response. Be carefull with that, on a big catalog, it can decrease performance in a significative way","default":false,"type":"boolean","required":false}],"responses":{"200":{"description":"Returns PAM asset categories paginated","schema":{"title":"PAM Asset Categories","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"previous":{"type":"object","properties":{"href":{"type":"string","description":"URI of the previous page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}},"current_page":{"type":"integer","description":"Current page number"}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"PAM asset category code","x-immutable":true},"parent":{"type":"string","description":"PAM ssset category code of the parent's asset category","x-validation-rules":"• It is either equal to `null` or to an existing asset category code. • If equal to an existing asset category code, it cannot reference itself.","default":"null"},"labels":{"type":"object","description":"PAM asset category labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"PAM asset category label for the locale `localeCode`"}}}},"example":{"code":"front_views","parent":"pictures","labels":{"en_US":"Front views","fr_FR":"Vues de face"}}}]}}}}}}]},"examples":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/asset-categories?page=2&limit=3"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/asset-categories?page=1&limit=3"},"previous":{"href":"https://demo.akeneo.com/api/rest/v1/asset-categories?page=1&limit=3"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/asset-categories?page=3&limit=3"}},"current_page":2,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/asset-categories/pictures"}},"code":"pictures","parent":null,"labels":{"en_US":"Pictures","fr_FR":"Images","de_DE":"Bilder"}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/asset-categories/front_views"}},"code":"front_views","parent":"pictures","labels":{"en_US":"Front views","fr_FR":"Vues de face","de_DE":"Vorderansichten"}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/asset-categories/side_views"}},"code":"side_views","parent":"pictures","labels":{"en_US":"Side views","fr_FR":"Vues de profil","de_DE":"Profilansichten"}}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"post":{"summary":"Create a new PAM asset category","operationId":"post_asset_categories","description":"This endpoint allows you to create a new PAM asset category.","tags":["PAM asset category"],"x-versions":["2.1","2.2","2.3","3.x"],"x-ee":true,"x-deprecated":true,"parameters":[{"name":"body","in":"body","schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"PAM asset category code","x-immutable":true},"parent":{"type":"string","description":"PAM ssset category code of the parent's asset category","x-validation-rules":"• It is either equal to `null` or to an existing asset category code. • If equal to an existing asset category code, it cannot reference itself.","default":"null"},"labels":{"type":"object","description":"PAM asset category labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"PAM asset category label for the locale `localeCode`"}}}},"example":{"code":"front_views","parent":"pictures","labels":{"en_US":"Front views","fr_FR":"Vues de face"}}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}},"patch":{"summary":"Update/create several PAM asset categories","operationId":"patch_asset_categories","tags":["PAM asset category"],"x-versions":["2.1","2.2","2.3","3.x"],"x-ee":true,"x-deprecated":true,"description":"This endpoint allows you to update several PAM asset categories at once.","x-body-by-line":"Contains several lines, each line is a category in JSON standard format","parameters":[{"name":"body","in":"body","schema":{"x-examples":{"x-example-1":"{\"code\":\"pictures\",\"parent\":null}","x-example-2":"{\"code\":\"front_views\",\"parent\":\"pitures\"}","x-example-3":"{\"code\":\"other_views\",\"parent\":\"pictures\"}"},"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"PAM asset category code","x-immutable":true},"parent":{"type":"string","description":"PAM ssset category code of the parent's asset category","x-validation-rules":"• It is either equal to `null` or to an existing asset category code. • If equal to an existing asset category code, it cannot reference itself.","default":"null"},"labels":{"type":"object","description":"PAM asset category labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"PAM asset category label for the locale `localeCode`"}}}},"example":{"code":"front_views","parent":"pictures","labels":{"en_US":"Front views","fr_FR":"Vues de face"}}}}],"responses":{"200":{"description":"OK","x-details":"Returns a plain text response whose lines are JSON containing the status of each update or creation","x-no-entity":true,"schema":{"type":"object","properties":{"line":{"type":"integer","description":"Line number"},"identifier":{"type":"string","description":"Resource identifier, only filled when the resource is a product"},"code":{"type":"string","description":"Resource code, only filled when the resource is not a product"},"status_code":{"type":"integer","description":"HTTP status code, see Client errors to understand the meaning of each code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"x-example-1":"{\"line\":1,\"code\":\"spring_collection\",\"status_code\":201}","x-example-2":"{\"line\":2,\"code\":\"front_views\",\"status_code\":422,\"message\":\"Asset category \"pitures\" does not exist.\"}","x-example-3":"{\"line\":3,\"code\":\"other_views\",\"status_code\":204}"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"413":{"description":"Request Entity Too Large","x-details":"There are too many resources to process (max 100) or the line of JSON is too long (max 1 000 000 characters)","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":413,"message":"Too many resources to process, 100 is the maximum allowed."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/vnd.akeneo.collection+json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/vnd.akeneo.collection+json’ is allowed."}}}}},"/api/rest/v1/asset-categories/{code}":{"get":{"summary":"Get a PAM asset category","operationId":"get_asset_categories__code_","description":"This endpoint allows you to get the information about a given PAM asset category.","tags":["PAM asset category"],"x-versions":["2.1","2.2","2.3","3.x"],"x-ee":true,"x-deprecated":true,"parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the asset category in JSON standard format","schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"PAM asset category code","x-immutable":true},"parent":{"type":"string","description":"PAM ssset category code of the parent's asset category","x-validation-rules":"• It is either equal to `null` or to an existing asset category code. • If equal to an existing asset category code, it cannot reference itself.","default":"null"},"labels":{"type":"object","description":"PAM asset category labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"PAM asset category label for the locale `localeCode`"}}}},"example":{"code":"front_views","parent":"pictures","labels":{"en_US":"Front views","fr_FR":"Vues de face"}}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"patch":{"summary":"Update/create a PAM asset category","operationId":"patch_asset_categories__code_","tags":["PAM asset category"],"x-versions":["2.1","2.2","2.3","3.x"],"x-ee":true,"x-deprecated":true,"description":"This endpoint allows you to update a given PAM asset category. Know more about Update behavior. Note that if no category exists for the given code, it creates it.","parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"},{"name":"body","in":"body","required":true,"schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"PAM asset category code","x-immutable":true},"parent":{"type":"string","description":"PAM ssset category code of the parent's asset category","x-validation-rules":"• It is either equal to `null` or to an existing asset category code. • If equal to an existing asset category code, it cannot reference itself.","default":"null"},"labels":{"type":"object","description":"PAM asset category labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"PAM asset category label for the locale `localeCode`"}}}},"example":{"code":"front_views","parent":"pictures","labels":{"en_US":"Front views","fr_FR":"Vues de face"}}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"204":{"description":"No content to return","x-details":"Means that the update was successful","headers":{"Location":{"description":"URI of the updated resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/asset-tags":{"get":{"summary":"Get list of PAM asset tags","operationId":"get_asset_tags","description":"This endpoint allows you to get a list of PAM asset tags. PAM asset tags are paginated.","tags":["PAM asset tag"],"x-versions":["2.1","2.2","2.3","3.x"],"x-ee":true,"x-deprecated":true,"parameters":[{"name":"page","in":"query","description":"Number of the page to retrieve when using the `page` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"integer","default":1},{"name":"limit","in":"query","description":"Number of results by page, see Pagination section","required":false,"type":"integer","minimum":1,"maximum":100,"default":10},{"name":"with_count","in":"query","description":"Return the count of items in the response. Be carefull with that, on a big catalog, it can decrease performance in a significative way","default":false,"type":"boolean","required":false}],"responses":{"200":{"description":"Returns PAM asset tags paginated","schema":{"title":"PAM Asset Tags","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"previous":{"type":"object","properties":{"href":{"type":"string","description":"URI of the previous page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}},"current_page":{"type":"integer","description":"Current page number"}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"PAM asset tag code","x-immutable":true}},"example":{"code":"tshirt"}}]}}}}}}]},"examples":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/asset-tags?page=2&limit=3"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/asset-tags?page=1&limit=3"},"previous":{"href":"https://demo.akeneo.com/api/rest/v1/asset-tags?page=1&limit=3"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/asset-tags?page=3&limit=3"}},"current_page":2,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/asset-tags/tshirt"}},"code":"tshirt"},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/asset-tags/belt"}},"code":"belt"},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/asset-tags/red"}},"code":"red"}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}}},"/api/rest/v1/asset-tags/{code}":{"get":{"summary":"Get a PAM asset tag","operationId":"get_asset_tags__code_","description":"This endpoint allows you to get the information about a given PAM asset tag.","tags":["PAM asset tag"],"x-versions":["2.1","2.2","2.3","3.x"],"x-ee":true,"x-deprecated":true,"parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"}],"responses":{"200":{"description":"OK","x-details":"Returns the content of the asset tag in JSON format","schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"PAM asset tag code","x-immutable":true}},"example":{"code":"tshirt"}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}},"patch":{"summary":"Update/create a PAM asset tag","operationId":"patch_asset_tags__code_","tags":["PAM asset tag"],"x-versions":["2.1","2.2","2.3","3.x"],"x-ee":true,"x-deprecated":true,"description":"This endpoint allows you to update a given PAM asset tag. Know more about Update behavior. Note that if no tag exists for the given code, it creates it.","parameters":[{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"},{"name":"body","in":"body","required":true,"schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"PAM asset tag code","x-immutable":true}},"example":{"code":"tshirt"}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"204":{"description":"No content to return","x-details":"Means that the update was successful","headers":{"Location":{"description":"URI of the updated resource","type":"string"}}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/catalogs":{"get":{"summary":"Get the list of owned catalogs","operationId":"get_app_catalogs","description":"This endpoint allows you to get the list of catalogs you owned.","tags":["Catalogs"],"x-versions":["SaaS"],"x-app-token":true,"parameters":[{"name":"page","in":"query","description":"Number of the page to retrieve when using the `page` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"integer","default":1},{"name":"limit","in":"query","description":"Number of results by page, see Pagination section","required":false,"type":"integer","minimum":1,"maximum":100,"default":100}],"responses":{"200":{"description":"Return the paginated catalogs owned by the user making the request","schema":{"title":"Catalogs","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"previous":{"type":"object","properties":{"href":{"type":"string","description":"URI of the previous page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}},"current_page":{"type":"integer","description":"Current page number"}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","properties":{"id":{"type":"string","description":"Catalog id","x-immutable":true},"name":{"type":"string","description":"Catalog name"},"enabled":{"type":"boolean","description":"Whether the catalog is enabled or not","default":false},"managed_currencies":{"type":"array","description":"List of currency codes","items":{"type":"string"}},"managed_locales":{"type":"array","description":"List of locale codes","items":{"type":"string"}}},"example":{"_links":{"self":{"href":"http://demo.akeneo.com/api/rest/v1/catalogs/3af8e091-6df5-4ed1-a9aa-090de12e5be5"}},"id":"12351d98-200e-4bbc-aa19-7fdda1bd14f2","name":"My app catalog","enabled":false,"managed_currencies":["EUR","USD","GBP"],"managed_locales":["fr_FR","en_US"]}}]}}}}}}]},"x-examples":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/catalogs?page=3&limit=2"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/catalogs?page=1&limit=2"},"previous":{"href":"https://demo.akeneo.com/api/rest/v1/catalogs?page=2&limit=2"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/catalogs?page=4&limit=2"}},"current_page":3,"_embedded":{"items":[{"id":"12351d98-200e-4bbc-aa19-7fdda1bd14f2","name":"Store EUROPE","enabled":false,"managed_currencies":["EUR","GBP"],"managed_locales":["fr_FR","en_UK","de_DE","it_IT","es_ES"]},{"id":"092c5f22-ecd8-485f-97e9-3b78098e1386","name":"Store US","enabled":true,"managed_currencies":["USD"],"managed_locales":["en_US","es_ES"]}]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The app does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list catalogs."}}}},"post":{"summary":"Create a new catalog","operationId":"post_app_catalog","tags":["Catalogs"],"x-versions":["SaaS"],"x-app-token":true,"description":"This endpoint allows you to create a new catalog.","parameters":[{"name":"body","in":"body","schema":{"type":"object","required":["name"],"properties":{"name":{"type":"string","description":"Catalog name"},"managed_currencies":{"type":"array","description":"List of currency codes","items":{"type":"string"}},"managed_locales":{"type":"array","description":"List of locale codes","items":{"type":"string"}}},"example":{"name":"My app catalog","managed_currencies":["EUR","USD","GBP"],"managed_locales":["fr_FR","en_US"]}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","schema":{"type":"object","properties":{"id":{"type":"string","description":"Catalog id","x-immutable":true},"name":{"type":"string","description":"Catalog name"},"enabled":{"type":"boolean","description":"Whether the catalog is enabled or not","default":false},"managed_currencies":{"type":"array","description":"List of currency codes","items":{"type":"string"}},"managed_locales":{"type":"array","description":"List of locale codes","items":{"type":"string"}}},"example":{"_links":{"self":{"href":"http://demo.akeneo.com/api/rest/v1/catalogs/3af8e091-6df5-4ed1-a9aa-090de12e5be5"}},"id":"12351d98-200e-4bbc-aa19-7fdda1bd14f2","name":"My app catalog","enabled":false,"managed_currencies":["EUR","USD","GBP"],"managed_locales":["fr_FR","en_US"]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The app does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list catalogs."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"x-examples-per-version":[{"x-version":"SaaS","x-example":{"code":422,"message":"Validation failed.","errors":[{"property":"name","message":"This value should not be blank."},{"property":"name","message":"This value is too short. It should have 1 character or more."}]}}]}}}},"/api/rest/v1/catalogs/{id}":{"get":{"summary":"Get a catalog","operationId":"get_app_catalog","description":"This endpoint allows you to get the information about a catalog.","tags":["Catalogs"],"x-versions":["SaaS"],"x-app-token":true,"parameters":[{"name":"id","in":"path","description":"Catalog ID","required":true,"type":"string","format":"uuid"}],"responses":{"200":{"description":"Return the catalog","schema":{"type":"object","properties":{"id":{"type":"string","description":"Catalog id","x-immutable":true},"name":{"type":"string","description":"Catalog name"},"enabled":{"type":"boolean","description":"Whether the catalog is enabled or not","default":false},"managed_currencies":{"type":"array","description":"List of currency codes","items":{"type":"string"}},"managed_locales":{"type":"array","description":"List of locale codes","items":{"type":"string"}}},"example":{"_links":{"self":{"href":"http://demo.akeneo.com/api/rest/v1/catalogs/3af8e091-6df5-4ed1-a9aa-090de12e5be5"}},"id":"12351d98-200e-4bbc-aa19-7fdda1bd14f2","name":"My app catalog","enabled":false,"managed_currencies":["EUR","USD","GBP"],"managed_locales":["fr_FR","en_US"]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The app does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list catalogs."}},"404":{"description":"Catalog not found","x-details":"The catalog id given in the URI does not exist","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Catalog \"65f5a521-e65c-4d7b-8be8-1f267fa2729c\" does not exist or you can't access it."}}}},"patch":{"summary":"Update a catalog","operationId":"patch_app_catalog","tags":["Catalogs"],"x-versions":["SaaS"],"x-app-token":true,"description":"This endpoint allows you to update a catalog.","parameters":[{"name":"id","in":"path","description":"Catalog ID","required":true,"type":"string","format":"uuid"},{"name":"body","in":"body","schema":{"type":"object","required":["name"],"properties":{"name":{"type":"string","description":"Catalog name"},"managed_currencies":{"type":"array","description":"List of currency codes","items":{"type":"string"}},"managed_locales":{"type":"array","description":"List of locale codes","items":{"type":"string"}}},"example":{"name":"My app catalog","managed_currencies":["EUR","USD","GBP"],"managed_locales":["fr_FR","en_US"]}}}],"responses":{"200":{"description":"Updated","schema":{"type":"object","properties":{"id":{"type":"string","description":"Catalog id","x-immutable":true},"name":{"type":"string","description":"Catalog name"},"enabled":{"type":"boolean","description":"Whether the catalog is enabled or not","default":false},"managed_currencies":{"type":"array","description":"List of currency codes","items":{"type":"string"}},"managed_locales":{"type":"array","description":"List of locale codes","items":{"type":"string"}}},"example":{"_links":{"self":{"href":"http://demo.akeneo.com/api/rest/v1/catalogs/3af8e091-6df5-4ed1-a9aa-090de12e5be5"}},"id":"12351d98-200e-4bbc-aa19-7fdda1bd14f2","name":"My app catalog","enabled":false,"managed_currencies":["EUR","USD","GBP"],"managed_locales":["fr_FR","en_US"]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The app does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list catalogs."}},"404":{"description":"Catalog not found","x-details":"The catalog id given in the URI does not exist","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Catalog \"65f5a521-e65c-4d7b-8be8-1f267fa2729c\" does not exist or you can't access it."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"x-examples-per-version":[{"x-version":"SaaS","x-example":{"code":422,"message":"Validation failed.","errors":[{"property":"name","message":"This value should not be blank."},{"property":"name","message":"This value is too short. It should have 1 character or more."}]}}]}}},"delete":{"summary":"Delete a catalog","operationId":"delete_app_catalog","tags":["Catalogs"],"x-versions":["SaaS"],"x-app-token":true,"description":"This endpoint allows you to delete a catalog.","parameters":[{"name":"id","in":"path","description":"Catalog ID","required":true,"type":"string","format":"uuid"}],"responses":{"204":{"description":"Deleted"},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The app does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list catalogs."}},"404":{"description":"Catalog not found","x-details":"The catalog id given in the URI does not exist","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Catalog \"65f5a521-e65c-4d7b-8be8-1f267fa2729c\" does not exist or you can't access it."}}}}},"/api/rest/v1/catalogs/{id}/product-uuids":{"get":{"summary":"Get the list of product uuids","operationId":"get_app_catalog_product_uuids","description":"This endpoint allows you to get the list of uuids of products contained in a catalog. Please, note that a disabled catalog can return an HTTP 200 with a payload containing an error message, for more details see the App Catalog section.","tags":["Catalog products"],"x-versions":["SaaS"],"x-app-token":true,"parameters":[{"name":"id","in":"path","description":"Id of the catalog","required":true,"type":"string","format":"uuid"},{"name":"search_after","in":"query","description":"Cursor when using the `search_after` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"string","default":"cursor to the first page"},{"name":"limit","in":"query","description":"Number of results by page, see Pagination section","required":false,"type":"integer","minimum":1,"maximum":1000,"default":100},{"name":"updated_before","in":"query","description":"Filter products that have been updated BEFORE the provided date (Only available on Catalogs endpoints). This filter uses the PIM products updated date.","type":"string","format":"date","required":false,"x-from-version":"SaaS"},{"name":"updated_after","in":"query","description":"Filter products that have been updated AFTER the provided date (Only available on Catalogs endpoints). This filter uses the PIM products updated date.","type":"string","format":"date","required":false,"x-from-version":"SaaS"},{"name":"with_count","in":"query","description":"Return the count of items in the response.","default":false,"type":"boolean","required":false}],"responses":{"200":{"description":"Return the paginated product uuids","schema":{"title":"Product uuids","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"string","format":"uuid"}}}}}}]},"x-examples":{"_links":{"self":{"href":"http://demo.akeneo.com/api/rest/v1/catalogs/12351d98-200e-4bbc-aa19-7fdda1bd14f2/product-uuids"},"first":{"href":"http://demo.akeneo.com/api/rest/v1/catalogs/12351d98-200e-4bbc-aa19-7fdda1bd14f2/product-uuids"},"next":{"href":"http://demo.akeneo.com/api/rest/v1/catalogs/12351d98-200e-4bbc-aa19-7fdda1bd14f2/product-uuids?search_after=eddfbd2a-abc7-488d-b9e3-41289c824f80"}},"_embedded":{"items":["844c736b-a19b-48a6-a354-6056044729f0","b2a683ef-4a91-4ed3-b3fa-76dab065a8d5","eddfbd2a-abc7-488d-b9e3-41289c824f80"]}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The app does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list catalogs."}},"404":{"description":"Catalog not found","x-details":"The catalog id given in the URI does not exist","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Catalog \"65f5a521-e65c-4d7b-8be8-1f267fa2729c\" does not exist or you can't access it."}}}}},"/api/rest/v1/catalogs/{id}/products":{"get":{"summary":"Get the list of products related to a catalog","operationId":"get_app_catalog_products","tags":["Catalog products"],"x-versions":["SaaS"],"description":"This endpoint allows you to get the list of products related to a catalog. Products are paginated and they can be filtered. In the Enterprise Edition, permissions based on your app settings are applied to the set of products you request. Please, note that a disabled catalog can return an HTTP 200 with a payload containing an error message, for more details see the App Catalog section.","parameters":[{"name":"id","in":"path","description":"Catalog ID","required":true,"type":"string","format":"uuid"},{"name":"search_after","in":"query","description":"Cursor when using the `search_after` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"string","default":"cursor to the first page"},{"name":"limit","in":"query","description":"Number of results by page, see Pagination section","required":false,"type":"integer","minimum":1,"maximum":1000,"default":100},{"name":"updated_before","in":"query","description":"Filter products that have been updated BEFORE the provided date (Only available on Catalogs endpoints). This filter uses the PIM products updated date.","type":"string","format":"date","required":false,"x-from-version":"SaaS"},{"name":"updated_after","in":"query","description":"Filter products that have been updated AFTER the provided date (Only available on Catalogs endpoints). This filter uses the PIM products updated date.","type":"string","format":"date","required":false,"x-from-version":"SaaS"}],"responses":{"200":{"description":"Return the paginated products","schema":{"title":"Products","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"string","format":"uuid"}}}}}}]},"x-examples-per-version":[{"x-version":"SaaS","x-example":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/catalogs/65f5a521-e65c-4d7b-8be8-1f267fa2729c/products?limit=3"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/catalogs/65f5a521-e65c-4d7b-8be8-1f267fa2729c/products?limit=3"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/catalogs/65f5a521-e65c-4d7b-8be8-1f267fa2729c/products?search_after=0059d30f-6874-4277-81ed-3b3657c83f5e&limit=3"}},"_embedded":{"items":[{"uuid":"00073089-1310-4340-bcf0-9e33e4019b79","enabled":true,"family":"mens_clothing","categories":["Cloths"],"groups":[],"parent":null,"values":{"Default_Price":[{"locale":null,"scope":null,"data":[{"amount":"10.00","currency":"USD"}]}],"sku":[{"locale":null,"scope":null,"data":"product_416"}],"Name":[{"locale":null,"scope":null,"data":"Product 416"}],"Weight":[{"locale":null,"scope":null,"data":{"amount":10,"unit":"KILOGRAM"}}]},"created":"2022-03-14T15:25:45+00:00","updated":"2022-06-24T12:54:58+00:00","associations":{"PACK":{"products":[],"product_models":[],"groups":[]},"UPSELL":{"products":[],"product_models":[],"groups":[]},"X_SELL":{"products":[],"product_models":[],"groups":[]},"SUBSTITUTION":{"products":[],"product_models":[],"groups":[]}},"quantified_associations":{}},{"uuid":"00248acf-f1f7-45cb-b409-c8c4b9a17a86","enabled":true,"family":"mens_clothing","categories":["Cloths"],"groups":[],"parent":null,"values":{"Default_Price":[{"locale":null,"scope":null,"data":[{"amount":"10.00","currency":"USD"}]}],"sku":[{"locale":null,"scope":null,"data":"product_470"}],"Name":[{"locale":null,"scope":null,"data":"Product 470"}],"Weight":[{"locale":null,"scope":null,"data":{"amount":10,"unit":"KILOGRAM"}}]},"created":"2022-03-14T15:25:45+00:00","updated":"2022-06-24T12:55:01+00:00","associations":{"PACK":{"products":[],"product_models":[],"groups":[]},"UPSELL":{"products":[],"product_models":[],"groups":[]},"X_SELL":{"products":[],"product_models":[],"groups":[]},"SUBSTITUTION":{"products":[],"product_models":[],"groups":[]}},"quantified_associations":{}}]}}}]},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The app does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list catalogs."}},"404":{"description":"Catalog not found","x-details":"The catalog id given in the URI does not exist","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Catalog \"65f5a521-e65c-4d7b-8be8-1f267fa2729c\" does not exist or you can't access it."}}}}},"/api/rest/v1/catalogs/{id}/products/{uuid}":{"get":{"summary":"Get a product related to a catalog","operationId":"get_app_catalog_products_uuid","tags":["Catalog products"],"x-versions":["SaaS"],"description":"This endpoint allows you to get a specific product related to a catalog. In the Enterprise Edition, permissions based on your app settings are applied on the product you request. Please, note that a disabled catalog can return an HTTP 200 with a payload containing an error message, for more details see the App Catalog section.","parameters":[{"name":"id","in":"path","description":"Catalog ID","required":true,"type":"string","format":"uuid"},{"name":"uuid","in":"path","description":"Product UUID","required":true,"type":"string","format":"uuid"}],"responses":{"200":{"description":"Return the product","x-examples-per-version":[{"x-version":"SaaS","x-example":{"uuid":"a5eed606-4f98-4d8c-b926-5b59f8fb0ee7","family":"tshirt","groups":[],"parent":null,"categories":[],"enabled":true,"values":{"name":[{"data":"Top","locale":"en_US","scope":null}]}}}]},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The app does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list catalogs."}},"404":{"description":"Catalog not found","x-details":"The catalog id given in the URI does not exist","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Catalog \"65f5a521-e65c-4d7b-8be8-1f267fa2729c\" does not exist or you can't access it."}}}}},"/api/rest/v1/catalogs/{id}/mapping-schemas/product":{"put":{"summary":"Create or update the product mapping schema related to a catalog","operationId":"put_app_catalogs_mapping_schema_product","description":"This endpoint allows you to create or update the product mapping schema related to a catalog. See documentation to define your JSON schema.","tags":["Mapping schema for products"],"x-versions":["SaaS"],"x-app-token":true,"parameters":[{"name":"id","in":"path","description":"Catalog ID","required":true,"type":"string","format":"uuid"},{"name":"body","in":"body","schema":{"type":"object","required":["$schema","properties"],"properties":{"$id":{"type":"string","description":"id of your schema"},"$schema":{"type":"string","description":"$schema indicates which product mapping schema version your app uses"},"$comment":{"type":"string","description":"allows you to add a comment"},"title":{"type":"string","description":"allows you to add a title to your mapping schema"},"description":{"type":"string","description":"allows you to add a description of your mapping schema"},"type":{"type":"string","description":"should always be \"object\""},"properties":{"type":"object","description":"list and describe the targets your app expects"}},"example":{"$id":"https://example.com/product","$schema":"https://api.akeneo.com/mapping/product/1.0.0/schema","type":"object","properties":{"code":{"title":"Model ID","type":"string"},"brand":{"title":"Brand name","type":"string"},"description":{"title":"Product description","type":"string"},"fabrics":{"title":"Fabrics","type":"array","items":{"type":"string"}},"localized_names":{"title":"Name with multiple locales","type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"value":{"type":"string"}},"required":["locale","value"]}},"localized_number":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"value":{"type":"number"}},"required":["locale","value"]}},"localized_link":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"value":{"type":"string","format":"uri"}},"required":["locale","value"]}},"localized_datetime":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"value":{"type":"string","format":"date-time"}},"required":["locale","value"]}},"localized_boolean":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"value":{"type":"boolean"}},"required":["locale","value"]}},"variation_axes":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"label":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"value":{"type":"string"}}}}}}},"variants":{"oneOf":[{"type":"string","format":"uri"},{"type":"array","items":{"type":"object","properties":{"variation_axes_values":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"value":{"oneOf":[{"type":["string","boolean"]},{"type":"object","properties":{"amount":{"type":"number"},"unit":{"type":"string"}}}]},"label":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"value":{"type":"string"}}}}}}},"uuid":{"title":"uuid","type":"string"},"sku":{"title":"SKU","type":"string"},"position":{"title":"Position","type":"number"},"price":{"title":"Price","type":"string"},"response_time":{"title":"Response time","type":"string"},"localized_product_photos_media_file":{"title":"Photos with value per locale(links)","type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"value":{"type":"array","items":{"type":"string","format":"uri"}}},"required":["locale","value"]}},"localized_prices":{"title":"Price in multiple currencies with value per locale","type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"value":{"type":"array","items":{"type":"object","properties":{"amount":{"type":"number"},"currency":{"type":"string"}},"required":["amount","currency"]}}},"required":["locale","value"]}}},"required":["uuid"]}}]}}}}}],"responses":{"201":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The app does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list catalogs."}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"x-examples-per-version":[{"x-version":"SaaS","x-example":{"code":422,"message":"Validation failed.","errors":[{"property":"product_mapping_schema","message":"You must provide a valid schema."}]}}]}}},"get":{"summary":"Get the product mapping schema related to a catalog","operationId":"get_app_catalogs_mapping_schema_product","description":"This endpoint allows you to retrieve the product mapping schema related to a catalog","tags":["Mapping schema for products"],"x-versions":["SaaS"],"x-app-token":true,"parameters":[{"name":"id","in":"path","description":"Catalog ID","required":true,"type":"string","format":"uuid"}],"responses":{"200":{"description":"Return product mapping schema related to a catalog","schema":{"type":"object","required":["$schema","properties"],"properties":{"$id":{"type":"string","description":"id of your schema"},"$schema":{"type":"string","description":"$schema indicates which product mapping schema version your app uses"},"$comment":{"type":"string","description":"allows you to add a comment"},"title":{"type":"string","description":"allows you to add a title to your mapping schema"},"description":{"type":"string","description":"allows you to add a description of your mapping schema"},"type":{"type":"string","description":"should always be \"object\""},"properties":{"type":"object","description":"list and describe the targets your app expects"}},"example":{"$id":"https://example.com/product","$schema":"https://api.akeneo.com/mapping/product/1.0.0/schema","type":"object","properties":{"code":{"title":"Model ID","type":"string"},"brand":{"title":"Brand name","type":"string"},"description":{"title":"Product description","type":"string"},"fabrics":{"title":"Fabrics","type":"array","items":{"type":"string"}},"localized_names":{"title":"Name with multiple locales","type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"value":{"type":"string"}},"required":["locale","value"]}},"localized_number":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"value":{"type":"number"}},"required":["locale","value"]}},"localized_link":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"value":{"type":"string","format":"uri"}},"required":["locale","value"]}},"localized_datetime":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"value":{"type":"string","format":"date-time"}},"required":["locale","value"]}},"localized_boolean":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"value":{"type":"boolean"}},"required":["locale","value"]}},"variation_axes":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"label":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"value":{"type":"string"}}}}}}},"variants":{"oneOf":[{"type":"string","format":"uri"},{"type":"array","items":{"type":"object","properties":{"variation_axes_values":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"value":{"oneOf":[{"type":["string","boolean"]},{"type":"object","properties":{"amount":{"type":"number"},"unit":{"type":"string"}}}]},"label":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"value":{"type":"string"}}}}}}},"uuid":{"title":"uuid","type":"string"},"sku":{"title":"SKU","type":"string"},"position":{"title":"Position","type":"number"},"price":{"title":"Price","type":"string"},"response_time":{"title":"Response time","type":"string"},"localized_product_photos_media_file":{"title":"Photos with value per locale(links)","type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"value":{"type":"array","items":{"type":"string","format":"uri"}}},"required":["locale","value"]}},"localized_prices":{"title":"Price in multiple currencies with value per locale","type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"value":{"type":"array","items":{"type":"object","properties":{"amount":{"type":"number"},"currency":{"type":"string"}},"required":["amount","currency"]}}},"required":["locale","value"]}}},"required":["uuid"]}}]}}}}},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The app does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list catalogs."}},"404":{"description":"Catalog not found","x-details":"The catalog id given in the URI does not exist","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Catalog \"65f5a521-e65c-4d7b-8be8-1f267fa2729c\" does not exist or you can't access it."}}}},"delete":{"summary":"Delete the product mapping schema related to a catalog","operationId":"delete_app_catalogs_mapping_schema_product","description":"This endpoint allows you to delete the product mapping schema related to a catalog","tags":["Mapping schema for products"],"x-versions":["SaaS"],"x-app-token":true,"parameters":[{"name":"id","in":"path","description":"Catalog ID","required":true,"type":"string","format":"uuid"}],"responses":{"204":{"description":"Deleted"},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The app does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list catalogs."}},"404":{"description":"Catalog not found","x-details":"The catalog id given in the URI does not exist","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Catalog \"65f5a521-e65c-4d7b-8be8-1f267fa2729c\" does not exist or you can't access it."}}}}},"/api/rest/v1/catalogs/{id}/mapped-products":{"get":{"summary":"Get the list of mapped flattened products or simple products related to a catalog","operationId":"get_app_catalog_mapped_products","tags":["Catalog products"],"x-versions":["SaaS"],"description":"This endpoint is available when the mapping is enabled on a specified catalog. When the mapping is in a basic mode, this endpoint allows you to get the list of all flattened products related to the catalog. When it's in models/variants mode, this endpoint allows you to get the list of simple products with all specified targets in the two levels of the mapping schema. Please, note that a disabled catalog can return an HTTP 200 with a payload containing an error message, for more details see the App Catalog section.","parameters":[{"name":"id","in":"path","description":"Catalog ID","required":true,"type":"string","format":"uuid"},{"name":"search_after","in":"query","description":"Cursor when using the `search_after` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"string","default":"cursor to the first page"},{"name":"limit","in":"query","description":"Number of results by page, see Pagination section","required":false,"type":"integer","minimum":1,"maximum":100,"default":100},{"name":"updated_before","in":"query","description":"Filter products that have been updated BEFORE the provided date (Only available on Catalogs endpoints). This filter uses the PIM products updated date.","type":"string","format":"date","required":false,"x-from-version":"SaaS"},{"name":"updated_after","in":"query","description":"Filter products that have been updated AFTER the provided date (Only available on Catalogs endpoints). This filter uses the PIM products updated date.","type":"string","format":"date","required":false,"x-from-version":"SaaS"}],"responses":{"200":{"description":"Return the paginated **mapped** products","schema":{"title":"Products","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"string","format":"uuid"}}}}}}]},"x-examples-per-version":[{"x-version":"SaaS","x-example":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/catalogs/d259aecf-3ec1-4b07-ae0f-ce234b86c025/mapped-products?limit=100"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/catalogs/d259aecf-3ec1-4b07-ae0f-ce234b86c025/mapped-products?limit=100"}},"_embedded":{"items":[{"uuid":"04f47a54-8cc9-4c51-90e9-eb9aace0865f","title":"Canon Video Visualiser RE-455X","code":"sku-1234"},{"uuid":"06dc8c5b-9e2f-4423-b9dd-31a3aaa0a048","title":"Trust Cuby Pro","code":"sku-1235"},{"uuid":"0c3635f9-fedc-4bbd-96ab-856f69746b56","title":"Trust Urban Revolt","code":"sku-1236"},{"uuid":"0e957ed4-fa44-48de-b6c7-7149d890fb3a","title":"Microsoft LifeCam Studio","code":"sku-1237"}]}}}]},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The app does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list catalogs."}},"404":{"description":"Catalog not found","x-details":"The catalog id given in the URI does not exist","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Catalog \"65f5a521-e65c-4d7b-8be8-1f267fa2729c\" does not exist or you can't access it."}}}}},"/api/rest/v1/catalogs/{id}/mapped-models":{"get":{"summary":"Get the list of mapped models related to a catalog","operationId":"get_app_catalog_mapped_models","tags":["Catalog products"],"x-versions":["SaaS"],"description":"This endpoint allows you to get the list of models related to a catalog when the mapping is enabled with a models/variants schema. Please, note that a disabled catalog can return an HTTP 200 with a payload containing an error message, for more details see the App Catalog section.","parameters":[{"name":"id","in":"path","description":"Catalog ID","required":true,"type":"string","format":"uuid"},{"name":"search_after","in":"query","description":"Cursor when using the `search_after` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"string","default":"cursor to the first page"},{"name":"limit","in":"query","description":"Number of results by page, see Pagination section","required":false,"type":"integer","minimum":1,"maximum":100,"default":100},{"name":"updated_before","in":"query","description":"Filter products that have been updated BEFORE the provided date (Only available on Catalogs endpoints). This filter uses the PIM products updated date.","type":"string","format":"date","required":false,"x-from-version":"SaaS"},{"name":"updated_after","in":"query","description":"Filter products that have been updated AFTER the provided date (Only available on Catalogs endpoints). This filter uses the PIM products updated date.","type":"string","format":"date","required":false,"x-from-version":"SaaS"}],"responses":{"200":{"description":"Return the paginated **mapped** models","schema":{"title":"Products","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"string","format":"uuid"}}}}}}]},"x-examples-per-version":[{"x-version":"SaaS","x-example":{"_links":{"first":{"href":"https://demo.akeneo.com/api/rest/v1/catalogs/232be0b2-093c-4591-a506-2a2ed5176721/mapped-models?limit=3"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/catalogs/232be0b2-093c-4591-a506-2a2ed5176721/mapped-models?search_after=apollon&limit=3"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/catalogs/232be0b2-093c-4591-a506-2a2ed5176721/mapped-models?limit=3"}},"_embedded":{"items":[{"code":"tshirt_akeneo","title":"Beautiful t-shirt with Akeneo logo","variants":"https://demo.akeneo.com/api/rest/v1/catalogs/232be0b2-093c-4591-a506-2a2ed5176721/mapped-models/tshirt_akeneo/variants","variation_axes":[{"code":"color","label":[{"locale":"en_US","value":"Color"},{"locale":"fr_FR","value":"Couleur"}]},{"code":"size","label":[{"locale":"en_US","value":"Size"},{"locale":"fr_FR","value":"Taille"}]}]},{"code":"tshirt_pim","title":"Beautiful t-shirt with PIM logo","variants":"https://demo.akeneo.com/api/rest/v1/catalogs/232be0b2-093c-4591-a506-2a2ed5176721/mapped-models/tshirt_pim/variants","variation_axes":[{"code":"color","label":[{"locale":"en_US","value":"Color"},{"locale":"fr_FR","value":"Couleur"}]},{"code":"size","label":[{"locale":"en_US","value":"Size"},{"locale":"fr_FR","value":"Taille"}]}]}]}}}]},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The app does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list catalogs."}},"404":{"description":"Catalog not found","x-details":"The catalog id given in the URI does not exist","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Catalog \"65f5a521-e65c-4d7b-8be8-1f267fa2729c\" does not exist or you can't access it."}}}}},"/api/rest/v1/catalogs/{id}/mapped-models/{model_code}/variants":{"get":{"summary":"Get the list of mapped variants of a model related to a catalog","operationId":"get_app_catalog_mapped_variants","tags":["Catalog products"],"x-versions":["SaaS"],"description":"This endpoint allows you to get the list of variants of a model related to a catalog when the mapping is enabled. Please, note that a disabled catalog can return an HTTP 200 with a payload containing an error message, for more details see the App Catalog section.","parameters":[{"name":"id","in":"path","description":"Catalog ID","required":true,"type":"string","format":"uuid"},{"name":"search_after","in":"query","description":"Cursor when using the `search_after` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"string","default":"cursor to the first page"},{"name":"limit","in":"query","description":"Number of results by page, see Pagination section","required":false,"type":"integer","minimum":1,"maximum":100,"default":100},{"name":"model_code","in":"path","description":"Model code","required":true,"type":"string"},{"name":"updated_before","in":"query","description":"Filter products that have been updated BEFORE the provided date (Only available on Catalogs endpoints). This filter uses the PIM products updated date.","type":"string","format":"date","required":false,"x-from-version":"SaaS"},{"name":"updated_after","in":"query","description":"Filter products that have been updated AFTER the provided date (Only available on Catalogs endpoints). This filter uses the PIM products updated date.","type":"string","format":"date","required":false,"x-from-version":"SaaS"}],"responses":{"200":{"description":"Return the paginated **mapped** variants","schema":{"title":"Products","type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}}}},{"properties":{"_embedded":{"type":"object","properties":{"items":{"type":"array","items":{"type":"string","format":"uuid"}}}}}}]},"x-examples-per-version":[{"x-version":"SaaS","x-example":{"_links":{"first":{"href":"https://demo.akeneo.com/api/rest/v1/catalogs/232be0b2-093c-4591-a506-2a2ed5176721/mapped-models/tshirt_akeneo/variants?limit=100"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/catalogs/232be0b2-093c-4591-a506-2a2ed5176721/mapped-models/tshirt_akeneo/variants?limit=100"}},"_embedded":{"items":[{"is_published":true,"sku":"AK10BLXL","uuid":"6b025a71-537f-48d4-aa26-a6617d6199e9","variant_axes_values":[{"code":"color","label":[{"locale":"en_US","value":"Blue"},{"locale":"fr_FR","value":"Bleu"}],"value":"blue"},{"code":"size","label":[{"locale":"en_US","value":"XL"},{"locale":"fr_FR","value":"XL"}],"value":"xl"}]},{"is_published":true,"sku":"AK10YEXL","uuid":"6b025a71-537f-48d4-aa26-a6617d6199e9","variant_axes_values":[{"code":"color","label":[{"locale":"en_US","value":"Yellow"},{"locale":"fr_FR","value":"Jaune"}],"value":"yellow"},{"code":"size","label":[{"locale":"en_US","value":"XL"},{"locale":"fr_FR","value":"XL"}],"value":"xl"}]}]}}}]},"401":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403":{"description":"Access forbidden","x-details":"The app does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list catalogs."}},"404":{"description":"Catalog not found","x-details":"The catalog id given in the URI does not exist","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Catalog \"65f5a521-e65c-4d7b-8be8-1f267fa2729c\" does not exist or you can't access it."}}}}},"/api/rest/v1":{"get":{"summary":"Get list of all endpoints","operationId":"get_endpoints","description":"This endpoint allows you to get the list of all the available endpoints. No need to be authenticated to use this endpoint.","tags":["Overview"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"x-no-token":true,"responses":{"200":{"description":"Return the list of all available endpoints","x-no-entity":true,"schema":{"type":"object","properties":{"host":{"type":"string","description":"Host name"},"authentication":{"type":"object","description":"Endpoint to get the authentication token"},"routes":{"type":"object","description":"All the availables endpoints"}}},"examples":{"host":"https://demo.akeneo.com","authentication":{"fos_oauth_server_token":{"route":"/api/oauth/v1/token","methods":["POST"]}},"routes":{"pim_api_category_list":{"route":"/api/rest/v1/categories","methods":["GET"]},"pim_api_category_get":{"route":"/api/rest/v1/categories/{code}","methods":["GET"]},"pim_api_category_create":{"route":"/api/rest/v1/categories","methods":["POST"]},"pim_api_category_partial_update":{"route":"/api/rest/v1/categories/{code}","methods":["PATCH"]}}}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}}},"/api/oauth/v1/token":{"post":{"summary":"Get authentication token","operationId":"post_token","description":"This endpoint allows you to get an authentication token. No need to be authenticated to use this endpoint.","tags":["Authentication"],"x-versions":["1.7","2.x","3.x","4.0","5.0","6.0","7.0","SaaS"],"x-no-token":true,"parameters":[{"name":"Content-type","in":"header","type":"string","description":"Equal to 'application/json' or 'application/x-www-form-urlencoded', no other value allowed","required":true},{"name":"Authorization","in":"header","type":"string","required":true,"description":"Equal to 'Basic xx', where 'xx' is the base 64 encoding of the client id and secret. Find out how to generate them in the Client ID/secret generation section."},{"name":"body","in":"body","x-form-data":true,"schema":{"type":"object","required":["username","password","grant_type"],"properties":{"username":{"type":"string","description":"Your PIM username"},"password":{"type":"string","description":"Your PIM password"},"grant_type":{"type":"string","description":"Always equal to \"password\""}},"example":{"username":"admin","password":"admin","grant_type":"password"}}}],"responses":{"200":{"description":"Return an authentication token","x-no-entity":true,"schema":{"type":"object","properties":{"access_token":{"type":"string","description":"Authentication token that should be given in every authenticated request to the API"},"expires_in":{"type":"integer","description":"Validity of the token given in seconds, 3600s = 1h by default"},"token_type":{"type":"string","description":"Token type, always equal to \"bearer\""},"scope":{"type":"string","description":"Unused, always equal to \"null\""},"refresh_token":{"type":"string","description":"Use this token when your access token has expired. See Refresh an expired token section for more details."}}},"examples":{"access_token":"ZTZmYjU4ZmQxZWNmMzk1M2NlYzA5NmFhNmIzVjExMzE4NmJmODBkZGIyYTliYmQyNjk2ZDQwZThmNjdiZDQzOQ","expires_in":3600,"token_type":"bearer","scope":null,"refresh_token":"M2FlODI0OTE3ODMyNjViMzRiOWE5ODMyNWViMThkNDU5YzJjNjFiZjNkZWFjMzIyYjc4YTgzZWY1MjE5ZTY5Mw"}},"400":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"415":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"422":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}}}}},"/api/rest/v1/system-information":{"get":{"summary":"Get system information","operationId":"get_system_information","description":"This endpoint allows you to get the version and the edition of the PIM. Example of what you can get
Environment Edition Version
SaaS EE Serenity v20230112013744
SaaS CE GE v20210526040645
PaaS or onPrem EE EE 6.0.28
PaaS or onPrem CE CE 6.0.28
","tags":["System"],"x-versions":["6.0","7.0","SaaS"],"x-no-token":true,"responses":{"200":{"description":"Return the version and the edition of the PIM.","x-no-entity":true,"schema":{"type":"object","properties":{"version":{"type":"string","description":"Version of the PIM"},"edition":{"type":"string","description":"Edition of the PIM"}}},"examples":{"version":"20210521041041","edition":"Serenity"}},"406":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}}}}}},"definitions":{"Product":{"type":"object","required":["identifier"],"properties":{"uuid":{"type":"string","description":"Product UUID","x-from-version":"7.0"},"identifier":{"type":"string","description":"Product identifier, i.e. the value of the only `pim_catalog_identifier` attribute"},"enabled":{"type":"boolean","description":"Whether the product is enabled","default":true},"family":{"type":"string","description":"Family code from which the product inherits its attributes and attributes requirements.","x-validation-rules":"It is equal to an existing family code. In the case of variant product, the given family should be the same as the product model family.","default":"null only in the case of a non variant product"},"categories":{"type":"array","description":"Codes of the categories in which the product is classified","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"groups":{"type":"array","description":"Codes of the groups to which the product belong","x-validation-rules":"Each string of the array is equal to an existing group code","items":{"type":"string"},"default":[]},"parent":{"type":"string","description":"Code of the parent product model when the product is a variant (only available since the 2.0). This parent can be modified since the 2.3.","x-validation-rules":"It is equal to an existing product model code only if the product is variant otherwise it's equal to null","default":"null","x-from-version":"2.0"},"values":{"type":"object","description":"Product attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value. See the `data` format section for more details."},"linked_data":{"type":"object","x-read-only":true,"description":"Object containing additional data when a related query parameter is enabled. See the `linked_data` format section for more details. (only available since the 5.0)","x-from-version":"5.0","properties":{"attribute":{"type":"string"},"code":{"type":"string"},"labels":{"type":"object"}}},"attribute_type":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"The type of the value's attribute. See type section for more details."},"reference_data_name":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"Reference entity code when the attribute type is `akeneo_reference_entity` or `akeneo_reference_entity_collection` OR Asset family code when the attribute type is `pim_catalog_asset_collection`","x-warning":"Only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types"}}}}}},"associations":{"type":"object","description":"Several associations related to groups, product models and/or other products, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the identifier of an existing product. • Each string in the array of the property `product_models` is the code of an existing product model.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of product identifiers with which the product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Several quantified associations related to products and/or product models, grouped by quantified association types (only available since the 5.0)","x-validation-rules":"• The `quantifiedAssociationTypeCode` is the code of an existing association type which provides quantity information. • Each object in the array of the property `products` contains the identifier of an existing product and the quantity of it.","x-from-version":"5.0","properties":{"quantifiedAssociationTypeCode":{"type":"object","properties":{"products":{"type":"array","description":"Array of objects containing product identifiers and quantities with which the product is in relation","items":{"type":"object","properties":{"identifier":{"type":"string"},"quantity":{"type":"integer"}}}},"product_models":{"type":"array","description":"Array of objects containing product model codes and quantities with which the product is in relation","items":{"type":"object","properties":{"code":{"type":"string"},"quantity":{"type":"integer"}}}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"metadata":{"type":"object","description":"More information around the product (only available since the v2.0 in the Enterprise Edition)","x-immutable":true,"x-read-only":true,"x-from-version":"2.0","properties":{"workflow_status":{"description":"Status of the product regarding the user permissions","type":"string","enum":["read_only","draft_in_progress","proposal_waiting_for_approval","working_copy"]}}},"quality_scores":{"type":"object","description":"Product quality scores for each channel/locale combination (only available since the 5.0 and when the \"with_quality_scores\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"5.0"},"completenesses":{"type":"array","description":"Product completenesses for each channel/locale combination (only available since the 7.0 version, and when the \"with_completenesses\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"7.0","items":{"type":"object","properties":{"scope":{"type":"string"},"locale":{"type":"string"},"data":{"type":"integer"}}}}},"example":{"identifier":"top","enabled":true,"family":"tshirt","categories":["summer_collection"],"groups":[],"parent":null,"values":{"name":[{"data":"Top","locale":"en_US","scope":null,"attribute_type":"pim_catalog_text"},{"data":"Débardeur","locale":"fr_FR","scope":null,"attribute_type":"pim_catalog_text"}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce","attribute_type":"pim_catalog_textarea"},{"data":"Top","locale":"en_US","scope":"tablet","attribute_type":"pim_catalog_textarea"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce","attribute_type":"pim_catalog_textarea"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet","attribute_type":"pim_catalog_textarea"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}],"attribute_type":"pim_catalog_price_collection"}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}},"attribute_type":"pim_catalog_simpleselect"}],"size":[{"locale":null,"scope":null,"data":"m","linked_data":{"attribute":"size","code":"m","labels":{"en_US":"M","fr_FR":"M"}},"attribute_type":"pim_catalog_simpleselect"}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"],"linked_data":{"winter_2016":{"attribute":"collection","code":"winter_2016","labels":{"en_US":"Winter 2016","fr_FR":"Hiver 2016"}}},"attribute_type":"pim_catalog_multiselect"}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglass"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"cap","quantity":2},{"identifier":"shoes","quantity":1}],"product_models":[{"identifier":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"completenesses":[{"scope":"ecommerce","locale":"en_US","data":10},{"scope":"ecommerce","locale":"fr_FR","data":20},{"scope":"tablet","locale":"en_US","data":30},{"scope":"tablet","locale":"fr_FR","data":40}]}},"ProductExamples":{"x-1.7":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=3&limit=3"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=1&limit=3"},"previous":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=2&limit=3"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=4&limit=3"}},"current_page":3,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/top"}},"identifier":"top","family":"tshirt","groups":[],"categories":["summer_collection"],"enabled":true,"values":{"name":[{"data":"Top","locale":"en_US","scope":null},{"data":"Débardeur","locale":"fr_FR","scope":null}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce"},{"data":"Top","locale":"en_US","scope":"tablet"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black"}],"size":[{"locale":null,"scope":null,"data":"m"}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"]}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglasses"],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"cap","quantity":2},{"identifier":"shoes","quantity":1}]}}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/cap"}},"identifier":"cap","family":"caps","groups":[],"categories":["summer_collection"],"enabled":true,"values":{"name":[{"data":"Cap","locale":"en_US","scope":null},{"data":"Casquette","locale":"fr_FR","scope":null}],"description":[{"data":"Cap unisex","locale":"en_US","scope":"ecommerce"},{"data":"Cap unisex","locale":"en_US","scope":"tablet"},{"data":"Casquette unisexe","locale":"fr_FR","scope":"ecommerce"},{"data":"Casquette unisexe","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"20","currency":"EUR"},{"amount":"20","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black"}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglasses"],"groups":[]}},"quantified_associations":{}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/sweat"}},"identifier":"sweat","family":null,"groups":[],"categories":["winter_collection"],"enabled":true,"values":{},"created":"2016-06-23T11:24:44+02:00","updated":"2016-06-23T11:24:44+02:00","associations":{},"quantified_associations":{}}]}},"x-2.0":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=3&limit=3"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=1&limit=3"},"previous":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=2&limit=3"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=4&limit=3"}},"current_page":3,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/top"}},"identifier":"top","family":"tshirt","groups":[],"parent":null,"categories":["summer_collection"],"enabled":true,"values":{"name":[{"data":"Top","locale":"en_US","scope":null},{"data":"Débardeur","locale":"fr_FR","scope":null}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce"},{"data":"Top","locale":"en_US","scope":"tablet"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black"}],"size":[{"locale":null,"scope":null,"data":"m"}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"]}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglasses"],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"cap","quantity":2},{"identifier":"shoes","quantity":1}]}}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/cap"}},"identifier":"cap","family":"caps","groups":[],"parent":null,"categories":["summer_collection"],"enabled":true,"values":{"name":[{"data":"Cap","locale":"en_US","scope":null},{"data":"Casquette","locale":"fr_FR","scope":null}],"description":[{"data":"Cap unisex","locale":"en_US","scope":"ecommerce"},{"data":"Cap unisex","locale":"en_US","scope":"tablet"},{"data":"Casquette unisexe","locale":"fr_FR","scope":"ecommerce"},{"data":"Casquette unisexe","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"20","currency":"EUR"},{"amount":"20","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black"}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglasses"],"groups":[]}},"quantified_associations":{}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/sweat"}},"identifier":"sweat","family":null,"groups":[],"parent":null,"categories":["winter_collection"],"enabled":true,"values":{},"created":"2016-06-23T11:24:44+02:00","updated":"2016-06-23T11:24:44+02:00","associations":{},"quantified_associations":{}}]}},"x-2.1":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=3&limit=3"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=1&limit=3"},"previous":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=2&limit=3"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=4&limit=3"}},"current_page":3,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/top"}},"identifier":"top","family":"tshirt","groups":[],"parent":null,"categories":["summer_collection"],"enabled":true,"values":{"name":[{"data":"Top","locale":"en_US","scope":null},{"data":"Débardeur","locale":"fr_FR","scope":null}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce"},{"data":"Top","locale":"en_US","scope":"tablet"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black"}],"size":[{"locale":null,"scope":null,"data":"m"}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"]}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglasses"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"cap","quantity":2},{"identifier":"shoes","quantity":1}],"product_models":[{"identifier":"model-biker-jacket-leather","quantity":2}]}}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/cap"}},"identifier":"cap","family":"caps","groups":[],"parent":null,"categories":["summer_collection"],"enabled":true,"values":{"name":[{"data":"Cap","locale":"en_US","scope":null},{"data":"Casquette","locale":"fr_FR","scope":null}],"description":[{"data":"Cap unisex","locale":"en_US","scope":"ecommerce"},{"data":"Cap unisex","locale":"en_US","scope":"tablet"},{"data":"Casquette unisexe","locale":"fr_FR","scope":"ecommerce"},{"data":"Casquette unisexe","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"20","currency":"EUR"},{"amount":"20","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black"}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglasses"],"product_models":[],"groups":[]}},"quantified_associations":{}},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/sweat"}},"identifier":"sweat","family":null,"groups":[],"parent":null,"categories":["winter_collection"],"enabled":true,"values":{},"created":"2016-06-23T11:24:44+02:00","updated":"2016-06-23T11:24:44+02:00","associations":{},"quantified_associations":{}}]}},"x-5.0":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=3&limit=3&with_quality_scores=true&with_attribute_options=true"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=1&limit=3&with_quality_scores=true&with_attribute_options=true"},"previous":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=2&limit=3&with_quality_scores=true&with_attribute_options=true"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=4&limit=3&with_quality_scores=true&with_attribute_options=true"}},"current_page":3,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/top"}},"identifier":"top","family":"tshirt","groups":[],"parent":null,"categories":["summer_collection"],"enabled":true,"values":{"name":[{"data":"Top","locale":"en_US","scope":null},{"data":"Débardeur","locale":"fr_FR","scope":null}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce"},{"data":"Top","locale":"en_US","scope":"tablet"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}}}],"size":[{"locale":null,"scope":null,"data":"m","linked_data":{"attribute":"size","code":"m","labels":{"en_US":"M","fr_FR":"M"}}}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"],"linked_data":{"winter_2016":{"attribute":"collection","code":"winter_2016","labels":{"en_US":"Winter 2016","fr_FR":"Hiver 2016"}}}}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglasses"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"cap","quantity":2},{"identifier":"shoes","quantity":1}],"product_models":[{"identifier":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}]},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/cap"}},"identifier":"cap","family":"caps","groups":[],"parent":null,"categories":["summer_collection"],"enabled":true,"values":{"name":[{"data":"Cap","locale":"en_US","scope":null},{"data":"Casquette","locale":"fr_FR","scope":null}],"description":[{"data":"Cap unisex","locale":"en_US","scope":"ecommerce"},{"data":"Cap unisex","locale":"en_US","scope":"tablet"},{"data":"Casquette unisexe","locale":"fr_FR","scope":"ecommerce"},{"data":"Casquette unisexe","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"20","currency":"EUR"},{"amount":"20","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}}}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglasses"],"product_models":[],"groups":[]}},"quantified_associations":{},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}]},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/sweat"}},"identifier":"sweat","family":null,"groups":[],"parent":null,"categories":["winter_collection"],"enabled":true,"values":{},"created":"2016-06-23T11:24:44+02:00","updated":"2016-06-23T11:24:44+02:00","associations":{},"quantified_associations":{},"quality_scores":{}}]}},"x-SaaS":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=3&limit=3&with_quality_scores=true&with_completenesses=true&with_attribute_options=true"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=1&limit=3&with_quality_scores=true&with_completenesses=true&with_attribute_options=true"},"previous":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=2&limit=3&with_quality_scores=true&with_completenesses=true&with_attribute_options=true"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/products?page=4&limit=3&with_quality_scores=true&with_completenesses=true&with_attribute_options=true"}},"current_page":3,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/top"}},"uuid":"aaf518b2-f91e-40f1-a53a-78ce5e81a6f9","identifier":"top","family":"tshirt","groups":[],"parent":null,"categories":["summer_collection"],"enabled":true,"values":{"name":[{"data":"Top","locale":"en_US","scope":null,"attribute_type":"pim_catalog_text"},{"data":"Débardeur","locale":"fr_FR","scope":null,"attribute_type":"pim_catalog_text"}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce","attribute_type":"pim_catalog_textarea"},{"data":"Top","locale":"en_US","scope":"tablet","attribute_type":"pim_catalog_textarea"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce","attribute_type":"pim_catalog_textarea"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet","attribute_type":"pim_catalog_textarea"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}],"attribute_type":"pim_catalog_price_collection"}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}},"attribute_type":"pim_catalog_simpleselect"}],"size":[{"locale":null,"scope":null,"data":"m","linked_data":{"attribute":"size","code":"m","labels":{"en_US":"M","fr_FR":"M"}},"attribute_type":"pim_catalog_simpleselect"}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"],"linked_data":{"winter_2016":{"attribute":"collection","code":"winter_2016","labels":{"en_US":"Winter 2016","fr_FR":"Hiver 2016"}}},"attribute_type":"pim_catalog_multiselect"}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglasses"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"cap","quantity":2},{"identifier":"shoes","quantity":1}],"product_models":[{"identifier":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"completenesses":[{"scope":"ecommerce","locale":"en_US","data":20},{"scope":"ecommerce","locale":"fr_FR","data":30},{"scope":"tablet","locale":"en_US","data":55},{"scope":"tablet","locale":"fr_FR","data":70}]},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/cap"}},"uuid":"aec6780b-c813-4bd7-8e24-1a8574471576","identifier":"cap","family":"caps","groups":[],"parent":null,"categories":["summer_collection"],"enabled":true,"values":{"name":[{"data":"Cap","locale":"en_US","scope":null},{"data":"Casquette","locale":"fr_FR","scope":null}],"description":[{"data":"Cap unisex","locale":"en_US","scope":"ecommerce"},{"data":"Cap unisex","locale":"en_US","scope":"tablet"},{"data":"Casquette unisexe","locale":"fr_FR","scope":"ecommerce"},{"data":"Casquette unisexe","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"20","currency":"EUR"},{"amount":"20","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}}}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglasses"],"product_models":[],"groups":[]}},"quantified_associations":{},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"completenesses":[{"scope":"ecommerce","locale":"en_US","data":20},{"scope":"ecommerce","locale":"fr_FR","data":30},{"scope":"tablet","locale":"en_US","data":55},{"scope":"tablet","locale":"fr_FR","data":70}]},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/sweat"}},"uuid":"93f14b03-5ed3-4f23-87c6-ae3806041b6a","identifier":"sweat","family":null,"groups":[],"parent":null,"categories":["winter_collection"],"enabled":true,"values":{},"created":"2016-06-23T11:24:44+02:00","updated":"2016-06-23T11:24:44+02:00","associations":{},"quantified_associations":{},"quality_scores":{},"completenesses":[]}]}}},"ProductList":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["identifier"],"properties":{"uuid":{"type":"string","description":"Product UUID","x-from-version":"7.0"},"identifier":{"type":"string","description":"Product identifier, i.e. the value of the only `pim_catalog_identifier` attribute"},"enabled":{"type":"boolean","description":"Whether the product is enabled","default":true},"family":{"type":"string","description":"Family code from which the product inherits its attributes and attributes requirements.","x-validation-rules":"It is equal to an existing family code. In the case of variant product, the given family should be the same as the product model family.","default":"null only in the case of a non variant product"},"categories":{"type":"array","description":"Codes of the categories in which the product is classified","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"groups":{"type":"array","description":"Codes of the groups to which the product belong","x-validation-rules":"Each string of the array is equal to an existing group code","items":{"type":"string"},"default":[]},"parent":{"type":"string","description":"Code of the parent product model when the product is a variant (only available since the 2.0). This parent can be modified since the 2.3.","x-validation-rules":"It is equal to an existing product model code only if the product is variant otherwise it's equal to null","default":"null","x-from-version":"2.0"},"values":{"type":"object","description":"Product attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value. See the `data` format section for more details."},"linked_data":{"type":"object","x-read-only":true,"description":"Object containing additional data when a related query parameter is enabled. See the `linked_data` format section for more details. (only available since the 5.0)","x-from-version":"5.0","properties":{"attribute":{"type":"string"},"code":{"type":"string"},"labels":{"type":"object"}}},"attribute_type":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"The type of the value's attribute. See type section for more details."},"reference_data_name":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"Reference entity code when the attribute type is `akeneo_reference_entity` or `akeneo_reference_entity_collection` OR Asset family code when the attribute type is `pim_catalog_asset_collection`","x-warning":"Only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types"}}}}}},"associations":{"type":"object","description":"Several associations related to groups, product models and/or other products, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the identifier of an existing product. • Each string in the array of the property `product_models` is the code of an existing product model.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of product identifiers with which the product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Several quantified associations related to products and/or product models, grouped by quantified association types (only available since the 5.0)","x-validation-rules":"• The `quantifiedAssociationTypeCode` is the code of an existing association type which provides quantity information. • Each object in the array of the property `products` contains the identifier of an existing product and the quantity of it.","x-from-version":"5.0","properties":{"quantifiedAssociationTypeCode":{"type":"object","properties":{"products":{"type":"array","description":"Array of objects containing product identifiers and quantities with which the product is in relation","items":{"type":"object","properties":{"identifier":{"type":"string"},"quantity":{"type":"integer"}}}},"product_models":{"type":"array","description":"Array of objects containing product model codes and quantities with which the product is in relation","items":{"type":"object","properties":{"code":{"type":"string"},"quantity":{"type":"integer"}}}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"metadata":{"type":"object","description":"More information around the product (only available since the v2.0 in the Enterprise Edition)","x-immutable":true,"x-read-only":true,"x-from-version":"2.0","properties":{"workflow_status":{"description":"Status of the product regarding the user permissions","type":"string","enum":["read_only","draft_in_progress","proposal_waiting_for_approval","working_copy"]}}},"quality_scores":{"type":"object","description":"Product quality scores for each channel/locale combination (only available since the 5.0 and when the \"with_quality_scores\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"5.0"},"completenesses":{"type":"array","description":"Product completenesses for each channel/locale combination (only available since the 7.0 version, and when the \"with_completenesses\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"7.0","items":{"type":"object","properties":{"scope":{"type":"string"},"locale":{"type":"string"},"data":{"type":"integer"}}}}},"example":{"identifier":"top","enabled":true,"family":"tshirt","categories":["summer_collection"],"groups":[],"parent":null,"values":{"name":[{"data":"Top","locale":"en_US","scope":null,"attribute_type":"pim_catalog_text"},{"data":"Débardeur","locale":"fr_FR","scope":null,"attribute_type":"pim_catalog_text"}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce","attribute_type":"pim_catalog_textarea"},{"data":"Top","locale":"en_US","scope":"tablet","attribute_type":"pim_catalog_textarea"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce","attribute_type":"pim_catalog_textarea"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet","attribute_type":"pim_catalog_textarea"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}],"attribute_type":"pim_catalog_price_collection"}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}},"attribute_type":"pim_catalog_simpleselect"}],"size":[{"locale":null,"scope":null,"data":"m","linked_data":{"attribute":"size","code":"m","labels":{"en_US":"M","fr_FR":"M"}},"attribute_type":"pim_catalog_simpleselect"}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"],"linked_data":{"winter_2016":{"attribute":"collection","code":"winter_2016","labels":{"en_US":"Winter 2016","fr_FR":"Hiver 2016"}}},"attribute_type":"pim_catalog_multiselect"}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglass"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"cap","quantity":2},{"identifier":"shoes","quantity":1}],"product_models":[{"identifier":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"completenesses":[{"scope":"ecommerce","locale":"en_US","data":10},{"scope":"ecommerce","locale":"fr_FR","data":20},{"scope":"tablet","locale":"en_US","data":30},{"scope":"tablet","locale":"fr_FR","data":40}]}}]},"ProductUuid":{"type":"object","properties":{"uuid":{"type":"string","description":"Product uuid"},"enabled":{"type":"boolean","description":"Whether the product is enabled","default":true},"family":{"type":"string","description":"Family code from which the product inherits its attributes and attributes requirements.","x-validation-rules":"It is equal to an existing family code. In the case of variant product, the given family should be the same as the product model family.","default":"null only in the case of a non variant product"},"categories":{"type":"array","description":"Codes of the categories in which the product is classified","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"groups":{"type":"array","description":"Codes of the groups to which the product belong","x-validation-rules":"Each string of the array is equal to an existing group code","items":{"type":"string"},"default":[]},"parent":{"type":"string","description":"Code of the parent product model when the product is a variant (only available since the 2.0). This parent can be modified since the 2.3.","x-validation-rules":"It is equal to an existing product model code only if the product is variant otherwise it's equal to null","default":"null","x-from-version":"2.0"},"values":{"type":"object","description":"Product attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value. See the `data` format section for more details."},"linked_data":{"type":"object","x-read-only":true,"description":"Object containing additional data when a related query parameter is enabled. See the `linked_data` format section for more details. (only available since the 5.0)","x-from-version":"5.0","properties":{"attribute":{"type":"string"},"code":{"type":"string"},"labels":{"type":"object"}}},"attribute_type":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"The type of the value's attribute. See type section for more details."},"reference_data_name":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"Reference entity code when the attribute type is `akeneo_reference_entity` or `akeneo_reference_entity_collection` OR Asset family code when the attribute type is `pim_catalog_asset_collection`","x-warning":"Only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types"}}}}}},"associations":{"type":"object","description":"Several associations related to groups, product models and/or other products, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the uuid of an existing product. • Each string in the array of the property `product_models` is the code of an existing product model.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of product uuids with which the product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Several quantified associations related to products and/or product models, grouped by quantified association types (only available since the 5.0)","x-validation-rules":"• The `quantifiedAssociationTypeCode` is the code of an existing association type which provides quantity information. • Each object in the array of the property `products` contains the uuid of an existing product and the quantity of it.","x-from-version":"5.0","properties":{"quantifiedAssociationTypeCode":{"type":"object","properties":{"products":{"type":"array","description":"Array of objects containing product uuids and quantities with which the product is in relation","items":{"type":"object","properties":{"uuid":{"type":"string"},"quantity":{"type":"integer"}}}},"product_models":{"type":"array","description":"Array of objects containing product model codes and quantities with which the product is in relation","items":{"type":"object","properties":{"code":{"type":"string"},"quantity":{"type":"integer"}}}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"metadata":{"type":"object","description":"More information around the product (only available since the v2.0 in the Enterprise Edition)","x-immutable":true,"x-read-only":true,"x-from-version":"2.0","properties":{"workflow_status":{"description":"Status of the product regarding the user permissions","type":"string","enum":["read_only","draft_in_progress","proposal_waiting_for_approval","working_copy"]}}},"quality_scores":{"type":"object","description":"Product quality scores for each channel/locale combination (only available since the 5.0 and when the \"with_quality_scores\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"5.0"},"completenesses":{"type":"array","description":"Product completenesses for each channel/locale combination (only available since the 7.0 version, and when the \"with_completenesses\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"7.0","items":{"type":"object","properties":{"scope":{"type":"string"},"locale":{"type":"string"},"data":{"type":"integer"}}}}},"example":{"uuid":"25566245-55c3-42ce-86d9-8610ac459fa8","enabled":true,"family":"tshirt","categories":["summer_collection"],"groups":[],"parent":null,"values":{"sku":[{"data":"top","locale":null,"scope":null}],"name":[{"data":"Top","locale":"en_US","scope":null},{"data":"Débardeur","locale":"fr_FR","scope":null}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce"},{"data":"Top","locale":"en_US","scope":"tablet"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}}}],"size":[{"locale":null,"scope":null,"data":"m","linked_data":{"attribute":"size","code":"m","labels":{"en_US":"M","fr_FR":"M"}}}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"],"linked_data":{"winter_2016":{"attribute":"collection","code":"winter_2016","labels":{"en_US":"Winter 2016","fr_FR":"Hiver 2016"}}}}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["d055527c-0698-4967-8f16-8a5f23f4e5cf"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"uuid":"fc24e6c3-933c-4a93-8a81-e5c703d134d5","quantity":2},{"uuid":"a9b69002-a0b1-4ead-85c2-f8dbf59c6cfc","quantity":1}],"product_models":[{"identifier":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"completenesses":[{"scope":"ecommerce","locale":"en_US","data":10},{"scope":"ecommerce","locale":"fr_FR","data":20},{"scope":"tablet","locale":"en_US","data":30},{"scope":"tablet","locale":"fr_FR","data":40}]}},"ProductUuidExamples":{"x-SaaS":{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/products-uuid?page=3&limit=3&with_quality_scores=true&with_completenesses=true&with_attribute_options=true"},"first":{"href":"https://demo.akeneo.com/api/rest/v1/products-uuid?page=1&limit=3&with_quality_scores=true&with_completenesses=true&with_attribute_options=true"},"previous":{"href":"https://demo.akeneo.com/api/rest/v1/products-uuid?page=2&limit=3&with_quality_scores=true&with_completenesses=true&with_attribute_options=true"},"next":{"href":"https://demo.akeneo.com/api/rest/v1/products-uuid?page=4&limit=3&with_quality_scores=true&with_completenesses=true&with_attribute_options=true"}},"current_page":3,"_embedded":{"items":[{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product-uuid/25566245-55c3-42ce-86d9-8610ac459fa8"}},"uuid":"25566245-55c3-42ce-86d9-8610ac459fa8","family":"tshirt","groups":[],"parent":null,"categories":["summer_collection"],"enabled":true,"values":{"sku":[{"data":"top","locale":null,"scope":null,"attribute_type":"pim_catalog_identifier"}],"name":[{"data":"Top","locale":"en_US","scope":null,"attribute_type":"pim_catalog_text"},{"data":"Débardeur","locale":"fr_FR","scope":null,"attribute_type":"pim_catalog_text"}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce","attribute_type":"pim_catalog_textarea"},{"data":"Top","locale":"en_US","scope":"tablet","attribute_type":"pim_catalog_textarea"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce","attribute_type":"pim_catalog_textarea"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet","attribute_type":"pim_catalog_textarea"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}],"attribute_type":"pim_catalog_price_collection"}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}},"attribute_type":"pim_catalog_simpleselect"}],"size":[{"locale":null,"scope":null,"data":"m","linked_data":{"attribute":"size","code":"m","labels":{"en_US":"M","fr_FR":"M"}},"attribute_type":"pim_catalog_simpleselect"}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"],"linked_data":{"winter_2016":{"attribute":"collection","code":"winter_2016","labels":{"en_US":"Winter 2016","fr_FR":"Hiver 2016"}}},"attribute_type":"pim_catalog_multiselect"}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["d055527c-0698-4967-8f16-8a5f23f4e5cf"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"uuid":"fc24e6c3-933c-4a93-8a81-e5c703d134d5","quantity":2},{"uuid":"a9b69002-a0b1-4ead-85c2-f8dbf59c6cfc","quantity":1}],"product_models":[{"identifier":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"completenesses":[{"scope":"ecommerce","locale":"en_US","data":20},{"scope":"ecommerce","locale":"fr_FR","data":30},{"scope":"tablet","locale":"en_US","data":55},{"scope":"tablet","locale":"fr_FR","data":70}]},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product/fc24e6c3-933c-4a93-8a81-e5c703d134d5"}},"uuid":"fc24e6c3-933c-4a93-8a81-e5c703d134d5","family":"caps","groups":[],"parent":null,"categories":["summer_collection"],"enabled":true,"values":{"sku":[{"data":"cap","locale":null,"scope":null}],"name":[{"data":"Cap","locale":"en_US","scope":null},{"data":"Casquette","locale":"fr_FR","scope":null}],"description":[{"data":"Cap unisex","locale":"en_US","scope":"ecommerce"},{"data":"Cap unisex","locale":"en_US","scope":"tablet"},{"data":"Casquette unisexe","locale":"fr_FR","scope":"ecommerce"},{"data":"Casquette unisexe","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"20","currency":"EUR"},{"amount":"20","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}}}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["d055527c-0698-4967-8f16-8a5f23f4e5cf"],"product_models":[],"groups":[]}},"quantified_associations":{},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"completenesses":[{"scope":"ecommerce","locale":"en_US","data":20},{"scope":"ecommerce","locale":"fr_FR","data":30},{"scope":"tablet","locale":"en_US","data":55},{"scope":"tablet","locale":"fr_FR","data":70}]},{"_links":{"self":{"href":"https://demo.akeneo.com/api/rest/v1/product-uuid/fa0b115e-46ec-4527-beab-7207452f1b47"}},"uuid":"fa0b115e-46ec-4527-beab-7207452f1b47","family":null,"groups":[],"parent":null,"categories":["winter_collection"],"enabled":true,"values":{"sku":[{"data":"sweat","locale":null,"scope":null}]},"created":"2016-06-23T11:24:44+02:00","updated":"2016-06-23T11:24:44+02:00","associations":{},"quantified_associations":{},"quality_scores":{},"completenesses":[]}]}}},"ProductUuidList":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","properties":{"uuid":{"type":"string","description":"Product uuid"},"enabled":{"type":"boolean","description":"Whether the product is enabled","default":true},"family":{"type":"string","description":"Family code from which the product inherits its attributes and attributes requirements.","x-validation-rules":"It is equal to an existing family code. In the case of variant product, the given family should be the same as the product model family.","default":"null only in the case of a non variant product"},"categories":{"type":"array","description":"Codes of the categories in which the product is classified","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"groups":{"type":"array","description":"Codes of the groups to which the product belong","x-validation-rules":"Each string of the array is equal to an existing group code","items":{"type":"string"},"default":[]},"parent":{"type":"string","description":"Code of the parent product model when the product is a variant (only available since the 2.0). This parent can be modified since the 2.3.","x-validation-rules":"It is equal to an existing product model code only if the product is variant otherwise it's equal to null","default":"null","x-from-version":"2.0"},"values":{"type":"object","description":"Product attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value. See the `data` format section for more details."},"linked_data":{"type":"object","x-read-only":true,"description":"Object containing additional data when a related query parameter is enabled. See the `linked_data` format section for more details. (only available since the 5.0)","x-from-version":"5.0","properties":{"attribute":{"type":"string"},"code":{"type":"string"},"labels":{"type":"object"}}},"attribute_type":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"The type of the value's attribute. See type section for more details."},"reference_data_name":{"type":"string","x-read-only":true,"x-from-version":"SaaS","description":"Reference entity code when the attribute type is `akeneo_reference_entity` or `akeneo_reference_entity_collection` OR Asset family code when the attribute type is `pim_catalog_asset_collection`","x-warning":"Only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types"}}}}}},"associations":{"type":"object","description":"Several associations related to groups, product models and/or other products, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the uuid of an existing product. • Each string in the array of the property `product_models` is the code of an existing product model.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of product uuids with which the product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Several quantified associations related to products and/or product models, grouped by quantified association types (only available since the 5.0)","x-validation-rules":"• The `quantifiedAssociationTypeCode` is the code of an existing association type which provides quantity information. • Each object in the array of the property `products` contains the uuid of an existing product and the quantity of it.","x-from-version":"5.0","properties":{"quantifiedAssociationTypeCode":{"type":"object","properties":{"products":{"type":"array","description":"Array of objects containing product uuids and quantities with which the product is in relation","items":{"type":"object","properties":{"uuid":{"type":"string"},"quantity":{"type":"integer"}}}},"product_models":{"type":"array","description":"Array of objects containing product model codes and quantities with which the product is in relation","items":{"type":"object","properties":{"code":{"type":"string"},"quantity":{"type":"integer"}}}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"metadata":{"type":"object","description":"More information around the product (only available since the v2.0 in the Enterprise Edition)","x-immutable":true,"x-read-only":true,"x-from-version":"2.0","properties":{"workflow_status":{"description":"Status of the product regarding the user permissions","type":"string","enum":["read_only","draft_in_progress","proposal_waiting_for_approval","working_copy"]}}},"quality_scores":{"type":"object","description":"Product quality scores for each channel/locale combination (only available since the 5.0 and when the \"with_quality_scores\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"5.0"},"completenesses":{"type":"array","description":"Product completenesses for each channel/locale combination (only available since the 7.0 version, and when the \"with_completenesses\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"7.0","items":{"type":"object","properties":{"scope":{"type":"string"},"locale":{"type":"string"},"data":{"type":"integer"}}}}},"example":{"uuid":"25566245-55c3-42ce-86d9-8610ac459fa8","enabled":true,"family":"tshirt","categories":["summer_collection"],"groups":[],"parent":null,"values":{"sku":[{"data":"top","locale":null,"scope":null}],"name":[{"data":"Top","locale":"en_US","scope":null},{"data":"Débardeur","locale":"fr_FR","scope":null}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce"},{"data":"Top","locale":"en_US","scope":"tablet"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black","linked_data":{"attribute":"color","code":"black","labels":{"en_US":"Black","fr_FR":"Noir"}}}],"size":[{"locale":null,"scope":null,"data":"m","linked_data":{"attribute":"size","code":"m","labels":{"en_US":"M","fr_FR":"M"}}}],"collection":[{"locale":null,"scope":null,"data":["winter_2016"],"linked_data":{"winter_2016":{"attribute":"collection","code":"winter_2016","labels":{"en_US":"Winter 2016","fr_FR":"Hiver 2016"}}}}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["d055527c-0698-4967-8f16-8a5f23f4e5cf"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"uuid":"fc24e6c3-933c-4a93-8a81-e5c703d134d5","quantity":2},{"uuid":"a9b69002-a0b1-4ead-85c2-f8dbf59c6cfc","quantity":1}],"product_models":[{"identifier":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"completenesses":[{"scope":"ecommerce","locale":"en_US","data":10},{"scope":"ecommerce","locale":"fr_FR","data":20},{"scope":"tablet","locale":"en_US","data":30},{"scope":"tablet","locale":"fr_FR","data":40}]}}]},"ProductModel":{"type":"object","required":["code","family_variant"],"properties":{"code":{"type":"string","description":"Product model code","x-immutable":true},"family":{"type":"string","description":"Family code from which the product inherits its attributes and attributes requirements (since the 3.2)","x-validation-rules":"It is equal to an existing family code","x-immutable":true,"x-from-version":"3.2"},"family_variant":{"type":"string","description":"Family variant code from which the product model inherits its attributes and variant attributes","x-validation-rules":"It is equal to an existing family variant code that belong to the family given in the `family` field","x-immutable":true},"parent":{"type":"string","description":"Code of the parent product model. This parent can be modified since the 2.3.","x-validation-rules":"• It is equal to an existing product model code • This product model has the same family variant as the one given in the `family_variant field`","default":"null","x-from-version":"2.3"},"categories":{"type":"array","description":"Codes of the categories in which the product model is categorized","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"values":{"type":"object","description":"Product model attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value"},"linked_data":{"type":"object","x-read-only":true,"description":"Object containing additional data when a related query parameter is enabled. See the `linked_data` format section for more details. (only available since the 5.0)","x-from-version":"SaaS","properties":{"attribute":{"type":"string"},"code":{"type":"string"},"labels":{"type":"object"}}}}}}}},"associations":{"type":"object","description":"Several associations related to groups, product and/or other product models, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the identifier of an existing product. • Each string in the array of the property `product_models` is the code of an existing product model.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of product identifiers with which the product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Several quantified associations related to products and/or product models, grouped by quantified association types (only available since the 5.0)","x-validation-rules":"• The `quantifiedAssociationTypeCode` is the code of an existing association type which provides quantity information. • Each object in the array of the property `products` contains the identifier of an existing product and the quantity of it. • Each object in the array of the property `product_models` contains the code of an existing product model and the quantity of it.","x-from-version":"5.0","properties":{"quantifiedAssociationTypeCode":{"type":"object","properties":{"products":{"type":"array","description":"Array of objects containing product identifiers and quantities with which the product model is in relation","items":{"type":"object","properties":{"identifier":{"type":"string"},"quantity":{"type":"integer"}}}},"product_models":{"type":"array","description":"Array of objects containing product model codes and quantities with which the product model is in relation","items":{"type":"object","properties":{"code":{"type":"string"},"quantity":{"type":"integer"}}}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"metadata":{"type":"object","description":"More information around the product model (only available since the v2.3 in the Enterprise Edition)","x-immutable":true,"x-read-only":true,"x-from-version":"2.3","properties":{"workflow_status":{"description":"Status of the product model regarding the user permissions","type":"string","enum":["read_only","draft_in_progress","proposal_waiting_for_approval","working_copy"]}}},"quality_scores":{"type":"object","description":"Product model quality scores for each channel/locale combination (only available since the 7.0 version and when the \"with_quality_scores\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"7.0"}},"example":{"code":"model-biker-jacket-leather","family":"clothing","family_variant":"clothing_material_size","parent":"model-biker-jacket","categories":["summer_collection"],"values":{"color":[{"locale":null,"scope":null,"data":"antique_white"}],"material":[{"locale":null,"scope":null,"data":"leather"}],"variation_name":[{"locale":"en_US","scope":null,"data":"Biker jacket leather"}],"name":[{"locale":"en_US","scope":null,"data":"Biker jacket"}],"collection":[{"locale":null,"scope":null,"data":["summer_2017"]}],"description":[{"locale":"en_US","scope":"ecommerce","data":"Biker jacket"}]},"associations":{"PACK":{"products":["sunglass"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"top","quantity":2},{"identifier":"cap","quantity":1}],"product_models":[{"code":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"created":"2017-10-02T15:03:55+02:00","updated":"2017-10-02T15:03:55+02:00"}},"ProductModelList":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code","family_variant"],"properties":{"code":{"type":"string","description":"Product model code","x-immutable":true},"family":{"type":"string","description":"Family code from which the product inherits its attributes and attributes requirements (since the 3.2)","x-validation-rules":"It is equal to an existing family code","x-immutable":true,"x-from-version":"3.2"},"family_variant":{"type":"string","description":"Family variant code from which the product model inherits its attributes and variant attributes","x-validation-rules":"It is equal to an existing family variant code that belong to the family given in the `family` field","x-immutable":true},"parent":{"type":"string","description":"Code of the parent product model. This parent can be modified since the 2.3.","x-validation-rules":"• It is equal to an existing product model code • This product model has the same family variant as the one given in the `family_variant field`","default":"null","x-from-version":"2.3"},"categories":{"type":"array","description":"Codes of the categories in which the product model is categorized","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"values":{"type":"object","description":"Product model attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value"},"linked_data":{"type":"object","x-read-only":true,"description":"Object containing additional data when a related query parameter is enabled. See the `linked_data` format section for more details. (only available since the 5.0)","x-from-version":"SaaS","properties":{"attribute":{"type":"string"},"code":{"type":"string"},"labels":{"type":"object"}}}}}}}},"associations":{"type":"object","description":"Several associations related to groups, product and/or other product models, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the identifier of an existing product. • Each string in the array of the property `product_models` is the code of an existing product model.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of product identifiers with which the product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Several quantified associations related to products and/or product models, grouped by quantified association types (only available since the 5.0)","x-validation-rules":"• The `quantifiedAssociationTypeCode` is the code of an existing association type which provides quantity information. • Each object in the array of the property `products` contains the identifier of an existing product and the quantity of it. • Each object in the array of the property `product_models` contains the code of an existing product model and the quantity of it.","x-from-version":"5.0","properties":{"quantifiedAssociationTypeCode":{"type":"object","properties":{"products":{"type":"array","description":"Array of objects containing product identifiers and quantities with which the product model is in relation","items":{"type":"object","properties":{"identifier":{"type":"string"},"quantity":{"type":"integer"}}}},"product_models":{"type":"array","description":"Array of objects containing product model codes and quantities with which the product model is in relation","items":{"type":"object","properties":{"code":{"type":"string"},"quantity":{"type":"integer"}}}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"metadata":{"type":"object","description":"More information around the product model (only available since the v2.3 in the Enterprise Edition)","x-immutable":true,"x-read-only":true,"x-from-version":"2.3","properties":{"workflow_status":{"description":"Status of the product model regarding the user permissions","type":"string","enum":["read_only","draft_in_progress","proposal_waiting_for_approval","working_copy"]}}},"quality_scores":{"type":"object","description":"Product model quality scores for each channel/locale combination (only available since the 7.0 version and when the \"with_quality_scores\" query parameter is set to \"true\")","x-immutable":true,"x-read-only":true,"x-from-version":"7.0"}},"example":{"code":"model-biker-jacket-leather","family":"clothing","family_variant":"clothing_material_size","parent":"model-biker-jacket","categories":["summer_collection"],"values":{"color":[{"locale":null,"scope":null,"data":"antique_white"}],"material":[{"locale":null,"scope":null,"data":"leather"}],"variation_name":[{"locale":"en_US","scope":null,"data":"Biker jacket leather"}],"name":[{"locale":"en_US","scope":null,"data":"Biker jacket"}],"collection":[{"locale":null,"scope":null,"data":["summer_2017"]}],"description":[{"locale":"en_US","scope":"ecommerce","data":"Biker jacket"}]},"associations":{"PACK":{"products":["sunglass"],"product_models":[],"groups":[]}},"quantified_associations":{"PRODUCT_SET":{"products":[{"identifier":"top","quantity":2},{"identifier":"cap","quantity":1}],"product_models":[{"code":"model-biker-jacket-leather","quantity":2}]}},"quality_scores":[{"scope":"ecommerce","locale":"en_US","data":"A"},{"scope":"ecommerce","locale":"fr_FR","data":"B"},{"scope":"tablet","locale":"en_US","data":"D"},{"scope":"tablet","locale":"fr_FR","data":"E"}],"created":"2017-10-02T15:03:55+02:00","updated":"2017-10-02T15:03:55+02:00"}}]},"PublishedProduct":{"type":"object","required":["identifier"],"properties":{"identifier":{"type":"string","description":"Published product identifier, i.e. the value of the only `pim_catalog_identifier` attribute"},"enabled":{"type":"boolean","description":"Whether the published product is enable","default":true},"family":{"type":"string","description":"Family code from which the published product inherits its attributes and attributes requirements","x-validation-rules":"It is equal to an existing family code","default":"null"},"categories":{"type":"array","description":"Codes of the categories in which the published product is classified","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"groups":{"type":"array","description":"Codes of the groups to which the published product belong","x-validation-rules":"Each string of the array is equal to an existing group code","items":{"type":"string"},"default":[]},"values":{"type":"object","description":"Published product attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value"}}}}}},"associations":{"type":"object","description":"Several associations related to groups and/or other published products, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the identifier of an existing product. • Identifiers used in the array of the property `products` cannot be equal to the published product identifier.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the published product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of published product identifiers with which the published product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Warning: associations with quantities are not compatible with the published products. The response will always be empty."},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true}},"example":{"identifier":"top","enabled":true,"family":"tshirt","categories":["summer_collection"],"groups":[],"values":{"name":[{"data":"Top","locale":"en_US","scope":null},{"data":"Débardeur","locale":"fr_FR","scope":null}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce"},{"data":"Top","locale":"en_US","scope":"tablet"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black"}],"size":[{"locale":null,"scope":null,"data":"m"}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglass"],"product_models":[],"groups":[]}}}},"PublishedProductList":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["identifier"],"properties":{"identifier":{"type":"string","description":"Published product identifier, i.e. the value of the only `pim_catalog_identifier` attribute"},"enabled":{"type":"boolean","description":"Whether the published product is enable","default":true},"family":{"type":"string","description":"Family code from which the published product inherits its attributes and attributes requirements","x-validation-rules":"It is equal to an existing family code","default":"null"},"categories":{"type":"array","description":"Codes of the categories in which the published product is classified","x-validation-rules":"Each string of the array is equal to an existing category code","items":{"type":"string"},"default":[]},"groups":{"type":"array","description":"Codes of the groups to which the published product belong","x-validation-rules":"Each string of the array is equal to an existing group code","items":{"type":"string"},"default":[]},"values":{"type":"object","description":"Published product attributes values, see Product values section for more details","x-validation-rules":"Validation rules detailed in Product values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"Channel code of the product value"},"locale":{"type":"string","description":"Locale code of the product value"},"data":{"type":"object","description":"Product value"}}}}}},"associations":{"type":"object","description":"Several associations related to groups and/or other published products, grouped by association types","x-validation-rules":"• The `associationTypeCode` is the code of an existing association type. • Each string in the array of the property `groups` is the code of an existing group. • Each string in the array of the property `products` is the identifier of an existing product. • Identifiers used in the array of the property `products` cannot be equal to the published product identifier.","properties":{"associationTypeCode":{"type":"object","properties":{"groups":{"type":"array","description":"Array of groups codes with which the published product is in relation","items":{"type":"string"}},"products":{"type":"array","description":"Array of published product identifiers with which the published product is in relation","items":{"type":"string"}},"product_models":{"type":"array","description":"Array of product model codes with which the product is in relation (only available since the v2.1)","x-from-version":"2.1","items":{"type":"string"}}}}}},"quantified_associations":{"type":"object","description":"Warning: associations with quantities are not compatible with the published products. The response will always be empty."},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true}},"example":{"identifier":"top","enabled":true,"family":"tshirt","categories":["summer_collection"],"groups":[],"values":{"name":[{"data":"Top","locale":"en_US","scope":null},{"data":"Débardeur","locale":"fr_FR","scope":null}],"description":[{"data":"Summer top","locale":"en_US","scope":"ecommerce"},{"data":"Top","locale":"en_US","scope":"tablet"},{"data":"Débardeur pour l'été","locale":"fr_FR","scope":"ecommerce"},{"data":"Débardeur","locale":"fr_FR","scope":"tablet"}],"price":[{"locale":null,"scope":null,"data":[{"amount":"15.5","currency":"EUR"},{"amount":"15","currency":"USD"}]}],"color":[{"locale":null,"scope":null,"data":"black"}],"size":[{"locale":null,"scope":null,"data":"m"}]},"created":"2016-06-23T18:24:44+02:00","updated":"2016-06-25T17:56:12+02:00","associations":{"PACK":{"products":["sunglass"],"product_models":[],"groups":[]}}}}]},"ReferenceEntity":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","x-read-only":true,"properties":{"image_download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the binaries of the reference entity image file"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Reference entity code","x-immutable":true},"labels":{"type":"object","description":"Reference entity labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Reference entity label for the locale `localeCode`"}}},"image":{"type":"string","description":"Code of the reference entity image","default":null}},"example":{"code":"brands","labels":{"en_US":"Brands","fr_FR":"Marques"},"image":"0/2/d/6/54d81dc888ba1501a8g765f3ab5797569f3bv756c_ref_img.png"}}],"example":{"_links":{"image_download":{"href":"https://demo.akeneo.com/api/rest/v1/reference-entities-media-files/0/2/d/6/54d81dc888ba1501a8g765f3ab5797569f3bv756c_ref_img.png"}},"code":"brands","labels":{"en_US":"Brands","fr_FR":"Marques"},"image":"0/2/d/6/54d81dc888ba1501a8g765f3ab5797569f3bv756c_ref_img.png"}},"ReferenceEntityList":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}},"image_download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the binaries of the reference entity image file"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Reference entity code","x-immutable":true},"labels":{"type":"object","description":"Reference entity labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Reference entity label for the locale `localeCode`"}}},"image":{"type":"string","description":"Code of the reference entity image","default":null}},"example":{"code":"brands","labels":{"en_US":"Brands","fr_FR":"Marques"},"image":"0/2/d/6/54d81dc888ba1501a8g765f3ab5797569f3bv756c_ref_img.png"}}]},"ReferenceEntityAttribute":{"type":"object","required":["code","type"],"properties":{"code":{"type":"string","description":"Attribute code","x-immutable":true},"labels":{"type":"object","description":"Attribute labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute label for the locale `localeCode`"}}},"type":{"type":"string","description":"Attribute type. See type section for more details.","enum":["text","image","number","single_option","multiple_options","reference_entity_single_link","reference_entity_multiple_links"],"x-immutable":true},"value_per_locale":{"type":"boolean","description":"Whether the attribute is localizable, i.e. can have one value by locale","default":false,"x-immutable":true},"value_per_channel":{"type":"boolean","description":"Whether the attribute is scopable, i.e. can have one value by channel","default":false,"x-immutable":true},"is_required_for_completeness":{"type":"boolean","description":"Whether the attribute should be part of the record's completeness calculation","default":false},"max_characters":{"type":"integer","description":"Maximum number of characters allowed for the value of the attribute when the attribute type is `text`","x-warning":"Only for `text` attribute type"},"is_textarea":{"type":"boolean","description":"Whether the UI should display a text area instead of a simple field when the attribute type is `text`","default":false,"x-warning":"Only for `text` attribute type"},"is_rich_text_editor":{"type":"boolean","description":"Whether the UI should display a rich text editor instead of a simple text area when the attribute type is `text`","x-validation-rules":"Required when the property `is_textarea` is equal to `true`","x-warning":"Only for `text` attribute type"},"validation_rule":{"type":"string","description":"Validation rule type used to validate the attribute value when the attribute type is `text`","default":"none","x-warning":"Only for `text` attribute type","enum":["email","url","regexp","none"]},"validation_regexp":{"type":"string","description":"Regexp expression used to validate the attribute value when the attribute type is `text`","default":null,"x-validation-rules":"Required when the property `validation_rule` is equal to `regexp`","x-warning":"Only for `text` attribute type"},"allowed_extensions":{"type":"array","description":"Extensions allowed when the attribute type is `image`","default":[],"x-warning":"Only for `image` attribute type","items":{"type":"string"}},"max_file_size":{"type":"string","description":"Max file size in MB when the attribute type is `image`","default":null,"x-warning":"Only for `image` attribute type"},"reference_entity_code":{"type":"string","description":"Code of the linked reference entity when the attribute type is `reference_entity_single_link` or `reference_entity_multiple_links`","default":null,"x-validation-rules":"Required when the attribute type is either `reference_entity_single_link` or `reference_entity_multiple_links`","x-warning":"Only for `reference_entity_single_link` and `reference_entity_multiple_links` attribute type","x-immutable":true},"decimals_allowed":{"type":"boolean","description":"Whether decimals are allowed when the attribute type is `number`","default":false,"x-warning":"Only for `number` attribute type"},"min_value":{"type":"string","description":"Minimum value allowed when the attribute type is `number`","default":null,"x-validation-rules":"The minimum value must be lower than the maximum value","x-warning":"Only for `number` attribute type"},"max_value":{"type":"string","description":"Maximum value allowed when the attribute type is `number`","default":null,"x-validation-rules":"The maximum value must be greater than the minimum value","x-warning":"Only for `number` attribute type"}},"example":{"code":"description","labels":{"en_US":"Description","fr_FR":"Description"},"type":"text","value_per_locale":true,"value_per_channel":false,"is_required_for_completeness":true,"max_characters":null,"is_textarea":true,"is_rich_text_editor":true,"validation_rule":"none","validation_regexp":null}},"ReferenceEntityAttributeList":{"type":"array","items":{"type":"object","required":["code","type"],"properties":{"code":{"type":"string","description":"Attribute code","x-immutable":true},"labels":{"type":"object","description":"Attribute labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute label for the locale `localeCode`"}}},"type":{"type":"string","description":"Attribute type. See type section for more details.","enum":["text","image","number","single_option","multiple_options","reference_entity_single_link","reference_entity_multiple_links"],"x-immutable":true},"value_per_locale":{"type":"boolean","description":"Whether the attribute is localizable, i.e. can have one value by locale","default":false,"x-immutable":true},"value_per_channel":{"type":"boolean","description":"Whether the attribute is scopable, i.e. can have one value by channel","default":false,"x-immutable":true},"is_required_for_completeness":{"type":"boolean","description":"Whether the attribute should be part of the record's completeness calculation","default":false},"max_characters":{"type":"integer","description":"Maximum number of characters allowed for the value of the attribute when the attribute type is `text`","x-warning":"Only for `text` attribute type"},"is_textarea":{"type":"boolean","description":"Whether the UI should display a text area instead of a simple field when the attribute type is `text`","default":false,"x-warning":"Only for `text` attribute type"},"is_rich_text_editor":{"type":"boolean","description":"Whether the UI should display a rich text editor instead of a simple text area when the attribute type is `text`","x-validation-rules":"Required when the property `is_textarea` is equal to `true`","x-warning":"Only for `text` attribute type"},"validation_rule":{"type":"string","description":"Validation rule type used to validate the attribute value when the attribute type is `text`","default":"none","x-warning":"Only for `text` attribute type","enum":["email","url","regexp","none"]},"validation_regexp":{"type":"string","description":"Regexp expression used to validate the attribute value when the attribute type is `text`","default":null,"x-validation-rules":"Required when the property `validation_rule` is equal to `regexp`","x-warning":"Only for `text` attribute type"},"allowed_extensions":{"type":"array","description":"Extensions allowed when the attribute type is `image`","default":[],"x-warning":"Only for `image` attribute type","items":{"type":"string"}},"max_file_size":{"type":"string","description":"Max file size in MB when the attribute type is `image`","default":null,"x-warning":"Only for `image` attribute type"},"reference_entity_code":{"type":"string","description":"Code of the linked reference entity when the attribute type is `reference_entity_single_link` or `reference_entity_multiple_links`","default":null,"x-validation-rules":"Required when the attribute type is either `reference_entity_single_link` or `reference_entity_multiple_links`","x-warning":"Only for `reference_entity_single_link` and `reference_entity_multiple_links` attribute type","x-immutable":true},"decimals_allowed":{"type":"boolean","description":"Whether decimals are allowed when the attribute type is `number`","default":false,"x-warning":"Only for `number` attribute type"},"min_value":{"type":"string","description":"Minimum value allowed when the attribute type is `number`","default":null,"x-validation-rules":"The minimum value must be lower than the maximum value","x-warning":"Only for `number` attribute type"},"max_value":{"type":"string","description":"Maximum value allowed when the attribute type is `number`","default":null,"x-validation-rules":"The maximum value must be greater than the minimum value","x-warning":"Only for `number` attribute type"}},"example":{"code":"description","labels":{"en_US":"Description","fr_FR":"Description"},"type":"text","value_per_locale":true,"value_per_channel":false,"is_required_for_completeness":true,"max_characters":null,"is_textarea":true,"is_rich_text_editor":true,"validation_rule":"none","validation_regexp":null}}},"ReferenceEntityAttributeOption":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Attribute's option code","x-immutable":true},"labels":{"type":"object","description":"Attribute labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute label for the locale `localeCode`"}}}},"example":{"code":"global_nomad","labels":{"en_US":"Global Nomad","fr_FR":"Nomade du Monde"}}},"ReferenceEntityAttributeOptionList":{"type":"array","items":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Attribute's option code","x-immutable":true},"labels":{"type":"object","description":"Attribute labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute label for the locale `localeCode`"}}}},"example":{"code":"global_nomad","labels":{"en_US":"Global Nomad","fr_FR":"Nomade du Monde"}}}},"ReferenceEntityRecord":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Code of the record","x-immutable":true},"values":{"type":"object","description":"Record attributes values, see Reference entity record values section for more details","x-validation-rules":"Validation rules detailed in Reference entity record values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","description":"Channel code of the reference entity record value"},"locale":{"type":"string","description":"Locale code of the reference entity record value"},"data":{"type":"object","description":"Reference entity record value. See the `data` format section for more details."}}}}}},"created":{"type":"string","description":"Date of creation.","format":"dateTime","default":null,"x-immutable":true,"x-read-only":true,"x-from-version":"5.0"},"updated":{"type":"string","description":"Date of the last update.","format":"dateTime","default":null,"x-read-only":true,"x-from-version":"5.0"}},"example":{"code":"kartell","values":{"label":[{"locale":"en_US","channel":null,"data":"Kartell"}],"image":[{"locale":null,"channel":null,"data":"0/c/b/0/0cb0c0e115dedba676f8d1ad8343ec207ab54c7b_image.jpg"}],"description":[{"locale":"en_US","channel":null,"data":"Kartell, the Italian furniture company that sells modern and remarkable pieces of furnitures."},{"locale":"fr_FR","channel":null,"data":"Kartell, l'éditeur de meuble italien spécialisé dans la signature de belle pièces au design contemporain."}],"country":[{"locale":null,"channel":null,"data":"italy"}],"collection_overview":[{"locale":null,"channel":null,"data":"5/1/d/8/51d81dc778ba1501a8f998f3ab5797569f3b9e25_img.png"}],"creation_year":[{"locale":null,"channel":null,"data":"1949"}]},"created":"2021-01-01T01:23:34+00:00","updated":"2021-02-03T23:45:60+00:00"}},"ReferenceEntityRecordList":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Code of the record","x-immutable":true},"values":{"type":"object","description":"Record attributes values, see Reference entity record values section for more details","x-validation-rules":"Validation rules detailed in Reference entity record values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","description":"Channel code of the reference entity record value"},"locale":{"type":"string","description":"Locale code of the reference entity record value"},"data":{"type":"object","description":"Reference entity record value. See the `data` format section for more details."}}}}}},"created":{"type":"string","description":"Date of creation.","format":"dateTime","default":null,"x-immutable":true,"x-read-only":true,"x-from-version":"5.0"},"updated":{"type":"string","description":"Date of the last update.","format":"dateTime","default":null,"x-read-only":true,"x-from-version":"5.0"}},"example":{"code":"kartell","values":{"label":[{"locale":"en_US","channel":null,"data":"Kartell"}],"image":[{"locale":null,"channel":null,"data":"0/c/b/0/0cb0c0e115dedba676f8d1ad8343ec207ab54c7b_image.jpg"}],"description":[{"locale":"en_US","channel":null,"data":"Kartell, the Italian furniture company that sells modern and remarkable pieces of furnitures."},{"locale":"fr_FR","channel":null,"data":"Kartell, l'éditeur de meuble italien spécialisé dans la signature de belle pièces au design contemporain."}],"country":[{"locale":null,"channel":null,"data":"italy"}],"collection_overview":[{"locale":null,"channel":null,"data":"5/1/d/8/51d81dc778ba1501a8f998f3ab5797569f3b9e25_img.png"}],"creation_year":[{"locale":null,"channel":null,"data":"1949"}]},"created":"2021-01-01T01:23:34+00:00","updated":"2021-02-03T23:45:60+00:00"}}]},"Category":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Category code","x-immutable":true},"parent":{"type":"string","description":"Category code of the parent's category","x-validation-rules":"• It is either equal to `null` or to an existing category code. • If equal to an existing category code, it cannot reference itself.","default":"null"},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"position":{"type":"integer","description":"Position of the category in its level, start from 1 (only available since the 7.0 version and when query parameter \"with_position\" is set to \"true\")","x-read-only":true},"labels":{"type":"object","description":"Category labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Category label for the locale `localeCode`"}}},"values":{"type":"object","description":"Attribute values","default":null,"properties":{"attributeCode|attributeUuid|channelCode|localeCode":{"type":"array","items":{"type":"object","properties":{"data":{"type":"object","description":"Attribute value"},"type":{"type":"string","description":"The attribute type"},"locale":{"type":"string","description":"Locale code of the attribute value"},"channel":{"type":"string","description":"Channel code of the attribute value"},"attribute_code":{"type":"string","description":"The attribute code with its uuid (attributeCode|attributeUuid)"}}}}}}},"example":{"code":"winter_collection","parent":null,"updated":"2021-05-22T12:48:00+02:00","position":1,"labels":{"en_US":"Winter collection","fr_FR":"Collection hiver"},"values":{"description|96b88bf4-c2b7-4b64-a1f9-5d4876c02c26|ecommerce|en_US":{"data":"

Winter collection description

\n","type":"textarea","channel":"ecommerce","locale":"en_US","attribute_code":"description|96b88bf4-c2b7-4b64-a1f9-5d4876c02c26"},"image_1|871b8686-79b5-415c-9c6f-a38f8732dfb7|ecommerce|en_US":{"data":{"size":1401359,"extension":"jpg","file_path":"2/d/c/7/2dc791671d726e7438219d5dc7fd51a53d6bf2bb_IMG_7860.jpg","mime_type":"image/jpeg","original_filename":"IMG_7860.jpg"},"type":"image","channel":"ecommerce","locale":"en_US","attribute_code":"image_1|871b8686-79b5-415c-9c6f-a38f8732dfb7"}}}},"CategoryUpdate":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Category code","x-immutable":true},"parent":{"type":"string","description":"Category code of the parent's category","x-validation-rules":"• It is either equal to `null` or to an existing category code. • If equal to an existing category code, it cannot reference itself.","default":"null"},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"position":{"type":"integer","description":"Position of the category in its level, start from 1 (only available since the 7.0 version and when query parameter \"with_position\" is set to \"true\")","x-read-only":true},"labels":{"type":"object","description":"Category labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Category label for the locale `localeCode`"}}},"values":{"type":"array","description":"Attribute values (only available on SaaS).","default":[],"items":{"type":"object","properties":{"data":{"type":"string","description":"Attribute value. It should be a `string` for Text and Text Area attributes, a `boolean` for Yes/No attribute and for Image attribute use the create category media file endpoint. It can also be `null` to remove the value."},"locale":{"type":"string","description":"Locale code of the attribute value."},"channel":{"type":"string","description":"Channel code of the attribute value."},"attribute_code":{"type":"string","description":"The attribute code."}}}}},"example":{"code":"winter_collection","parent":null,"labels":{"en_US":"Winter collection","fr_FR":"Collection hiver"},"values":[{"data":"

Winter collection description

","channel":"ecommerce","locale":"en_US","attribute_code":"a_text_area_attribute"},{"data":false,"channel":"ecommerce","locale":null,"attribute_code":"a_boolean_attribute"},{"data":null,"channel":null,"locale":null,"attribute_code":"an_image_attribute"}]}},"CategoryList":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Category code","x-immutable":true},"parent":{"type":"string","description":"Category code of the parent's category","x-validation-rules":"• It is either equal to `null` or to an existing category code. • If equal to an existing category code, it cannot reference itself.","default":"null"},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true},"position":{"type":"integer","description":"Position of the category in its level, start from 1 (only available since the 7.0 version and when query parameter \"with_position\" is set to \"true\")","x-read-only":true},"labels":{"type":"object","description":"Category labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Category label for the locale `localeCode`"}}},"values":{"type":"object","description":"Attribute values","default":null,"properties":{"attributeCode|attributeUuid|channelCode|localeCode":{"type":"array","items":{"type":"object","properties":{"data":{"type":"object","description":"Attribute value"},"type":{"type":"string","description":"The attribute type"},"locale":{"type":"string","description":"Locale code of the attribute value"},"channel":{"type":"string","description":"Channel code of the attribute value"},"attribute_code":{"type":"string","description":"The attribute code with its uuid (attributeCode|attributeUuid)"}}}}}}},"example":{"code":"winter_collection","parent":null,"updated":"2021-05-22T12:48:00+02:00","position":1,"labels":{"en_US":"Winter collection","fr_FR":"Collection hiver"},"values":{"description|96b88bf4-c2b7-4b64-a1f9-5d4876c02c26|ecommerce|en_US":{"data":"

Winter collection description

\n","type":"textarea","channel":"ecommerce","locale":"en_US","attribute_code":"description|96b88bf4-c2b7-4b64-a1f9-5d4876c02c26"},"image_1|871b8686-79b5-415c-9c6f-a38f8732dfb7|ecommerce|en_US":{"data":{"size":1401359,"extension":"jpg","file_path":"2/d/c/7/2dc791671d726e7438219d5dc7fd51a53d6bf2bb_IMG_7860.jpg","mime_type":"image/jpeg","original_filename":"IMG_7860.jpg"},"type":"image","channel":"ecommerce","locale":"en_US","attribute_code":"image_1|871b8686-79b5-415c-9c6f-a38f8732dfb7"}}}}]},"MeasureFamily":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Measure family code","x-immutable":true},"standard":{"type":"string","description":"Measure family standard","x-immutable":true},"units":{"type":"array","description":"Family units","items":{"type":"object","properties":{"code":{"type":"string","description":"Measure code","x-immutable":true},"convert":{"type":"object","description":"Mathematic operation to convert the unit into the standard unit"},"symbol":{"type":"string","description":"Measure symbol","x-immutable":true}}}}},"example":{"code":"Area","standard":"SQUARE_METER","units":[{"code":"SQUARE_MILLIMETER","convert":{"mul":"0.001"},"symbol":"mm²"},{"code":"SQUARE_CENTIMETER","convert":{"mul":"0.001"},"symbol":"cm²"}]}},"MeasureFamilyList":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Measure family code","x-immutable":true},"standard":{"type":"string","description":"Measure family standard","x-immutable":true},"units":{"type":"array","description":"Family units","items":{"type":"object","properties":{"code":{"type":"string","description":"Measure code","x-immutable":true},"convert":{"type":"object","description":"Mathematic operation to convert the unit into the standard unit"},"symbol":{"type":"string","description":"Measure symbol","x-immutable":true}}}}},"example":{"code":"Area","standard":"SQUARE_METER","units":[{"code":"SQUARE_MILLIMETER","convert":{"mul":"0.001"},"symbol":"mm²"},{"code":"SQUARE_CENTIMETER","convert":{"mul":"0.001"},"symbol":"cm²"}]}}]},"MeasurementFamily":{"type":"object","required":["code","standard_unit_code","units"],"properties":{"code":{"type":"string","description":"Measurement family code","x-immutable":true},"labels":{"type":"object","description":"Measurement family labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Measurement family label for the locale `localeCode`"}}},"standard_unit_code":{"type":"string","description":"Unit code used as the standard unit for this measurement family","x-immutable":true,"x-validation-rules":"The unit code exists in the list of the property `units`"},"units":{"type":"object","description":"Measurement units for this family with their conversion operations. More details here.","x-validation-rules":"A unit can't be added when a product attribute is linked to this measurement family","properties":{"unitCode":{"type":"object","properties":{"code":{"type":"string","description":"Measurement unit code. More details here.","x-immutable":true},"labels":{"type":"object","description":"Unit labels for each locale. More details here.","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Unit label for the locale `localeCode`"}}},"convert_from_standard":{"type":"array","description":"Calculation to convert the unit from the standard unit. More details here.","x-validation-rules":"• The conversion operations can't be updated when a product attribute is linked to this measurement family • At least one conversion operation per unit is required","items":{"type":"object","properties":{"operator":{"type":"string","description":"Operator for a conversion operation to convert the unit in the standard unit","x-validation-rules":"The operator is one of the following values","enum":["mul","div","add","sub"]},"value":{"type":"string","description":"Value for a conversion operation to convert the unit in the standard unit"}}}},"symbol":{"type":"string","description":"Measurement unit symbol. More details here."}}}}}},"example":{"code":"AREA","labels":{"en_US":"Area","fr_FR":"Surface"},"standard_unit_code":"SQUARE_METER","units":{"SQUARE_MILLIMETER":{"code":"SQUARE_MILLIMETER","labels":{"en_US":"Square millimeter","fr_FR":"Millimètre carré"},"convert_from_standard":[{"operator":"mul","value":"0.000001"}],"symbol":"mm²"},"SQUARE_CENTIMETER":{"code":"SQUARE_CENTIMETER","labels":{"en_US":"Square centimeter","fr_FR":"Centimètre carré"},"convert_from_standard":[{"operator":"mul","value":"0.0001"}],"symbol":"cm²"},"SQUARE_METER":{"code":"SQUARE_METER","labels":{"en_US":"Square meter","fr_FR":"Mètre carré"},"convert_from_standard":[{"operator":"mul","value":"1"}],"symbol":"m²"}}}},"MeasurementFamilyList":{"type":"object","required":["code","standard_unit_code","units"],"properties":{"code":{"type":"string","description":"Measurement family code","x-immutable":true},"labels":{"type":"object","description":"Measurement family labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Measurement family label for the locale `localeCode`"}}},"standard_unit_code":{"type":"string","description":"Unit code used as the standard unit for this measurement family","x-immutable":true,"x-validation-rules":"The unit code exists in the list of the property `units`"},"units":{"type":"object","description":"Measurement units for this family with their conversion operations. More details here.","x-validation-rules":"A unit can't be added when a product attribute is linked to this measurement family","properties":{"unitCode":{"type":"object","properties":{"code":{"type":"string","description":"Measurement unit code. More details here.","x-immutable":true},"labels":{"type":"object","description":"Unit labels for each locale. More details here.","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Unit label for the locale `localeCode`"}}},"convert_from_standard":{"type":"array","description":"Calculation to convert the unit from the standard unit. More details here.","x-validation-rules":"• The conversion operations can't be updated when a product attribute is linked to this measurement family • At least one conversion operation per unit is required","items":{"type":"object","properties":{"operator":{"type":"string","description":"Operator for a conversion operation to convert the unit in the standard unit","x-validation-rules":"The operator is one of the following values","enum":["mul","div","add","sub"]},"value":{"type":"string","description":"Value for a conversion operation to convert the unit in the standard unit"}}}},"symbol":{"type":"string","description":"Measurement unit symbol. More details here."}}}}}},"example":{"code":"AREA","labels":{"en_US":"Area","fr_FR":"Surface"},"standard_unit_code":"SQUARE_METER","units":{"SQUARE_MILLIMETER":{"code":"SQUARE_MILLIMETER","labels":{"en_US":"Square millimeter","fr_FR":"Millimètre carré"},"convert_from_standard":[{"operator":"mul","value":"0.000001"}],"symbol":"mm²"},"SQUARE_CENTIMETER":{"code":"SQUARE_CENTIMETER","labels":{"en_US":"Square centimeter","fr_FR":"Centimètre carré"},"convert_from_standard":[{"operator":"mul","value":"0.0001"}],"symbol":"cm²"},"SQUARE_METER":{"code":"SQUARE_METER","labels":{"en_US":"Square meter","fr_FR":"Mètre carré"},"convert_from_standard":[{"operator":"mul","value":"1"}],"symbol":"m²"}}}},"Family":{"type":"object","required":["code","attribute_as_label"],"properties":{"code":{"type":"string","description":"Family code","x-immutable":true},"attribute_as_label":{"type":"string","description":"Attribute code used as label","x-validation-rules":"• It is equal to an existing attribute code • This attribute code is in the array of the property `attributes` • The type of this attribute is either `pim_catalog_identifier` or `pim_catalog_text`"},"attribute_as_image":{"type":"string","description":"Attribute code used as the main picture in the user interface (only since v2.0)","x-validation-rules":"• It is equal to an existing attribute code • This attribute code is in the array of the property `attributes` • The type of this attribute is `pim_catalog_image`. Since v2.1, you can also use a `pim_assets_collection` attribute type","default":"null","x-from-version":"2.0"},"attributes":{"type":"array","description":"Attributes codes that compose the family","x-validation-rules":"Each string of the array is an existing attribute code","items":{"type":"string"},"default":[]},"attribute_requirements":{"type":"object","description":"Attributes codes of the family that are required for the completeness calculation for each channel","x-validation-rules":"• Each string of these arrays is an existing attribute code • These attribute codes are in the array of the property `attributes` • The `channelCode` is the code of an existing and activated channel","properties":{"channelCode":{"type":"array","items":{"type":"string","description":"Attributes codes of the family that are required for the completeness calculation for the channel `channelCode`"}}}},"labels":{"type":"object","description":"Family labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Family label for the locale `localeCode`"}}}},"example":{"code":"caps","attributes":["sku","name","description","price","color","picture"],"attribute_as_label":"name","attribute_as_image":"picture","attribute_requirements":{"ecommerce":["sku","name","description","price","color"],"tablet":["sku","name","description","price"]},"labels":{"en_US":"Caps","fr_FR":"Casquettes"}}},"FamilyList":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code","attribute_as_label"],"properties":{"code":{"type":"string","description":"Family code","x-immutable":true},"attribute_as_label":{"type":"string","description":"Attribute code used as label","x-validation-rules":"• It is equal to an existing attribute code • This attribute code is in the array of the property `attributes` • The type of this attribute is either `pim_catalog_identifier` or `pim_catalog_text`"},"attribute_as_image":{"type":"string","description":"Attribute code used as the main picture in the user interface (only since v2.0)","x-validation-rules":"• It is equal to an existing attribute code • This attribute code is in the array of the property `attributes` • The type of this attribute is `pim_catalog_image`. Since v2.1, you can also use a `pim_assets_collection` attribute type","default":"null","x-from-version":"2.0"},"attributes":{"type":"array","description":"Attributes codes that compose the family","x-validation-rules":"Each string of the array is an existing attribute code","items":{"type":"string"},"default":[]},"attribute_requirements":{"type":"object","description":"Attributes codes of the family that are required for the completeness calculation for each channel","x-validation-rules":"• Each string of these arrays is an existing attribute code • These attribute codes are in the array of the property `attributes` • The `channelCode` is the code of an existing and activated channel","properties":{"channelCode":{"type":"array","items":{"type":"string","description":"Attributes codes of the family that are required for the completeness calculation for the channel `channelCode`"}}}},"labels":{"type":"object","description":"Family labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Family label for the locale `localeCode`"}}}},"example":{"code":"caps","attributes":["sku","name","description","price","color","picture"],"attribute_as_label":"name","attribute_as_image":"picture","attribute_requirements":{"ecommerce":["sku","name","description","price","color"],"tablet":["sku","name","description","price"]},"labels":{"en_US":"Caps","fr_FR":"Casquettes"}}}]},"FamilyVariant":{"type":"object","required":["code","variant_attribute_sets"],"properties":{"code":{"type":"string","description":"Family variant code","x-immutable":true},"variant_attribute_sets":{"type":"array","description":"Attributes distribution according to the enrichment level","items":{"type":"object","required":["level","axes"],"description":"Enrichment level","properties":{"level":{"type":"integer","description":"Enrichment level","x-immutable":true,"x-validation-rules":"• Number representing the level of the attribute set. • It should be equal to 1 or 2. • If you specify the level 2, you have to specify the level 1 as well."},"axes":{"type":"array","description":"Codes of attributes used as variant axes","x-immutable":true,"items":{"type":"string"},"default":[],"x-validation-rules":"• Should be an array of maximum 5 existing attribute codes • These attributes should belong to the family of the family variant • Only the following attribute types are allowed: `simple select`, `multi select`, `reference data`, `metric`, `boolean` • Attributes cannot be scopable, nor localizable nor locale specific • Attributes used as axes in one level cannot be used as axes or as attributes in the other level"},"attributes":{"type":"array","description":"Codes of attributes bind to this enrichment level","items":{"type":"string"},"default":[],"x-validation-rules":"• Should be an array of existing attribute codes • These attributes should belong to the family of the family variant • Attributes used as attribute in one level cannot be used as axes or as attributes in the other level • Attributes that are `unique value` or `identifier` are automatically distributed to the lower level."}}}},"labels":{"type":"object","description":"Family variant labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Family variant label for the locale `localeCode`"}}}},"example":{"code":"shoesVariant","labels":{"en_US":"Shoes variant","fr_FR":"Variante de chaussures"},"variant_attribute_sets":[{"level":1,"attributes":["color","material"],"axes":["color"]},{"level":2,"attributes":["sku","size"],"axes":["size"]}]}},"FamilyVariantList":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code","variant_attribute_sets"],"properties":{"code":{"type":"string","description":"Family variant code","x-immutable":true},"variant_attribute_sets":{"type":"array","description":"Attributes distribution according to the enrichment level","items":{"type":"object","required":["level","axes"],"description":"Enrichment level","properties":{"level":{"type":"integer","description":"Enrichment level","x-immutable":true,"x-validation-rules":"• Number representing the level of the attribute set. • It should be equal to 1 or 2. • If you specify the level 2, you have to specify the level 1 as well."},"axes":{"type":"array","description":"Codes of attributes used as variant axes","x-immutable":true,"items":{"type":"string"},"default":[],"x-validation-rules":"• Should be an array of maximum 5 existing attribute codes • These attributes should belong to the family of the family variant • Only the following attribute types are allowed: `simple select`, `multi select`, `reference data`, `metric`, `boolean` • Attributes cannot be scopable, nor localizable nor locale specific • Attributes used as axes in one level cannot be used as axes or as attributes in the other level"},"attributes":{"type":"array","description":"Codes of attributes bind to this enrichment level","items":{"type":"string"},"default":[],"x-validation-rules":"• Should be an array of existing attribute codes • These attributes should belong to the family of the family variant • Attributes used as attribute in one level cannot be used as axes or as attributes in the other level • Attributes that are `unique value` or `identifier` are automatically distributed to the lower level."}}}},"labels":{"type":"object","description":"Family variant labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Family variant label for the locale `localeCode`"}}}},"example":{"code":"shoesVariant","labels":{"en_US":"Shoes variant","fr_FR":"Variante de chaussures"},"variant_attribute_sets":[{"level":1,"attributes":["color","material"],"axes":["color"]},{"level":2,"attributes":["sku","size"],"axes":["size"]}]}}]},"Attribute":{"type":"object","required":["code","type","group"],"properties":{"code":{"type":"string","description":"Attribute code","x-immutable":true},"type":{"type":"string","description":"Attribute type. See type section for more details.","x-validation-rules":"The type is one of the following values","enum":["pim_catalog_identifier","pim_catalog_metric","pim_catalog_number","pim_catalog_reference_data_multi_select","pim_catalog_reference_data_simple_select","pim_catalog_simpleselect","pim_catalog_multiselect","pim_catalog_date","pim_catalog_textarea","pim_catalog_text","pim_catalog_file","pim_catalog_image","pim_catalog_price_collection","pim_catalog_boolean","akeneo_reference_entity","akeneo_reference_entity_collection","pim_catalog_asset_collection"],"x-immutable":true},"labels":{"type":"object","description":"Attribute labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute label for the locale `localeCode`"}}},"group":{"type":"string","description":"Attribute group","x-validation-rules":"It is the code of an existing group"},"group_labels":{"type":"object","description":"Group labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","x-read-only":true,"default":{},"properties":{"localeCode":{"type":"string","description":"Group label for the locale `localeCode`"}}},"sort_order":{"type":"integer","description":"Order of the attribute in its group","x-validation-rules":"It is a positive integer","default":0},"localizable":{"type":"boolean","description":"Whether the attribute is localizable, i.e. can have one value by locale","default":false,"x-immutable":true},"scopable":{"type":"boolean","description":"Whether the attribute is scopable, i.e. can have one value by channel","default":false,"x-immutable":true},"available_locales":{"type":"array","description":"To make the attribute locale specfic, specify here for which locales it is specific","x-validation-rules":"Each string of the array is an existing and activated locale","items":{"type":"string"}},"unique":{"type":"boolean","description":"Whether two values for the attribute cannot be the same","x-immutable":true},"useable_as_grid_filter":{"type":"boolean","description":"Whether the attribute can be used as a filter for the product grid in the PIM user interface"},"max_characters":{"type":"integer","description":"Number maximum of characters allowed for the value of the attribute when the attribute type is `pim_catalog_text`, `pim_catalog_textarea` or `pim_catalog_identifier`","x-warning":"Only for `pim_catalog_text`, `pim_catalog_textarea` or `pim_catalog_identifier` attribute types"},"validation_rule":{"type":"string","description":"Validation rule type used to validate any attribute value when the attribute type is `pim_catalog_text` or `pim_catalog_identifier`","x-validation-rules":"Equal to `regexp` when the attribute type is equal to `pim_catalog_identifier`","x-warning":"Only for `pim_catalog_text` or `pim_catalog_identifier` attribute types"},"validation_regexp":{"type":"string","description":"Regexp expression used to validate any attribute value when the attribute type is `pim_catalog_text` or `pim_catalog_identifier`","x-validation-rules":"Required when the property `validation_rule` is equal to `regexp`","x-warning":"Only for `pim_catalog_text` or `pim_catalog_identifier` attribute types"},"wysiwyg_enabled":{"type":"boolean","description":"Whether the WYSIWYG interface is shown when the attribute type is `pim_catalog_textarea`","x-warning":"Only for `pim_catalog_textarea` attribute type"},"number_min":{"type":"string","description":"Minimum integer value allowed when the attribute type is `pim_catalog_metric`, `pim_catalog_price` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric`, `pim_catalog_price_collection` or `pim_catalog_number` attribute types"},"number_max":{"type":"string","description":"Maximum integer value allowed when the attribute type is `pim_catalog_metric`, `pim_catalog_price` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric`, `pim_catalog_price_collection` or `pim_catalog_number` attribute types"},"decimals_allowed":{"type":"boolean","description":"Whether decimals are allowed when the attribute type is `pim_catalog_metric`, `pim_catalog_price` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric`, `pim_catalog_price_collection` or `pim_catalog_number` attribute types"},"negative_allowed":{"type":"boolean","description":"Whether negative values are allowed when the attribute type is `pim_catalog_metric` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric` or `pim_catalog_number` attribute types"},"metric_family":{"type":"string","description":"Metric family when the attribute type is `pim_catalog_metric`","x-immutable":true,"x-validation-rules":"Required for `pim_catalog_metric` attribute type","x-warning":"Only for `pim_catalog_metric` attribute type"},"default_metric_unit":{"type":"string","description":"Default metric unit when the attribute type is `pim_catalog_metric`","x-validation-rules":"Required for `pim_catalog_metric` attribute type","x-warning":"Only for `pim_catalog_metric` attribute type"},"date_min":{"type":"string","description":"Minimum date allowed when the attribute type is `pim_catalog_date`","x-validation-rules":"The datetime format follows the ISO-8601 norm","x-warning":"Only for `pim_catalog_date` attribute type","format":"date-time"},"date_max":{"type":"string","description":"Maximum date allowed when the attribute type is `pim_catalog_date`","x-validation-rules":"The datetime format follows the ISO-8601 norm","x-warning":"Only for `pim_catalog_date` attribute type","format":"date-time"},"allowed_extensions":{"type":"array","description":"Extensions allowed when the attribute type is `pim_catalog_file` or `pim_catalog_image`","x-warning":"Only for `pim_catalog_file` or `pim_catalog_image` attribute types","items":{"type":"string"}},"max_file_size":{"type":"string","description":"Max file size in MB when the attribute type is `pim_catalog_file` or `pim_catalog_image`","x-warning":"Only for `pim_catalog_file` or `pim_catalog_image` attribute types"},"reference_data_name":{"type":"string","description":"Reference entity code when the attribute type is `akeneo_reference_entity` or `akeneo_reference_entity_collection` OR Asset family code when the attribute type is `pim_catalog_asset_collection`","x-validation-rules":"Required only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types","x-warning":"Only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types"},"default_value":{"type":"boolean","description":"Default value for a Yes/No attribute, applied when creating a new product or product model (only available since the 5.0)","x-warning":"Only for `pim_catalog_boolean` attribute type","x-from-version":"5.0"},"table_configuration":{"type":"array","description":"Configuration of the Table attribute (columns)","x-validation-rules":"Required only for `pim_catalog_table` attribute type","x-warning":"Only for `pim_catalog_table` attribute type","items":{"type":"object","required":["code","data_type"],"properties":{"code":{"type":"string","description":"Column code"},"data_type":{"type":"string","enum":["select","text","number","boolean"],"description":"Column data type"},"validations":{"type":"object","description":"User defined validation constraints on the cell content","default":{},"properties":{"min":{"type":"number","description":"minimum value of a numeric cell","x-validation-rules":"only for `number` data type columns"},"max":{"type":"number","description":"maximum value of a numeric cell","x-validation-rules":"only for `number` data type columns"},"decimals_allowed":{"type":"boolean","description":"whether the value of a numeric cell can hold a decimal part","x-validation-rules":"only for `number` data type columns"},"max_length":{"type":"number","description":"maximum length of a text cell","x-validation-rules":"only for `text` data type columns"}}},"labels":{"type":"object","description":"Column labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Column label for the locale `localeCode`"}}},"is_required_for_completeness":{"type":"boolean","description":"Defines if the column should be entirely filled for the attribute to be considered complete","x-warning":"This value is always true for the first column in a table configuration","default":false}}}},"is_main_identifier":{"type":"boolean","description":"Is this attribute main identifier when attribute type is `pim_catalog_identifier`"}},"example":{"code":"release_date","type":"pim_catalog_date","group":"marketing","group_labels":{"en_US":"Marketing","fr_FR":"Marketing"},"unique":false,"useable_as_grid_filter":true,"allowed_extensions":[],"metric_family":null,"default_metric_unit":null,"reference_data_name":null,"available_locales":[],"max_characters":null,"validation_rule":null,"validation_regexp":null,"wysiwyg_enabled":null,"number_min":null,"number_max":null,"decimals_allowed":null,"negative_allowed":null,"date_min":"2017-06-28T08:00:00","date_max":"2017-08-08T22:00:00","max_file_size":null,"minimum_input_length":null,"sort_order":1,"localizable":false,"scopable":false,"default_value":null,"labels":{"en_US":"Sale date","fr_FR":"Date des soldes"}}},"AttributeList":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code","type","group"],"properties":{"code":{"type":"string","description":"Attribute code","x-immutable":true},"type":{"type":"string","description":"Attribute type. See type section for more details.","x-validation-rules":"The type is one of the following values","enum":["pim_catalog_identifier","pim_catalog_metric","pim_catalog_number","pim_catalog_reference_data_multi_select","pim_catalog_reference_data_simple_select","pim_catalog_simpleselect","pim_catalog_multiselect","pim_catalog_date","pim_catalog_textarea","pim_catalog_text","pim_catalog_file","pim_catalog_image","pim_catalog_price_collection","pim_catalog_boolean","akeneo_reference_entity","akeneo_reference_entity_collection","pim_catalog_asset_collection"],"x-immutable":true},"labels":{"type":"object","description":"Attribute labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute label for the locale `localeCode`"}}},"group":{"type":"string","description":"Attribute group","x-validation-rules":"It is the code of an existing group"},"group_labels":{"type":"object","description":"Group labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","x-read-only":true,"default":{},"properties":{"localeCode":{"type":"string","description":"Group label for the locale `localeCode`"}}},"sort_order":{"type":"integer","description":"Order of the attribute in its group","x-validation-rules":"It is a positive integer","default":0},"localizable":{"type":"boolean","description":"Whether the attribute is localizable, i.e. can have one value by locale","default":false,"x-immutable":true},"scopable":{"type":"boolean","description":"Whether the attribute is scopable, i.e. can have one value by channel","default":false,"x-immutable":true},"available_locales":{"type":"array","description":"To make the attribute locale specfic, specify here for which locales it is specific","x-validation-rules":"Each string of the array is an existing and activated locale","items":{"type":"string"}},"unique":{"type":"boolean","description":"Whether two values for the attribute cannot be the same","x-immutable":true},"useable_as_grid_filter":{"type":"boolean","description":"Whether the attribute can be used as a filter for the product grid in the PIM user interface"},"max_characters":{"type":"integer","description":"Number maximum of characters allowed for the value of the attribute when the attribute type is `pim_catalog_text`, `pim_catalog_textarea` or `pim_catalog_identifier`","x-warning":"Only for `pim_catalog_text`, `pim_catalog_textarea` or `pim_catalog_identifier` attribute types"},"validation_rule":{"type":"string","description":"Validation rule type used to validate any attribute value when the attribute type is `pim_catalog_text` or `pim_catalog_identifier`","x-validation-rules":"Equal to `regexp` when the attribute type is equal to `pim_catalog_identifier`","x-warning":"Only for `pim_catalog_text` or `pim_catalog_identifier` attribute types"},"validation_regexp":{"type":"string","description":"Regexp expression used to validate any attribute value when the attribute type is `pim_catalog_text` or `pim_catalog_identifier`","x-validation-rules":"Required when the property `validation_rule` is equal to `regexp`","x-warning":"Only for `pim_catalog_text` or `pim_catalog_identifier` attribute types"},"wysiwyg_enabled":{"type":"boolean","description":"Whether the WYSIWYG interface is shown when the attribute type is `pim_catalog_textarea`","x-warning":"Only for `pim_catalog_textarea` attribute type"},"number_min":{"type":"string","description":"Minimum integer value allowed when the attribute type is `pim_catalog_metric`, `pim_catalog_price` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric`, `pim_catalog_price_collection` or `pim_catalog_number` attribute types"},"number_max":{"type":"string","description":"Maximum integer value allowed when the attribute type is `pim_catalog_metric`, `pim_catalog_price` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric`, `pim_catalog_price_collection` or `pim_catalog_number` attribute types"},"decimals_allowed":{"type":"boolean","description":"Whether decimals are allowed when the attribute type is `pim_catalog_metric`, `pim_catalog_price` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric`, `pim_catalog_price_collection` or `pim_catalog_number` attribute types"},"negative_allowed":{"type":"boolean","description":"Whether negative values are allowed when the attribute type is `pim_catalog_metric` or `pim_catalog_number`","x-warning":"Only for `pim_catalog_metric` or `pim_catalog_number` attribute types"},"metric_family":{"type":"string","description":"Metric family when the attribute type is `pim_catalog_metric`","x-immutable":true,"x-validation-rules":"Required for `pim_catalog_metric` attribute type","x-warning":"Only for `pim_catalog_metric` attribute type"},"default_metric_unit":{"type":"string","description":"Default metric unit when the attribute type is `pim_catalog_metric`","x-validation-rules":"Required for `pim_catalog_metric` attribute type","x-warning":"Only for `pim_catalog_metric` attribute type"},"date_min":{"type":"string","description":"Minimum date allowed when the attribute type is `pim_catalog_date`","x-validation-rules":"The datetime format follows the ISO-8601 norm","x-warning":"Only for `pim_catalog_date` attribute type","format":"date-time"},"date_max":{"type":"string","description":"Maximum date allowed when the attribute type is `pim_catalog_date`","x-validation-rules":"The datetime format follows the ISO-8601 norm","x-warning":"Only for `pim_catalog_date` attribute type","format":"date-time"},"allowed_extensions":{"type":"array","description":"Extensions allowed when the attribute type is `pim_catalog_file` or `pim_catalog_image`","x-warning":"Only for `pim_catalog_file` or `pim_catalog_image` attribute types","items":{"type":"string"}},"max_file_size":{"type":"string","description":"Max file size in MB when the attribute type is `pim_catalog_file` or `pim_catalog_image`","x-warning":"Only for `pim_catalog_file` or `pim_catalog_image` attribute types"},"reference_data_name":{"type":"string","description":"Reference entity code when the attribute type is `akeneo_reference_entity` or `akeneo_reference_entity_collection` OR Asset family code when the attribute type is `pim_catalog_asset_collection`","x-validation-rules":"Required only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types","x-warning":"Only for `akeneo_reference_entity` or `akeneo_reference_entity_collection` or `pim_catalog_asset_collection` attribute types"},"default_value":{"type":"boolean","description":"Default value for a Yes/No attribute, applied when creating a new product or product model (only available since the 5.0)","x-warning":"Only for `pim_catalog_boolean` attribute type","x-from-version":"5.0"},"table_configuration":{"type":"array","description":"Configuration of the Table attribute (columns)","x-validation-rules":"Required only for `pim_catalog_table` attribute type","x-warning":"Only for `pim_catalog_table` attribute type","items":{"type":"object","required":["code","data_type"],"properties":{"code":{"type":"string","description":"Column code"},"data_type":{"type":"string","enum":["select","text","number","boolean"],"description":"Column data type"},"validations":{"type":"object","description":"User defined validation constraints on the cell content","default":{},"properties":{"min":{"type":"number","description":"minimum value of a numeric cell","x-validation-rules":"only for `number` data type columns"},"max":{"type":"number","description":"maximum value of a numeric cell","x-validation-rules":"only for `number` data type columns"},"decimals_allowed":{"type":"boolean","description":"whether the value of a numeric cell can hold a decimal part","x-validation-rules":"only for `number` data type columns"},"max_length":{"type":"number","description":"maximum length of a text cell","x-validation-rules":"only for `text` data type columns"}}},"labels":{"type":"object","description":"Column labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Column label for the locale `localeCode`"}}},"is_required_for_completeness":{"type":"boolean","description":"Defines if the column should be entirely filled for the attribute to be considered complete","x-warning":"This value is always true for the first column in a table configuration","default":false}}}},"is_main_identifier":{"type":"boolean","description":"Is this attribute main identifier when attribute type is `pim_catalog_identifier`"}},"example":{"code":"release_date","type":"pim_catalog_date","group":"marketing","group_labels":{"en_US":"Marketing","fr_FR":"Marketing"},"unique":false,"useable_as_grid_filter":true,"allowed_extensions":[],"metric_family":null,"default_metric_unit":null,"reference_data_name":null,"available_locales":[],"max_characters":null,"validation_rule":null,"validation_regexp":null,"wysiwyg_enabled":null,"number_min":null,"number_max":null,"decimals_allowed":null,"negative_allowed":null,"date_min":"2017-06-28T08:00:00","date_max":"2017-08-08T22:00:00","max_file_size":null,"minimum_input_length":null,"sort_order":1,"localizable":false,"scopable":false,"default_value":null,"labels":{"en_US":"Sale date","fr_FR":"Date des soldes"}}}]},"AttributeOption":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Code of option"},"attribute":{"type":"string","description":"Code of attribute related to the attribute option","x-validation-rules":"It is the same attribute code as the one given as path parameter"},"sort_order":{"type":"integer","description":"Order of attribute option","x-validation-rules":"It is a positive integer"},"labels":{"type":"object","description":"Attribute option labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute option label for the locale `localeCode`"}}}},"example":{"code":"black","attribute":"a_simple_select","sort_order":2,"labels":{"en_US":"Black","fr_FR":"Noir"}}},"AttributeOptionList":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Code of option"},"attribute":{"type":"string","description":"Code of attribute related to the attribute option","x-validation-rules":"It is the same attribute code as the one given as path parameter"},"sort_order":{"type":"integer","description":"Order of attribute option","x-validation-rules":"It is a positive integer"},"labels":{"type":"object","description":"Attribute option labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute option label for the locale `localeCode`"}}}},"example":{"code":"black","attribute":"a_simple_select","sort_order":2,"labels":{"en_US":"Black","fr_FR":"Noir"}}}]},"AttributeGroup":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Attribute group code","x-immutable":true},"sort_order":{"type":"integer","description":"Attribute group order among other attribute groups","x-validation-rules":"It is a positive integer","default":0},"attributes":{"type":"array","description":"Attribute codes that compose the attribute group","x-validation-rules":"Each string of the array is an existing attribute code, an attribute can only be in one attribute group","items":{"type":"string"},"default":[]},"labels":{"type":"object","description":"Attribute group labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute group label for the locale `localeCode`"}}}},"example":{"code":"marketing","sort_order":4,"attributes":["sku","name","description","response_time","release_date","price"],"labels":{"en_US":"Marketing","fr_FR":"Marketing"}}},"AttributeGroupList":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Attribute group code","x-immutable":true},"sort_order":{"type":"integer","description":"Attribute group order among other attribute groups","x-validation-rules":"It is a positive integer","default":0},"attributes":{"type":"array","description":"Attribute codes that compose the attribute group","x-validation-rules":"Each string of the array is an existing attribute code, an attribute can only be in one attribute group","items":{"type":"string"},"default":[]},"labels":{"type":"object","description":"Attribute group labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute group label for the locale `localeCode`"}}}},"example":{"code":"marketing","sort_order":4,"attributes":["sku","name","description","response_time","release_date","price"],"labels":{"en_US":"Marketing","fr_FR":"Marketing"}}}]},"MediaFile":{"allOf":[{"type":"object","properties":{"_links":{"type":"object","x-read-only":true,"properties":{"download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the binaries of the media file"}}}}}}},{"type":"object","properties":{"code":{"type":"string","description":"Media file code","x-immutable":true},"original_filename":{"type":"string","description":"Original filename of the media file"},"mime_type":{"type":"string","description":"Mime type of the media file","x-read-only":true},"size":{"type":"integer","description":"Size of the media file","x-read-only":true},"extension":{"type":"string","description":"Extension of the media file","x-read-only":true}},"example":{"code":"7/5/8/e/758e39d48ea7b42a55091434fd3d8b6cf3189b7f_10806799_1356.jpg","original_filename":"10806799-1356.jpg","mime_type":"image/jpeg","size":16070,"extension":"jpg"}}],"example":{"_links":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/media-files/7/5/8/e/758e39d48ea7b42a55091434fd3d8b6cf3189b7f_10806799_1356.jpg/download"}},"code":"7/5/8/e/758e39d48ea7b42a55091434fd3d8b6cf3189b7f_10806799_1356.jpg","original_filename":"10806799-1356.jpg","mime_type":"image/jpeg","size":16070,"extension":"jpg"}},"MediaFileList":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI to get the metadata of the media file"}}},"download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the binaries of the media file"}}}}}}},{"type":"object","properties":{"code":{"type":"string","description":"Media file code","x-immutable":true},"original_filename":{"type":"string","description":"Original filename of the media file"},"mime_type":{"type":"string","description":"Mime type of the media file","x-read-only":true},"size":{"type":"integer","description":"Size of the media file","x-read-only":true},"extension":{"type":"string","description":"Extension of the media file","x-read-only":true}},"example":{"code":"7/5/8/e/758e39d48ea7b42a55091434fd3d8b6cf3189b7f_10806799_1356.jpg","original_filename":"10806799-1356.jpg","mime_type":"image/jpeg","size":16070,"extension":"jpg"}}]},"Locale":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Locale code","x-immutable":true},"enabled":{"type":"boolean","description":"Whether the locale is enabled","default":false}},"example":{"code":"en_US","enable":true}},"LocaleList":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Locale code","x-immutable":true},"enabled":{"type":"boolean","description":"Whether the locale is enabled","default":false}},"example":{"code":"en_US","enable":true}}]},"Channel":{"type":"object","required":["code","category_tree","locales","currencies"],"properties":{"code":{"type":"string","description":"Channel code","x-immutable":true},"locales":{"type":"array","description":"Codes of activated locales for the channel","x-validation-rules":"• Each string of the array is an existing locale code • At least one locale in the array","items":{"type":"string"}},"currencies":{"type":"array","description":"Codes of activated currencies for the channel","x-validation-rules":"• Each string of the array is an existing currency code • At least one currency in the array","items":{"type":"string"}},"category_tree":{"type":"string","description":"Code of the category tree linked to the channel","x-validation-rules":"It is the code of an existing category code that is a tree (a category without parent)"},"conversion_units":{"type":"object","description":"Units to which the given metric attributes should be converted when exporting products","x-validation-rules":"• The `attributeCode` is the code of an existing attribute whose type is `pim_catalog_metric` • The strings are existing unit codes.","properties":{"attributeCode":{"type":"string","description":"Conversion unit code used to convert the values of the attribute `attributeCode` when exporting via the channel"}}},"labels":{"type":"object","description":"Channel labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Channel label for the locale `localeCode`"}}}},"example":{"code":"ecommerce","currencies":["USD","EUR"],"locales":["de_DE","en_US","fr_FR"],"category_tree":"master","conversion_units":{"weight":"KILOGRAM"},"labels":{"en_US":"Ecommerce","de_DE":"Ecommerce","fr_FR":"Ecommerce"}}},"ChannelList":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code","category_tree","locales","currencies"],"properties":{"code":{"type":"string","description":"Channel code","x-immutable":true},"locales":{"type":"array","description":"Codes of activated locales for the channel","x-validation-rules":"• Each string of the array is an existing locale code • At least one locale in the array","items":{"type":"string"}},"currencies":{"type":"array","description":"Codes of activated currencies for the channel","x-validation-rules":"• Each string of the array is an existing currency code • At least one currency in the array","items":{"type":"string"}},"category_tree":{"type":"string","description":"Code of the category tree linked to the channel","x-validation-rules":"It is the code of an existing category code that is a tree (a category without parent)"},"conversion_units":{"type":"object","description":"Units to which the given metric attributes should be converted when exporting products","x-validation-rules":"• The `attributeCode` is the code of an existing attribute whose type is `pim_catalog_metric` • The strings are existing unit codes.","properties":{"attributeCode":{"type":"string","description":"Conversion unit code used to convert the values of the attribute `attributeCode` when exporting via the channel"}}},"labels":{"type":"object","description":"Channel labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Channel label for the locale `localeCode`"}}}},"example":{"code":"ecommerce","currencies":["USD","EUR"],"locales":["de_DE","en_US","fr_FR"],"category_tree":"master","conversion_units":{"weight":"KILOGRAM"},"labels":{"en_US":"Ecommerce","de_DE":"Ecommerce","fr_FR":"Ecommerce"}}}]},"AssociationType":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Association type code","x-immutable":true},"labels":{"type":"object","description":"Association type labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Association type label for the locale `localeCode`"}}},"is_quantified":{"type":"boolean","description":"When true, the association is a quantified association (Only available in the PIM Serenity version.)","default":false,"x-immutable":true},"is_two_way":{"type":"boolean","description":"When true, the association is a two-way association (Only available in the PIM Serenity version.)","default":false,"x-immutable":true}},"example":{"code":"upsell","labels":{"en_US":"Upsell","fr_FR":"Vente incitative"},"is_quantified":false,"is_two_way":false}},"AssociationTypeList":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Association type code","x-immutable":true},"labels":{"type":"object","description":"Association type labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Association type label for the locale `localeCode`"}}},"is_quantified":{"type":"boolean","description":"When true, the association is a quantified association (Only available in the PIM Serenity version.)","default":false,"x-immutable":true},"is_two_way":{"type":"boolean","description":"When true, the association is a two-way association (Only available in the PIM Serenity version.)","default":false,"x-immutable":true}},"example":{"code":"upsell","labels":{"en_US":"Upsell","fr_FR":"Vente incitative"},"is_quantified":false,"is_two_way":false}}]},"Currency":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Currency code","x-immutable":true},"enabled":{"type":"boolean","description":"Whether the currency is enabled"},"label":{"type":"string","description":"Currency label"}},"example":{"code":"EUR","enabled":true,"label":"EUR (Euro)"}},"CurrencyList":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Currency code","x-immutable":true},"enabled":{"type":"boolean","description":"Whether the currency is enabled"},"label":{"type":"string","description":"Currency label"}},"example":{"code":"EUR","enabled":true,"label":"EUR (Euro)"}}]},"AssetFamilyList":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Asset family code","x-immutable":true},"labels":{"type":"object","description":"Asset family labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Asset family label for the locale `localeCode`"}}},"attribute_as_main_media":{"type":"string","description":"Attribute code that is used as the main media of the asset family.","x-validation-rules":"It should be the code of an attribute that belongs to this family, and it must be a media file or a media link attribute type.","default":"First media file or media link attribute that was created"},"naming_convention":{"type":"object","description":"The naming convention ran over the asset code or the main media filename upon each asset creation, in order to automatically set several values in asset attributes. To learn more and see the format of this property, take a look at here.","x-validation-rules":"To know more about the validation of this property, take a look at our naming convention format.","default":{},"properties":{"source":{"type":"object","description":"The string on which the naming convention should be applied. More details here."},"pattern":{"type":"string","description":"The regular expression that should be applied on the source. More details here."},"abort_asset_creation_on_error":{"type":"boolean","description":"Whether the asset should be created if the naming convention failed to apply. More details here."}}},"product_link_rules":{"type":"array","description":"The rules that will be run after the asset creation, in order to automatically link the assets of this family to a set of products. To understand the format of this property, see here.","x-validation-rules":"To know more about the validation of this property, take a look at our product link rule format.","default":[],"items":{"type":"object","properties":{"product_selections":{"type":"array","description":"The product selection to which the assets of the asset family to be automatically linked. More details here.","items":{"type":"object","required":["field","operator","value"],"properties":{"field":{"type":"string"},"operator":{"type":"string"},"value":{"type":"string"},"locale":{"type":"string"},"channel":{"type":"string"}}}},"assign_assets_to":{"type":"array","description":"The product value in which your assets will be assigned. More details here.","items":{"type":"object","required":["attribute","mode"],"properties":{"attribute":{"type":"string"},"locale":{"type":"string"},"channel":{"type":"string"},"mode":{"type":"string"}}}}}}},"transformations":{"type":"array","description":"The transformations to perform on source files in order to generate new files into your asset attributes (only available since v4.0). To understand the format of this property, see here.","x-validation-rules":"To know more about the validation of this property, take a look at our transformation format.","x-from-version":"4.0","default":[],"items":{"type":"object","required":["label","target","source","operations"],"properties":{"label":{"type":"string","description":"The name of the transformation"},"filename_suffix":{"type":"string","description":"The suffix that will be appended to the source filename to generate the target filename. More details here."},"filename_prefix":{"type":"string","description":"The prefix that will be prepended to the source filename to generate the target filename. More details here."},"source":{"type":"object","required":["attribute","channel","locale"],"description":"The attribute value in which is stored the media file you want to use as the source file for your transformation. More details here.","properties":{"attribute":{"type":"string"},"channel":{"type":"string"},"locale":{"type":"string"}}},"target":{"type":"object","required":["attribute","channel","locale"],"description":"The attribute value in which the PIM will generate the new transformed file, aka the target file. More details here.","properties":{"attribute":{"type":"string"},"channel":{"type":"string"},"locale":{"type":"string"}}},"operations":{"type":"object","description":"The transformations that should be applied to your source file to generate the target file. More details here.","x-validation-rules":"Should contain at least one operation","properties":{"type":{"type":"string"},"parameters":{"type":"object","properties":{"colorspace":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"},"ratio":{"type":"integer"},"resolution-unit":{"type":"string"},"resolution-x":{"type":"integer"},"resolution-y":{"type":"integer"},"quality":{"type":"integer"}}}}}}}}},"example":{"code":"model_pictures","labels":{"en_US":"Model pictures","fr_FR":"Photographies en pied"},"attribute_as_main_media":"main_image","naming_convention":{"source":{"property":"code","channel":null,"locale":null},"pattern":"/(?P.*)-.*/","abort_asset_creation_on_error":true},"product_link_rules":[{"product_selections":[{"field":"sku","operator":"EQUALS","value":"{{product_ref}}"}],"assign_assets_to":[{"attribute":"model_pictures","mode":"replace"}]}],"transformations":[{"label":"Thumbnail plus black and white transformation","filename_suffix":"_thumbnailBW","source":{"attribute":"main_image","channel":null,"locale":null},"target":{"attribute":"thumbnail","channel":null,"locale":null},"operations":[{"type":"thumbnail","parameters":{"width":150,"height":150}},{"type":"colorspace","parameters":{"colorspace":"grey"}}]}]}}]},"AssetFamilyItemList":{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},"AssetAttributeList":{"type":"array","items":{"type":"object","required":["code","type","media_type"],"properties":{"code":{"type":"string","description":"Attribute code","x-immutable":true},"labels":{"type":"object","description":"Attribute labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute label for the locale `localeCode`"}}},"type":{"type":"string","description":"Attribute type. See type section for more details.","enum":["text","media_link","number","media_file","single_option","multiple_options","boolean","date","record"],"x-immutable":true},"value_per_locale":{"type":"boolean","description":"Whether the attribute is localizable, i.e. can have one value by locale","default":false,"x-immutable":true},"value_per_channel":{"type":"boolean","description":"Whether the attribute is scopable, i.e. can have one value by channel","default":false,"x-immutable":true},"is_required_for_completeness":{"type":"boolean","description":"Whether the attribute should be part of the record's completeness calculation","default":false},"is_read_only":{"type":"boolean","description":"Whether the attribute should be in read only mode only in the UI, but you can still update it with the API","default":false},"max_characters":{"type":"integer","description":"Maximum number of characters allowed for the value of the attribute when the attribute type is `text`","x-warning":"Only for `text` attribute type"},"is_textarea":{"type":"boolean","description":"Whether the UI should display a text area instead of a simple field when the attribute type is `text`","default":false,"x-warning":"Only for `text` attribute type"},"is_rich_text_editor":{"type":"boolean","description":"Whether the UI should display a rich text editor instead of a simple text area when the attribute type is `text`","x-validation-rules":"Required when the property `is_textarea` is equal to `true`","x-warning":"Only for `text` attribute type"},"validation_rule":{"type":"string","description":"Validation rule type used to validate the attribute value when the attribute type is `text`","default":"none","x-warning":"Only for `text` attribute type","enum":["email","url","regexp","none"]},"validation_regexp":{"type":"string","description":"Regexp expression used to validate the attribute value when the attribute type is `text`","default":null,"x-validation-rules":"Required when the property `validation_rule` is equal to `regexp`","x-warning":"Only for `text` attribute type"},"allowed_extensions":{"type":"array","description":"Extensions allowed when the attribute type is `media_file`","default":[],"x-warning":"Only for `media_file` attribute type","items":{"type":"string"}},"max_file_size":{"type":"string","description":"Max file size in MB when the attribute type is `media_file`","default":null,"x-warning":"Only for `media_file` attribute type"},"decimals_allowed":{"type":"boolean","description":"Whether decimals are allowed when the attribute type is `number`","default":false,"x-warning":"Only for `number` attribute type"},"min_value":{"type":"string","description":"Minimum value allowed when the attribute type is `number`","default":null,"x-validation-rules":"The minimum value must be lower than the maximum value","x-warning":"Only for `number` attribute type"},"max_value":{"type":"string","description":"Maximum value allowed when the attribute type is `number`","default":null,"x-validation-rules":"The maximum value must be greater than the minimum value","x-warning":"Only for `number` attribute type"},"media_type":{"type":"string","description":"For the `media_link` attribute type, it is the type of the media behind the url, to allow its preview in the PIM. For the `media_file` attribute type, it is the type of the file.","enum":["image","pdf","youtube","vimeo","other"],"x-warning":"Only required for `media_link` and `media_file` attribute types"},"prefix":{"type":"string","description":"Prefix of the `media_link` attribute type. The common url root that prefixes the link to the media","default":null,"x-warning":"Only for `media_link` attribute type"},"suffix":{"type":"string","description":"Suffix of the `media_link` attribute type. The common url suffix for the media","default":null,"x-warning":"Only for `media_link` attribute type"},"reference_entity":{"type":"string","description":"Reference entity code for the `record` attribute type (see Reference entity).","default":null,"x-warning":"Only for `record` attribute type","x-from-version":"SaaS"}},"example":{"code":"model_is_wearing_size","labels":{"en_US":"Model is wearing size","fr_FR":"Le mannequin porte la taille"},"type":"single_option","value_per_locale":false,"value_per_channel":false,"is_required_for_completeness":true}}},"AssetAttributeOptionList":{"type":"array","items":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Attribute's option code","x-immutable":true},"labels":{"type":"object","description":"Attribute labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"Attribute label for the locale `localeCode`"}}}},"example":{"code":"small","labels":{"en_US":"S","fr_FR":"S"}}}},"AssetList":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Code of the asset","x-immutable":true},"values":{"type":"object","description":"Asset attributes values, see the Focus on the asset values section for more details.","x-validation-rules":"Validation rules detailed in Asset attribute values section","properties":{"attributeCode":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","description":"Channel code of the asset attribute value"},"locale":{"type":"string","description":"Locale code of the asset attribute value"},"data":{"type":"object","description":"Asset attribute value. See the `data` format section for more details."},"_links":{"type":"object","description":"Related links for the `media file` attribute values. See the `_links` format section for more details.","x-validation-rules":"The share link is returned for the **main** `media file` attribute when asset sharing is enabled"},"linked_data":{"type":"object","description":"Linked data for the `media link` attribute values. See the `linked_data` format section for more details.","x-from-version":"SaaS"}}}}}},"created":{"type":"string","description":"Date of creation","format":"dateTime","x-immutable":true,"x-read-only":true,"x-from-version":"6.0"},"updated":{"type":"string","description":"Date of the last update","format":"dateTime","x-read-only":true,"x-from-version":"6.0"}},"example":{"code":"sku_54628_picture1","values":{"media_preview":[{"locale":null,"channel":null,"data":"sku_54628_picture1.jpg"}],"model_wears_size":[{"locale":null,"channel":null,"data":"s"}],"photographer":[{"locale":null,"channel":null,"data":"ben_levy"}],"main_colors":[{"locale":null,"channel":null,"data":["red","purple"]}],"end_of_use_date":[{"locale":null,"channel":null,"data":"02/03/2021"}]},"created":"2021-05-31T09:23:34+00:00","updated":"2021-05-31T09:23:34+00:00"}}]},"AssetItemList":{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},"AppCatalogList":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","properties":{"id":{"type":"string","description":"Catalog id","x-immutable":true},"name":{"type":"string","description":"Catalog name"},"enabled":{"type":"boolean","description":"Whether the catalog is enabled or not","default":false},"managed_currencies":{"type":"array","description":"List of currency codes","items":{"type":"string"}},"managed_locales":{"type":"array","description":"List of locale codes","items":{"type":"string"}}},"example":{"_links":{"self":{"href":"http://demo.akeneo.com/api/rest/v1/catalogs/3af8e091-6df5-4ed1-a9aa-090de12e5be5"}},"id":"12351d98-200e-4bbc-aa19-7fdda1bd14f2","name":"My app catalog","enabled":false,"managed_currencies":["EUR","USD","GBP"],"managed_locales":["fr_FR","en_US"]}}]},"Error":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"ErrorByLine":{"type":"object","properties":{"line":{"type":"integer","description":"Line number"},"identifier":{"type":"string","description":"Resource identifier, only filled when the resource is a product"},"code":{"type":"string","description":"Resource code, only filled when the resource is not a product"},"status_code":{"type":"integer","description":"HTTP status code, see Client errors to understand the meaning of each code"},"message":{"type":"string","description":"Message explaining the error"}}},"ErrorByLineProductUuid":{"type":"object","properties":{"line":{"type":"integer","description":"Line number"},"uuid":{"type":"string","description":"Product uuid"},"status_code":{"type":"integer","description":"HTTP status code, see Client errors to understand the meaning of each code"},"message":{"type":"string","description":"Message explaining the error"}}},"ErrorByObject":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Resource code"},"status_code":{"type":"integer","description":"HTTP status code, see Client errors to understand the meaning of each code"},"message":{"type":"string","description":"Message explaining the error"}}}},"Pagination":{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"previous":{"type":"object","properties":{"href":{"type":"string","description":"URI of the previous page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}},"current_page":{"type":"integer","description":"Current page number"}}},"SearchAfterPagination":{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the current page of resources"}}},"first":{"type":"object","properties":{"href":{"type":"string","description":"URI of the first page of resources"}}},"next":{"type":"object","properties":{"href":{"type":"string","description":"URI of the next page of resources"}}}}}}},"ItemList":{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},"MediaFileItemList":{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI to get the metadata of the media file"}}},"download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the binaries of the media file"}}}}}}},"ReferenceEntityItemList":{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}},"image_download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the binaries of the reference entity image file"}}}}}}},"ReferenceEntityRecordItemList":{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},"DeprecatedAsset":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"PAM asset code","x-immutable":true},"categories":{"type":"array","description":"Codes of the PAM asset categories in which the asset is classified","x-validation-rules":"Each string of the array is equal to an existing asset category code","items":{"type":"string"},"default":[]},"description":{"type":"string","description":"Description of the PAM asset","default":null},"localizable":{"type":"boolean","description":"Whether the asset is localized or not, meaning if you want to have different reference files for each of your locale","default":false,"x-immutable":true},"tags":{"type":"array","description":"Tags of the PAM asset","items":{"type":"string"},"default":[]},"end_of_use":{"type":"string","description":"Date on which the PAM asset expire","format":"dateTime","default":null,"x-validation-rules":"The date follows the ISO 8601 format"},"variation_files":{"type":"array","description":"Variations of the PAM asset","x-read-only":true,"items":{"type":"object","properties":{"_link":{"type":"object","description":"Links to get and download the variation file","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the variation entity"}}},"download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the variation file"}}}}},"locale":{"type":"string","description":"Locale code of the variation"},"scope":{"type":"string","description":"Channel code of the variation"},"code":{"type":"string","description":"Code of the variation"}}}},"reference_files":{"type":"array","description":"Reference files of the PAM asset","x-read-only":true,"items":{"type":"object","properties":{"_link":{"type":"object","description":"Links to get and download the reference file","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the reference file entity"}}},"download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the reference file"}}}}},"locale":{"type":"string","description":"Locale code of the reference file"},"code":{"type":"string","description":"Code of the reference file"}}}}},"example":{"code":"tshirt_artemis_main_picture","categories":["tshirts_assets"],"description":"The main picture of the Artemis t-shirt","localizable":false,"tags":["tshirts","red","summer"],"end_of_use":"2019-09-01T00:00:00+0200","variation_files":[{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/ecommerce/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/ecommerce/no_locale"}},"locale":null,"scope":"e_commerce","code":"7/5/8/e/758e39d48va7b42a55001434fd3d7b6cf3189b7f_tshirt_artemis_main_picture_ecommerce.jpg"},{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/print/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/print/no_locale"}},"locale":null,"scope":"print","code":"7/5/8/e/759e39d48va7b42a55002434fd3d7b6cf3189b7f_tshirt_artemis_main_picture_print.jpg"}],"reference_files":[{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/reference-files/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/reference-files/no_locale"}},"locale":null,"code":"7/5/8/e/759e39d48va7b42a55002434fd3d7b6cf3189b7f_tshirt_artemis_main_picture.jpg"}]}},"DeprecatedAssetList":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"PAM asset code","x-immutable":true},"categories":{"type":"array","description":"Codes of the PAM asset categories in which the asset is classified","x-validation-rules":"Each string of the array is equal to an existing asset category code","items":{"type":"string"},"default":[]},"description":{"type":"string","description":"Description of the PAM asset","default":null},"localizable":{"type":"boolean","description":"Whether the asset is localized or not, meaning if you want to have different reference files for each of your locale","default":false,"x-immutable":true},"tags":{"type":"array","description":"Tags of the PAM asset","items":{"type":"string"},"default":[]},"end_of_use":{"type":"string","description":"Date on which the PAM asset expire","format":"dateTime","default":null,"x-validation-rules":"The date follows the ISO 8601 format"},"variation_files":{"type":"array","description":"Variations of the PAM asset","x-read-only":true,"items":{"type":"object","properties":{"_link":{"type":"object","description":"Links to get and download the variation file","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the variation entity"}}},"download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the variation file"}}}}},"locale":{"type":"string","description":"Locale code of the variation"},"scope":{"type":"string","description":"Channel code of the variation"},"code":{"type":"string","description":"Code of the variation"}}}},"reference_files":{"type":"array","description":"Reference files of the PAM asset","x-read-only":true,"items":{"type":"object","properties":{"_link":{"type":"object","description":"Links to get and download the reference file","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the reference file entity"}}},"download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the reference file"}}}}},"locale":{"type":"string","description":"Locale code of the reference file"},"code":{"type":"string","description":"Code of the reference file"}}}}},"example":{"code":"tshirt_artemis_main_picture","categories":["tshirts_assets"],"description":"The main picture of the Artemis t-shirt","localizable":false,"tags":["tshirts","red","summer"],"end_of_use":"2019-09-01T00:00:00+0200","variation_files":[{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/ecommerce/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/ecommerce/no_locale"}},"locale":null,"scope":"e_commerce","code":"7/5/8/e/758e39d48va7b42a55001434fd3d7b6cf3189b7f_tshirt_artemis_main_picture_ecommerce.jpg"},{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/print/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/print/no_locale"}},"locale":null,"scope":"print","code":"7/5/8/e/759e39d48va7b42a55002434fd3d7b6cf3189b7f_tshirt_artemis_main_picture_print.jpg"}],"reference_files":[{"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/reference-files/no_locale/download"},"self":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/reference-files/no_locale"}},"locale":null,"code":"7/5/8/e/759e39d48va7b42a55002434fd3d7b6cf3189b7f_tshirt_artemis_main_picture.jpg"}]}}]},"DeprecatedAssetReferenceFile":{"type":"object","properties":{"code":{"type":"string","description":"Code of the PAM asset reference file","x-immutable":true},"locale":{"type":"string","description":"Locale of the PAM asset reference file, equal to `null` if the asset is not localizable"},"_link":{"type":"object","description":"Links to get and download the reference file","properties":{"download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the reference file"}}}}}},"example":{"code":"7/5/8/e/759e39d48va7b42a55002434fd3d7b6cf3189b7f_tshirt_artemis_main_picture.jpg","locale":null,"_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/reference-files/no_locale/download"}}}},"DeprecatedAssetVariationFile":{"type":"object","properties":{"code":{"type":"string","description":"Code of the PAM asset variation file","x-immutable":true},"locale":{"type":"string","description":"Locale of the PAM asset variation file, equal to `null` if the asset is not localizable"},"scope":{"type":"string","description":"Channel of the PAM asset variation file"},"_link":{"type":"object","description":"Links to get and download the reference file","properties":{"download":{"type":"object","properties":{"href":{"type":"string","description":"URI to download the variation file"}}}}}},"example":{"code":"7/5/8/e/758e39d48va7b42a55001434fd3d7b6cf3189b7f_tshirt_artemis_main_picture_ecommerce.jpg","locale":null,"scope":"ecommerce","_link":{"download":{"href":"https://demo.akeneo.com/api/rest/v1/assets/tshirt_artemis_main_picture/variation-files/ecommerce/no_locale/download"}}}},"DeprecatedAssetCategory":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"PAM asset category code","x-immutable":true},"parent":{"type":"string","description":"PAM ssset category code of the parent's asset category","x-validation-rules":"• It is either equal to `null` or to an existing asset category code. • If equal to an existing asset category code, it cannot reference itself.","default":"null"},"labels":{"type":"object","description":"PAM asset category labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"PAM asset category label for the locale `localeCode`"}}}},"example":{"code":"front_views","parent":"pictures","labels":{"en_US":"Front views","fr_FR":"Vues de face"}}},"DeprecatedAssetCategoryList":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"PAM asset category code","x-immutable":true},"parent":{"type":"string","description":"PAM ssset category code of the parent's asset category","x-validation-rules":"• It is either equal to `null` or to an existing asset category code. • If equal to an existing asset category code, it cannot reference itself.","default":"null"},"labels":{"type":"object","description":"PAM asset category labels for each locale","x-validation-rules":"The `localeCode` is the code of an existing and activated locale","default":{},"properties":{"localeCode":{"type":"string","description":"PAM asset category label for the locale `localeCode`"}}}},"example":{"code":"front_views","parent":"pictures","labels":{"en_US":"Front views","fr_FR":"Vues de face"}}}]},"DeprecatedAssetTag":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"PAM asset tag code","x-immutable":true}},"example":{"code":"tshirt"}},"DeprecatedAssetTagList":{"type":"object","allOf":[{"type":"object","properties":{"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string","description":"URI of the resource"}}}}}}},{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"PAM asset tag code","x-immutable":true}},"example":{"code":"tshirt"}}]},"DeprecatedAssetReferenceFileUploadWarning":{"type":"object","properties":{"message":{"type":"string","description":"Message explaining the warning"},"errors":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","description":"Channel for which the variation file generation failed"},"locale":{"type":"string","description":"Locale for which the variation file generation failed"},"message":{"type":"string","description":"Message explaining why the variation file generation failed"}}}}}}},"responses":{"Created":{"description":"Created","x-details":"Means that the creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"ReferenceEntityMediaFileUploaded":{"description":"Created","x-details":"Means that the media file creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"},"Reference-entities-media-file-code":{"description":"Code of the media file","type":"string"}}},"AssetMediaFileUploaded":{"description":"Created","x-details":"Means that the media file creation was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"},"Asset-media-file-code":{"description":"Code of the media file","type":"string"}}},"Submitted":{"description":"Submitted","x-details":"Means that the draft submission was successful","headers":{"Location":{"description":"URI of the created resource","type":"string"}}},"NoContent":{"description":"No content to return","x-details":"Means that the update was successful","headers":{"Location":{"description":"URI of the updated resource","type":"string"}}},"400Error":{"description":"Bad request","x-details":"Can be caused by a malformed JSON request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":400,"message":"Invalid JSON message received"}},"401Error":{"description":"Authentication required","x-details":"Can be caused by a missing or expired token","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":401,"message":"Authentication is required"}},"403Error":{"description":"Access forbidden","x-details":"The user does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list categories."}},"404Error":{"description":"Resource not found","x-details":"The resource code given in the URI does not correspond to any existing PIM resource","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Resource `my_resource_code` does not exist."}},"406Error":{"description":"Not Acceptable","x-details":"The `Accept` header is not `application/json` but it should","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":406,"message":"‘xxx’ in ‘Accept‘ header is not valid. Only ‘application/json‘ is allowed."}},"413Error":{"description":"Request Entity Too Large","x-details":"There are too many resources to process (max 100) or the line of JSON is too long (max 1 000 000 characters)","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":413,"message":"Too many resources to process, 100 is the maximum allowed."}},"415Error":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/json’ is allowed."}},"415ErrorStream":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `application/vnd.akeneo.collection+json`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘application/vnd.akeneo.collection+json’ is allowed."}},"415ErrorMultipart":{"description":"Unsupported Media type","x-details":"The `Content-type` header has to be `multipart/form-data`","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":415,"message":"‘xxx’ in ‘Content-type’ header is not valid. Only ‘multipart/form-data’ is allowed."}},"422Error":{"description":"Unprocessable entity","x-details":"The validation of the entity given in the body of the request failed","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":422,"message":"Property \"labels\" expects an array as data, \"NULL\" given. Check the API reference documentation.","_links":{"documentation":{"href":"http://api.akeneo.com/api-reference.html"}}}},"429Error":{"description":"Too many requests","x-details":"There are too many requests on this endpoint","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":429,"message":"You have exceeded the limit of API requests per second."}},"DeprecatedAssetReferenceFileUploaded":{"description":"Uploaded","x-details":"Means that the reference file upload was successful. Beware that even if the reference file upload is complete, some variation files generations could have failed. If so, you will see a warning message in the response body.","headers":{"Location":{"description":"URI of the created resource","type":"string"}},"x-no-entity":true,"schema":{"type":"object","properties":{"message":{"type":"string","description":"Message explaining the warning"},"errors":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","description":"Channel for which the variation file generation failed"},"locale":{"type":"string","description":"Locale for which the variation file generation failed"},"message":{"type":"string","description":"Message explaining why the variation file generation failed"}}}}}}},"403CatalogError":{"description":"Access forbidden","x-details":"The app does not have the permission to execute this request","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":403,"message":"Access forbidden. You are not allowed to list catalogs."}},"404CatalogError":{"description":"Catalog not found","x-details":"The catalog id given in the URI does not exist","schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code"},"message":{"type":"string","description":"Message explaining the error"}}},"examples":{"code":404,"message":"Catalog \"65f5a521-e65c-4d7b-8be8-1f267fa2729c\" does not exist or you can't access it."}}},"parameters":{"pagination_type":{"name":"pagination_type","in":"query","description":"Pagination method type, see Pagination section","required":false,"type":"string","default":"page","x-validation-rules":"One of the following values","enum":["page","search_after"]},"page":{"name":"page","in":"query","description":"Number of the page to retrieve when using the `page` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"integer","default":1},"search_after":{"name":"search_after","in":"query","description":"Cursor when using the `search_after` pagination method type. Should never be set manually, see Pagination section","required":false,"type":"string","default":"cursor to the first page"},"limit":{"name":"limit","in":"query","description":"Number of results by page, see Pagination section","required":false,"type":"integer","minimum":1,"maximum":100,"default":10},"code":{"name":"code","in":"path","description":"Code of the resource","required":true,"type":"string"},"file_path":{"name":"file_path","in":"path","description":"Path of the resource","required":true,"type":"string"},"uuid":{"name":"uuid","in":"path","description":"Uuid of the resource","required":true,"type":"string"},"reference_entity_code":{"name":"reference_entity_code","in":"path","description":"Code of the reference entity","required":true,"type":"string"},"asset_family_code":{"name":"asset_family_code","in":"path","description":"Code of the asset family","required":true,"type":"string"},"attribute_code":{"name":"attribute_code","in":"path","description":"Code of the attribute","required":true,"type":"string"},"asset_code":{"name":"asset_code","in":"path","description":"Code of the asset","required":true,"type":"string"},"channel_code":{"name":"channel_code","in":"path","description":"Code of the channel","required":true,"type":"string"},"locale_code":{"name":"locale_code","in":"path","description":"Code of the locale if the asset is localizable or equal to `no-locale` if the asset is not localizable","required":true,"type":"string"},"family_code":{"name":"family_code","in":"path","description":"Code of the family","required":true,"type":"string"},"with_count":{"name":"with_count","in":"query","description":"Return the count of items in the response. Be carefull with that, on a big catalog, it can decrease performance in a significative way","default":false,"type":"boolean","required":false},"with_count_for_catalogs":{"name":"with_count","in":"query","description":"Return the count of items in the response.","default":false,"type":"boolean","required":false},"with_attribute_options":{"name":"with_attribute_options","in":"query","description":"Return labels of attribute options in the response. See the `linked_data` format section for more details. (Only available since the 5.0 version)","default":false,"type":"boolean","required":false,"x-from-version":"5.0"},"with_attribute_options__product_models":{"name":"with_attribute_options","in":"query","description":"Return labels of attribute options in the response. (Only available on SaaS platforms)","default":false,"type":"boolean","required":false,"x-from-version":"SaaS"},"with_table_select_options":{"name":"with_table_select_options","in":"query","description":"Return the options of 'select' column types (of a table attribute) in the response. (Only available since the 7.0 version)","default":false,"type":"boolean","required":false,"x-from-version":"7.0"},"with_asset_share_links":{"name":"with_asset_share_links","in":"query","description":"Return asset collection share link urls in the response. See the `linked_data` format section for more details. (Only available in the SaaS version)","default":false,"type":"boolean","required":false,"x-from-version":"SaaS"},"with_quality_scores__products":{"name":"with_quality_scores","in":"query","description":"Return product quality scores in the response. (Only available since the 5.0 version)","default":false,"type":"boolean","required":false,"x-from-version":"5.0"},"with_quality_scores__product_models":{"name":"with_quality_scores","in":"query","description":"Return product model quality scores in the response. (Only available since the 6.0 version)","type":"boolean","required":false,"x-from-version":"6.0"},"with_completenesses":{"name":"with_completenesses","in":"query","description":"Return product completenesses in the response. (Only available since the 6.0 version)","default":false,"type":"boolean","required":false,"x-from-version":"6.0"},"with_position":{"name":"with_position","in":"query","description":"Return information about category position into its category tree (only available since the 7.0 version)","required":false,"type":"boolean","x-from-version":"7.0"},"updated_before":{"name":"updated_before","in":"query","description":"Filter products that have been updated BEFORE the provided date (Only available on Catalogs endpoints). This filter uses the PIM products updated date.","type":"string","format":"date","required":false,"x-from-version":"SaaS"},"updated_after":{"name":"updated_after","in":"query","description":"Filter products that have been updated AFTER the provided date (Only available on Catalogs endpoints). This filter uses the PIM products updated date.","type":"string","format":"date","required":false,"x-from-version":"SaaS"},"with_enriched_attributes":{"name":"with_enriched_attributes","in":"query","description":"Return attribute values of the category (only available on SaaS platforms)","required":false,"type":"boolean","x-from-version":"SaaS"}}} \ No newline at end of file diff --git a/content/swagger/resources/categories/routes/categories.yaml b/content/swagger/resources/categories/routes/categories.yaml index db244ebaa..42d0200ea 100644 --- a/content/swagger/resources/categories/routes/categories.yaml +++ b/content/swagger/resources/categories/routes/categories.yaml @@ -231,7 +231,7 @@ patch: x-example-1: '{"code":"spring_collection","parent":null}' x-example-2: - '{"code":"woman","parent":"spring_collectionn"}' + '{"code":"woman","parent":"spring_collection"}' x-example-3: '{"code":"man","parent":"spring_collection"}' responses: