Products::Price

Update a single price

put/products/prices/{id}

Request

Path parameters

idstring required

Request body

Example request

{
  "products_price": {
    "products_price": {
      "name": "Example Price",
      "amount": "100.00",
      "cost": "0.00",
      "currency": "USD",
      "duration": 1,
      "interval": "months",
      "trial_interval": "days",
      "trial_duration": 14,
      "trial_amount": "0.00",
      "setup_amount": null,
      "self_cancel": true,
      "self_upgrade": true,
      "self_downgrade": true,
      "self_reactivate": true,
      "interval_count": 1,
      "payment_type": "one_time",
      "visible": true,
      "compare_at_amount": null,
      "key": null,
      "archived": false
    }
  }
}

Response

OK

idinteger

ID

public_idstring nullable

Price public ID

variant_idinteger nullable

Variant

namestring nullable

Name

amountstring

Amount

coststring nullable

Cost

currencystring

Currency

durationinteger nullable

Amount of payments

intervalstring nullable

Interval

trial_intervalstring nullable

Trial interval

trial_durationinteger nullable

Trial duration

trial_amountstring

Trial Amount

setup_amountstring nullable

Setup amount

self_cancelboolean nullable

Customer can cancel

self_upgradeboolean nullable

Legacy setting with no effect: no checkout, customer portal or API plan change reads it. GET /products/prices/{price_id}/change_options lists the upgrades and downgrades the API allows from this price.

self_downgradeboolean nullable

Legacy setting with no effect: no checkout, customer portal or API plan change reads it. GET /products/prices/{price_id}/change_options lists the upgrades and downgrades the API allows from this price.

self_reactivateboolean nullable

Customer can reactivate

interval_countinteger nullable

Interval count

payment_type'one_time' | 'subscription' | 'payment_plan' | 'null' nullable

Defaults to 'one_time' if left blank

visibleboolean nullable

Visible

compare_at_amountstring nullable

Compare at amount

keystring nullable

Key

archivedboolean nullable

Archived

created_atstring date-time nullable

Added

updated_atstring date-time nullable

Updated

Example response

{
  "id": 14,
  "public_id": "WpEGzF",
  "variant_id": 14,
  "name": "Example Price",
  "amount": "100.00",
  "cost": "0.00",
  "currency": "USD",
  "duration": null,
  "interval": null,
  "trial_interval": null,
  "trial_duration": null,
  "trial_amount": "0.00",
  "setup_amount": null,
  "self_cancel": true,
  "self_upgrade": true,
  "self_downgrade": true,
  "self_reactivate": true,
  "interval_count": null,
  "payment_type": "one_time",
  "visible": true,
  "compare_at_amount": null,
  "key": null,
  "archived": false,
  "created_at": "2025-01-01T00:00:00.000Z",
  "updated_at": "2025-01-01T00:00:00.000Z"
}

Changes

    • breaking

      request property / was restricted to a list of enum values

    • breaking

      request property / was restricted to a list of enum values

    • breaking

      the request property / became not nullable

    • breaking

      the request property / became not nullable

    • breaking

      the request property / became not nullable

    • breaking

      the request property / became not nullable

    • breaking

      the request property / became not nullable

    • breaking

      the request property / became not nullable

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response's property type changed from string to integer null for status

    • breaking

      the response's property type changed from string to integer null for status

    • breaking

      the response's property type changed from string to integer null for status

    • warning

      added the new undefined enum value to the response property for the response status

    • info

      added the new days enum value to the request property /

    • info

      added the new days enum value to the request property /

    • info

      added the new months enum value to the request property /

    • info

      added the new months enum value to the request property /

    • info

      added the new quarters enum value to the request property /

    • info

      added the new quarters enum value to the request property /

    • info

      added the new undefined enum value to the request property /

    • info

      added the new undefined enum value to the request property /

    • info

      added the new undefined enum value to the request property /

    • info

      added the new weeks enum value to the request property /

    • info

      added the new weeks enum value to the request property /

    • info

      added the new years enum value to the request property /

    • info

      added the new years enum value to the request property /

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status