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"
}

---

Settable Product States

Even though products can be in many different states, only a subset of these can be set manually. The rest are set automatically by the system (You can read about all product statuses here: https://docs.partner.aboutyou.com/api/products/product-statuses).

The manually settable states are:

State	Description
published	Triggers the product lifecycle toward becoming active
draft	Product is incomplete or not yet submitted for approval
inactive	Product is taken offline but remains available for reactivation

Note: published is not a persistent product state — it acts as a trigger that initiates automatic state transitions in the background.

---

Published

Setting a product's state to published initiates its lifecycle toward becoming active.

When a product is published, the approval process starts automatically. The product transitions to pending_approval and, once approved, is activated through the pending_active state before finally becoming active.

While a product is in the pending_approval state, it can no longer be updated. However, the approval request can be withdrawn by setting the product back to draft, which 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.

---

Draft

The draft state represents products that are incomplete or not yet ready for approval. Newly created products start in this state.

Publishing a draft product triggers the approval process. Products can also 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.

---

Inactive

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

Only previously 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, simply publish it. Since the product has already been approved, the approval process is skipped and the product is activated immediately.