---
title: "Atualizar plano existente"
method: PUT
path: "/v2/plans/{uuid}"
---

# Atualizar plano existente

`PUT /v2/plans/{uuid}`

## Request

- Base URL: `https://api.barte.com`
- URL: `https://api.barte.com/v2/plans/{uuid}`
- Auth: API key in header `X-Token-Api`
- TypeScript: <https://skmtc.dev/barte/apis/api-de-sellers-v2-atualizada/docs/v2/plans/:uuid/put.ts> (a function with typed inputs; its response is checked against the schema)

Atualiza completamente um plano existente

## Path parameters

- `uuid` string, uuid, required

## Headers

- `X-Token-Api` string, required
- `Content-Type` 'application/json', required

## Request body

- PlanRequest
  - `title` string, required: Título do plano
  - `description` string: Descrição do plano (opcional)
  - `active` boolean: Se o plano está ativo (opcional, padrão: false)
  - `bullets` PlanBullet[]: Lista de benefícios do plano (opcional)
    - `title` string: Título do benefício (opcional)
    - `description` string, required: Descrição do benefício
  - `values` PlanValue[]: Valores e tipos de cobrança do plano (opcional)
    - `type` 'MONTHLY' | 'YEARLY' | 'SEMESTER', required: Tipo de cobrança do plano
    - `value` number, double: Valor total do período (calculado automaticamente)
    - `valuePerMonth` number, double, required: Valor mensal equivalente
  - `acceptPaymentMethods` string[]: Métodos de pagamento aceitos (opcional)

## Response `200`

Plano atualizado com sucesso

- PlanResponse
  - `uuid` string, uuid, required: UUID único do plano
  - `title` string, required: Título do plano
  - `description` string, required: Descrição do plano
  - `active` boolean, required: Se o plano está ativo
  - `bullets` PlanBullet[]: Lista de benefícios do plano
    - `title` string: Título do benefício (opcional)
    - `description` string, required: Descrição do benefício
  - `values` PlanValue[], required: Valores e tipos de cobrança do plano
    - `type` 'MONTHLY' | 'YEARLY' | 'SEMESTER', required: Tipo de cobrança do plano
    - `value` number, double: Valor total do período (calculado automaticamente)
    - `valuePerMonth` number, double, required: Valor mensal equivalente
  - `acceptPaymentMethods` string[], required: Métodos de pagamento aceitos

## Other responses

- `400`: Dados inválidos fornecidos
- `401`: Token de API inválido ou ausente
- `404`: Plano não encontrado
- `500`: Erro interno do servidor

---

[API](https://skmtc.dev/barte/apis/api-de-sellers-v2-atualizada.md) - [All operations](https://skmtc.dev/barte/apis/api-de-sellers-v2-atualizada/llms.txt) - [OpenAPI document](https://skmtc.dev/barte/apis/api-de-sellers-v2-atualizada/revisions/f0dd55b167f1?raw)