Update plan

PUT

/v1/plans/{plan_id}

Update a plan.

Parameters

Path Parameters

plan_id

required

Plan Id

string format: uuid

Request Body ^required

PlanUpdate

object

name

Any of:

string

string

>= 1 characters <= 255 characters

null

null

description

Any of:

string

string

null

null

amount_cents

Any of:

integer

integer

null

null

currency

Any of:

string

string

>= 3 characters <= 3 characters

null

null

trial_period_days

Any of:

integer

integer

null

null

charges

Any of:

Array<object>

Array<object>

ChargeInput

Charge input when creating/updating a plan.

object

billable_metric_id

required

Billable Metric Id

string format: uuid

charge_model

required

ChargeModel

string

Allowed values: standard graduated volume package percentage graduated_percentage custom dynamic

properties

Properties

object

key

additional properties

any

filters

Filters

Array<object>

ChargeFilterInput

Filter configuration for a charge within a plan.

object

billable_metric_filter_id

required

Billable Metric Filter Id

string format: uuid

values

Values

Array<string>

properties

Properties

object

key

additional properties

any

invoice_display_name

Any of:

string

string

<= 255 characters

null

null

null

null

Responses

200

Successful Response

PlanResponse

object

id

required

Id

string format: uuid

code

required

Code

string

name

required

Name

string

description

required

Any of:

string

string

null

null

interval

required

PlanInterval

string

Allowed values: weekly monthly quarterly yearly

amount_cents

required

Amount Cents

integer

currency

required

Currency

string

trial_period_days

required

Trial Period Days

integer

charges

Charges

Array<object>

ChargeOutput

Charge output in plan responses.

object

id

required

Id

string format: uuid

plan_id

required

Plan Id

string format: uuid

billable_metric_id

required

Billable Metric Id

string format: uuid

charge_model

required

ChargeModel

string

Allowed values: standard graduated volume package percentage graduated_percentage custom dynamic

properties

required

Properties

object

key

additional properties

any

created_at

required

Created At

string format: date-time

updated_at

required

Updated At

string format: date-time

created_at

required

Created At

string format: date-time

updated_at

required

Updated At

string format: date-time

400

Invalid billable metric or filter reference

401

Unauthorized – invalid or missing API key

404

Plan not found

422

Validation error