Sign in

v52

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-03101355448.4 KB
OpenMeter Product Catalog

Update plan

Update a plan by id.

put/openmeter/plans/{planId}

Path parameters

planIdstring required

ULID (Universally Unique Lexicographically Sortable Identifier).

Example:01G65Z755AFWAKHE12NY0CQ9FH

Request body

namestring required

Display name of the resource.

Between 1 and 256 characters.

descriptionstring

Optional description of the resource.

Maximum 1024 characters.

labelsLabels

Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.

Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".

pro_rating_enabledboolean

Whether pro-rating is enabled for this plan.

Response

Plan upsert response.

idstring required

ULID (Universally Unique Lexicographically Sortable Identifier).

namestring required

Display name of the resource.

Between 1 and 256 characters.

descriptionstring

Optional description of the resource.

Maximum 1024 characters.

labelsLabels

Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.

Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".

created_atstring date-time required

RFC3339 formatted date-time string in UTC.

updated_atstring date-time required

RFC3339 formatted date-time string in UTC.

deleted_atstring date-time

RFC3339 formatted date-time string in UTC.

keystring required

A key is a unique string that is used to identify a resource.

versioninteger required

Plans are versioned to allow you to make changes without affecting running subscriptions.

billing_cadencestring ISO8601 required

ISO 8601 Duration string.

pro_rating_enabledboolean

Whether pro-rating is enabled for this plan.

effective_fromstring date-time

RFC3339 formatted date-time string in UTC.

effective_tostring date-time

RFC3339 formatted date-time string in UTC.

status'draft' | 'active' | 'archived' | 'scheduled' required

The status of a plan.

  • draft: The plan has not yet been published and can be edited.
  • active: The plan is published and can be used in subscriptions.
  • archived: The plan is no longer available for use.
  • scheduled: The plan is scheduled to be published at a future date.
settlement_mode'credit_then_invoice' | 'credit_only'

Settlement mode for billing.

Values:

  • credit_then_invoice: Credits are applied first, then any remainder is invoiced.
  • credit_only: Usage is settled exclusively against credits.