---
title: "Update a product"
method: PATCH
path: "/products/{productId}"
tags: ["Products"]
---

# Update a product

`PATCH /products/{productId}`

## Request

- Base URL: `https://api3.autarc.energy/v1`
- URL: `https://api3.autarc.energy/v1/products/{productId}`
- Auth: API key in header `X-Api-Key`

Partial update of a product's commercial fields and prices. You only need to provide the fields you want to update.

## Path parameters

- `productId` string, uuid, required

## Request body

- PatchProductRequest: Partial update of a product. Provide only the fields you want to change.
  - `name` string
  - `description` string, nullable: Send an empty string to clear.
  - `type` string: The product type (enum value).
  - `unit` string: The unit the product is sold in (enum value).
  - `status` 'draft' | 'active' | 'archived'
  - `manufacturer` string, nullable: Send an empty string to clear.
  - `articleNumber` string, nullable: Send an empty string to clear.
  - `priceInCent` number: Net unit price in cents.
  - `taxRate` number: VAT rate as a percentage (e.g. 19).

## Response `200`

A single product

- Product
  - `id` string, uuid, required
  - `type` string, required: The product type.
  - `name` string, required: The product name.
  - `description` string, nullable: Free-text description.
  - `manufacturer` string, nullable: The manufacturer / brand.
  - `articleNumber` string, nullable: The manufacturer's article number.
  - `unit` string, required: The unit the product is sold in.
  - `priceInCent` number, nullable: Net unit price in cents (e.g. 199900 = €1,999.00).
  - `taxRate` number, nullable: VAT rate as a percentage (e.g. 19 for 19%).
  - `status` 'draft' | 'active' | 'archived', required: The product status.
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required
  - `nominalPower` number, nullable: Solar module STC nominal power (Pmax), in watts. Only present when type is solarPanel; omitted when not recorded.
  - `totalEnergy` number, nullable: Battery nominal / total energy capacity, in kWh. This is the nominal capacity, not the usable capacity, and not an amp-hour rating. Only present when type is battery; omitted when not recorded.

## Other responses

- `404`: The specified resource was not found

---

[API](https://skmtc.dev/autarc/apis/autarc-2-0-api.md) - [All operations](https://skmtc.dev/autarc/apis/autarc-2-0-api/llms.txt) - [OpenAPI document](https://skmtc.dev/autarc/apis/autarc-2-0-api/revisions/adfb20a40efc?raw)