API Reference
joor.com
Start typing to search…

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.

PARAMETERS

REQUIRED

TYPE

NOTES

id

Y

string

product_identifier

N

string

name

N

string

description

N

string

order_minimum

N

integer

category_ids

N (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.

PARAMETERS

REQUIRED

TYPE

NOTES

trait_id

N

string

value

N

string

external_id

N

string

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.

PARAMETERS

REQUIRED

TYPE

NOTES

name

N

string

value

N

string

code

N

string

parent_id

N

string

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": {}
    }
  ]
}