---
title: "Atualiza campos mutáveis de um plano"
method: PATCH
path: "/v1/plans/{id}"
tags: ["Plans"]
---

# Atualiza campos mutáveis de um plano

`PATCH /v1/plans/{id}`

## Request

- Base URL: `https://api.sandbox.mupag.com.br`
- URL: `https://api.sandbox.mupag.com.br/v1/plans/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, uuid, required

## Request body

- UpdatePlanRequest
  - `name` string, required
  - `description` string
  - `amount_cents` integer
  - `billing_period_unit` string
  - `billing_period_interval` integer
  - `trial_days` integer
  - `setup_fee_cents` integer

## Response `200`

Plano atualizado

- PlanResponse
  - `id` string, uuid, required
  - `product_id` string, uuid, required
  - `merchant_id` string, uuid, required
  - `environment` string, required
  - `name` string, required
  - `description` string
  - `amount_cents` integer, required
  - `currency` string, required
  - `billing_period_unit` string, required
  - `billing_period_interval` integer, required
  - `trial_days` integer, required
  - `setup_fee_cents` integer, required
  - `status` string, required
  - `first_subscription_at` string, date-time
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `archived_at` string, date-time

## Other responses

- `400`: Erro de validação
- `401`: Falha de autenticação
- `403`: Permissão insuficiente
- `404`: Recurso não encontrado
- `422`: Erro de validação

---

[API](https://skmtc.dev/mupag/apis/mupag-public-merchant-api.md) · [All operations](https://skmtc.dev/mupag/apis/mupag-public-merchant-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mupag/apis/mupag-public-merchant-api/revisions/677904516d2d?raw)