Update a Product

PUT https://app.alaaqat.com/api/products/{product_id}

Where product_id is the product's _id. Changes the property values you send and leaves the others as they are. Your API key needs the product-update ability, and the team member who created the key needs Edit Products.

Header

{
    "Accept": "application/json",
    "Content-Type": "application/json"
}

Body

The same property values as Create a Product: each key is a property's internal_name, and each value must match its type. Send only the properties you want to change. To empty a value, send null.

{
    "price": 115,
    "status": "unavailable"
}

Unique keys

If a property you send is a unique key, its value must not already belong to another product. Otherwise nothing is updated, and the request is refused with 422 with the error reported on that field.

Response

200 OK, with the whole product under data.

{
    "data": {
        "properties": {
            "_id": "6656b1c2d3e4f5a6b7c8d901",
            "name": "Ergonomic office chair",
            "sku": "CH-ERGO-01",
            "price": 115,
            "cost": 74.5,
            "status": "unavailable",
            "description": "Adjustable height and lumbar support, black mesh back.",
            "owner": 12,
            "created_by": 12,
            "updated_at": "2026-10-21T08:40:12.000000Z",
            "created_at": "2026-10-20T09:30:00.000000Z"
        },
        "account_id": 1024
    },
    "message": "Entity was modified successfully."
}

Errors

Status Meaning
403 The team member who created the key can only change the products they or their teams own, and this one isn't.
404 No product with this _id in your account.
422 A value does not match its property's type, a field that Alaaqat sets was sent, or a unique key value is already taken.