Skip to content

Creating Items

The typical item creation process starts with a POST request that returns an skeleton item with ID. Then, as text, values, colors and other attributes are added and edited they can be saved to that item with PATCH requests to a separate endpoint.

Create Item Endpoint
$ curl -X POST -H "Content-Type: application/json" \
-d '{"username": "someuser"}' /resources/items | jq .
{
"id": "clxwjm1h300004kvwg3btfqkd",
"category": null,
"subCategory": null,
"ownerId": "clxwjm8az00004kvwcihnd14a",
"description": null,
"notes": null,
"fit": 2,
"currency": "USD",
"retailPrice": null,
"rentalPrice": [
{"days": 4, "price": "123"},
{"days": 8, "price": "456"},
{"days": 12, "price": "789"}
],
"designerId": null,
"sizeScaleName": "international",
"size": null,
"condition": null,
"enabled": true,
"createdAt": "2024-06-27 00:36:25.087108+00",
"updatedAt": "2024-06-27 00:36:25.087108+00",
"meta": {
"data": {
"flags": {
"isValid": false
},
"settings": {}
},
"_version": 1
}
}
}
Update Item Endpoint
$ curl -X PATCH -H "Content-Type: application/json" \
-d '{"retailPrice": 520, "size": "L"}' /resources/items/<itemId> | jq .
{
"id": "clxwjm1h300004kvwg3btfqkd",
"category": null,
"subCategory": null,
"ownerId": "clxwjm8az00004kvwcihnd14a",
"description": null,
"notes": null,
"fit": 2,
"currency": "USD",
"retailPrice": 520,
"rentalPrice": [
{"days": 4, "price": "123"},
{"days": 8, "price": "456"},
{"days": 12, "price": "789"}
],
"designerId": null,
"sizeScaleName": "international",
"size": 'L',
"condition": null,
"enabled": true,
"createdAt": "2024-06-27 00:36:25.087108+00",
"updatedAt": "2024-06-27 00:36:25.087108+00",
"meta": {
"data": {
"flags": {
"isValid": false
},
"settings": {}
},
"_version": 1
}
}
}