curl --request POST \
--url 'https://api.sync.stateset.com/v1/tenants/{tenant_id}/inventory/reservations' \
--header "x-stateset-api-key: $STATESET_SYNC_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"sku": "SKU-TENT-2P-GRN",
"quantity": 2,
"location": "string",
"referenceId": "string"
}'
{
"orderId": "string",
"reserved": 1,
"failed": 1,
"reservationExpiresAt": "2026-08-31T14:22:05Z"
}
Reserve inventory for an order
Inventory reservation result
POST
/
v1
/
tenants
/
{tenant_id}
/
inventory
/
reservations
curl --request POST \
--url 'https://api.sync.stateset.com/v1/tenants/{tenant_id}/inventory/reservations' \
--header "x-stateset-api-key: $STATESET_SYNC_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"sku": "SKU-TENT-2P-GRN",
"quantity": 2,
"location": "string",
"referenceId": "string"
}'
{
"orderId": "string",
"reserved": 1,
"failed": 1,
"reservationExpiresAt": "2026-08-31T14:22:05Z"
}
Path parameters
Request body
object
Response
object
Status codes
| Code | Meaning |
|---|---|
200 | Inventory reservation result |
401 | Unauthorized |
422 | Insufficient inventory |
curl --request POST \
--url 'https://api.sync.stateset.com/v1/tenants/{tenant_id}/inventory/reservations' \
--header "x-stateset-api-key: $STATESET_SYNC_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"sku": "SKU-TENT-2P-GRN",
"quantity": 2,
"location": "string",
"referenceId": "string"
}'
{
"orderId": "string",
"reserved": 1,
"failed": 1,
"reservationExpiresAt": "2026-08-31T14:22:05Z"
}
Last modified on August 31, 2026