> ## 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 /functions/v1/update-price

> Atualiza campos mutáveis de um product_price. Stripe-like — campos de valor são imutáveis.

Atualiza uma **Price** existente. Seguimos a convenção da Stripe: **`currency`, `unit_amount`, `type`, `interval`, `interval_count` são imutáveis**. Para mudar qualquer um deles, crie uma price nova e arquive a antiga via `active: false`.

## Autenticação

Requer **Bearer JWT** do Supabase. O produto dono da price deve pertencer a uma organização acessível pelo usuário.

## Corpo da requisição

**id** `string` *required*

UUID da price a atualizar.

**name** `string`

Nome descritivo. Envie `null` (ou string vazia) pra limpar.

**active** `boolean`

`false` arquiva a price (não aparece mais em novos checkouts). `true` reativa.

**metadata** `object`

Substitui integralmente o objeto de metadata (não faz merge). Envie `{}` pra limpar.

**tax\_behavior** `string`

`unspecified`, `inclusive` ou `exclusive`.

## Campos imutáveis (erro 400)

O endpoint rejeita explicitamente: `currency`, `unit_amount`, `type`, `interval`, `interval_count`, `product_id`. Isso segue o comportamento da Stripe — valores cobrados precisam ser auditáveis e estáveis.

## Resposta

Retorna a price atualizada (Row completa) com status `200 OK`.

## Exemplo — arquivar uma price

```bash theme={null}
curl -X PATCH "https://<project>.functions.supabase.co/update-price" \
  -H "Authorization: Bearer $SUPABASE_JWT" \
  -H "Content-Type: application/json" \
  -d '{ "id": "price_01j9xyz998", "active": false }'
```

## Exemplo — trocar tax\_behavior

```bash theme={null}
curl -X PATCH "https://<project>.functions.supabase.co/update-price" \
  -H "Authorization: Bearer $SUPABASE_JWT" \
  -H "Content-Type: application/json" \
  -d '{ "id": "price_01j9xyz998", "tax_behavior": "inclusive" }'
```


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