---
title: "Update a Plan"
method: PATCH
path: "/v1/plans/{plan_id}"
---

# Update a Plan

`PATCH /v1/plans/{plan_id}`

This API updates an existing plan.

## Path parameters

- `plan_id` string, required

## Headers

- `Accept` string, required
- `Content-Type` string, required

## Request body

- object
  - `name` string, required — Name of the plan.<br><table style='width: 100%; border-collapse: collapse;'><tr><td style='text-align: center;'><b>Format</b></td><td style='text-align: center;'><b>Min Length</b></td><td style='text-align: center;'><b>Max Length</b></td><td style='text-align: center;'><b>Examples</b></td></tr><tr><td>Alphanumeric and Special Characters</td><td>3 characters</td><td>50 characters</td><td>`mynewplanname`</td></tr></table>
  - `statement_descriptor` string — An arbitrary string to be displayed on a plan.<br><table style='width: 100%; border-collapse: collapse;'><tr><td style='text-align: center;'><b>Format</b></td><td style='text-align: center;'><b>Min Length</b></td><td style='text-align: center;'><b>Max Length</b></td><td style='text-align: center;'><b>Examples</b></td></tr><tr><td>Alphanumeric and Special Characters</td><td>5 characters</td><td>25 characters</td><td>`A1 Company 888-888-8888`</td></tr></table>
  - `trial_period_days` integer — Number of days of the trial period that a customer is not charged for.<br><style>td { padding: 2px 4px; border: 1px solid #ddd; font-size: 0.65em; line-height: 1.2; }</style><table style='width: 100%; border-collapse: collapse;'><tr><td style='text-align: center;'><b>Format</b></td><td style='text-align: center;'><b>Allowed Values</b></td></tr><tr><td>Numeric</td><td>`0 - 365`</td></tr></table>

## Response `200`

200

- object
  - `data` object
    - `object` string
    - `plan_id` string
    - `amount` integer
    - `interval` string
    - `interval_count` integer
    - `name` string
    - `plan_description` unknown
    - `statement_descriptor` string
    - `trial_period_days` string
    - `currency` string
    - `created_at` integer
    - `updated_at` integer
  - `meta` object
    - `include` unknown[]
      - unknown
    - `custom` unknown[]
      - unknown

## Other responses

- `422` — 422

---

[API](https://skmtc.net/payarc/apis/payarc-sandbox.md) · [All operations](https://skmtc.net/payarc/apis/payarc-sandbox/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/payarc/payarc-sandbox/versions/face82bdd778/schema)