> ## Documentation Index
> Fetch the complete documentation index at: https://scaleup-c34c4386.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# PATCH /api/v1/products/:id

> Atualiza campos de um produto existente

Atualiza um produto. Apenas os campos enviados são modificados.

> [!NOTE]
>
> Este endpoint **não** cria nem modifica preços. Para manipular preços use [`POST /v1/prices`](https://scaleup-c34c4386.mintlify.site/api-reference/prices/create) ou [`PATCH /v1/prices/:id`](https://scaleup-c34c4386.mintlify.site/api-reference/prices/update). Pra apontar o `default_price_id` pra um preço existente, envie o ID aqui.

## Autenticação

> [!NOTE]
>
> Requer um token de acesso válido (`CHARGEFY_ACCESS_TOKEN`) no header `Authorization`.

## Path

| Parâmetro | Tipo | Obrigatório | Descrição |
| - | - | - | - |
| `id` | `string` | Sim | ID do produto |

## Body

**name** `string`

Novo nome do produto.

**description** `string`

Nova descrição (Markdown suportado).

**metadata** `object`

Metadata livre. Substitui o objeto existente (não faz merge).

**is\_archived** `boolean`

Arquivar (`true`) ou desarquivar (`false`) o produto inteiro.

**is\_tax\_applicable** `boolean`

Ajusta a flag de tributação.

**default\_price\_id** `string`

Aponta o default pra outro preço existente do mesmo produto. Deve estar `active`.

## Resposta

Retorna o produto completo atualizado — mesmo shape que [Obter Produto](https://scaleup-c34c4386.mintlify.site/api-reference/products/get.md).

## Exemplo

```bash cURL theme={null}
curl -X PATCH "https://api.chargefy.io/api/v1/products/prod_abc123" \
  -H "Authorization: Bearer $CHARGEFY_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Plano Pro Plus",
    "default_price_id": "price_y002"
  }'
```

```typescript SDK theme={null}
const product = await chargefy.products.update({
  id: 'prod_abc123',
  name: 'Plano Pro Plus',
});
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.