API Reference
joor.com

Update Products

Update your product data.

👍

Endpoint

Params

  • Accept: application/json
  • Authorization: OAuth2 [Base64 encoded token]

Sample cURL Request

curl -X POST "https://api.jooraccess.com/v4/products/bulk_update" -H  "accept: application/json" -H  "Content-Type: application/json" -d "[{\"id\":\"string\",\"product_identifier\":\"string\",\"name\":\"string\",\"description\":\"string\",\"order_minimum\":0,\"category_ids\":[\"string\"],\"product_trait_values\":[{\"trait_id\":\"string\",\"value\":\"string\",\"external_id\":\"string\"}],\"tags\":[{\"name\":\"string\",\"value\":\"string\",\"code\":\"string\",\"parent_id\":\"string\"}]}]"

Workflow

  1. Fetch a list of product ids using the GET /products endpoint
  2. Reference the id of the product you want to update

Product Data

You can use the GET /products endpoint to fetch a list of Joor product ids to update.

PARAMETERSREQUIREDTYPENOTES
idYstring
product_identifierNstring
nameNstring
descriptionNstring
order_minimumNinteger
category_idsN (but recommended)string

Product Trait Data

You can use the GET /traits endpoint to fetch the list of available trait ids to associate with your products. External ids can be assigned to the division, fabrication, and silhouette traits.

PARAMETERSREQUIREDTYPENOTES
trait_idNstring
valueNstring
external_idNstring

Product Tag Data

You can add custom tags to your products for discovery purposes on the web. They must be assigned to a parent_id, which can be viewed on the web, via the Style Settings page.

PARAMETERSREQUIREDTYPENOTES
nameNstring
valueNstring
codeNstring
parent_idNstring

Request Example

[
  {
    "id": "string",
    "product_identifier": "string",
    "name": "string",
    "description": "string",
    "order_minimum": 0,
    "category_ids": [
      "string"
    ],
    "product_trait_values": [
      {
        "trait_id": "string",
        "value": "string",
        "external_id": "string"
      }
    ],
    "tags": [
      {
        "name": "string",
        "value": "string",
        "code": "string",
        "parent_id": "string"
      }
    ]
  }
]

Response Example

{
  "data": [
    {
      "id": "12345678",
      "name": "Shirt by eL Circuito",
      "external_id": "CIRCUITO666",
      "product_identifier": "CIRCUITO",
      "description": "Another one.",
      "order_minimum": 0,
      "categories": [
        {
          "id": "123",
          "name": "Slacks",
          "parent_name": "Apparel",
          "department": "Men's"
        }
      ],
      "product_trait_values": [
        {
          "trait": {
            "id": "U0tVVHJhaXQ6U3R5bGVDb2xvcg==",
            "name": "Color"
          },
          "value": "ILLEST GREENS",
          "external_id": "GREENS"
        },
        {
          "trait": {
            "id": "U0tVVHJhaXQ6U2l6ZQ==",
            "name": "Size"
          },
          "value": "XXXL",
          "external_id": "XXXL"
        }
      ],
      "tags": [
        {
          "id": "1234",
          "name": "Silhouette",
          "value": "Normal Thickness",
          "code": "6666",
          "parent_id": "6666"
        }
      ]
    }
  ],
  "errors": [
    {
      "status": "string",
      "message": "string",
      "details": {}
    }
  ]
}