Update Product Status (and Publish)

Update Product Status

put

Rate limit: 100 requests per minute

Authorizations

APIKeyAuth

X-API-KeystringRequired

Body

application/json

Responses

200

OK

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

default

put

/api/v1/products/status

HTTPcURLJavaScriptPython

PUT /api/v1/products/status HTTP/1.1
X-API-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 58

{
  "items": [
    {
      "style_key": "EDT1110-5",
      "status": "published"
    }
  ]
}

{
  "batchRequestId": "123e4567-e89b-12d3-a456-426614174000"
}

---

Statuses

PUBLISHED = "published"

Publishing a product initiates its lifecycle toward becoming active.

When a product is published, the approval process is automatically started. The product transitions to the PENDING_APPROVAL state and, once approved, is activated (PENDING_ACTIVE, then ACTIVE).

While a product is in the PENDING_APPROVAL state, it can no longer be updated. The approval request can, however, be withdrawn by setting the product back to DRAFT. This re-enables updates and allows the product to be published again to restart the approval process.

Products only require approval once. If a product has already been approved, publishing it again will immediately activate it without triggering another approval process.

INACTIVE = "inactive"

Inactive products are not visible in the shop but remain available for reactivation.

Only published products can be set to INACTIVE. Setting a product to this state removes it from the shop without deleting it.

To make an inactive product available again, it can be published. Since the product has already been approved, the approval process is skipped and the product is activated immediately.

DRAFT = "draft"

The draft state represents products that are incomplete or not yet ready for approval.

Newly created products start in the DRAFT state. Publishing a draft product triggers the approval process.

Products can be withdrawn from the approval process by setting them back to DRAFT, as long as they have not yet been approved.

Once a product has been approved, it can no longer be set back to DRAFT. Approved products can only be deactivated by setting them to INACTIVE.