PATCH
/
v1
/
products
/
{id}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required

The product ID.

Body

application/json

Schema to update a product.

metadata
object | null

Key-value object allowing you to store additional information.

The key must be a string with a maximum length of 40 characters. The value must be either:

  • A string with a maximum length of 500 characters
  • An integer
  • A boolean

You can store up to 50 key-value pairs.

name
string | null

The name of the product.

Minimum length: 3
description
string | null

The description of the product.

recurring_interval
enum<string> | null

The recurring interval of the product. If None, the product is a one-time purchase. Can only be set on legacy recurring products. Once set, it can't be changed.

Available options:
month,
year
is_archived
boolean | null

Whether the product is archived. If true, the product won't be available for purchase anymore. Existing customers will still have access to their benefits, and subscriptions will continue normally.

prices
object[] | null

List of available prices for this product. If you want to keep existing prices, include them in the list as an ExistingProductPrice object.

medias
string[] | null

List of file IDs. Each one must be on the same organization as the product, of type product_media and correctly uploaded.

attached_custom_fields
object[] | null

List of custom fields to attach.

Response

200
application/json
Product updated.

A product.

created_at
string
required

Creation timestamp of the object.

modified_at
string | null
required

Last modification timestamp of the object.

id
string
required

The ID of the product.

name
string
required

The name of the product.

description
string | null
required

The description of the product.

recurring_interval
enum<string> | null
required

The recurring interval of the product. If None, the product is a one-time purchase.

Available options:
month,
year
is_recurring
boolean
required

Whether the product is a subscription.

is_archived
boolean
required

Whether the product is archived and no longer available.

organization_id
string
required

The ID of the organization owning the product.

metadata
object
required
prices
object[]
required

List of prices for this product.

benefits
object[]
required

List of benefits granted by the product.

medias
object[]
required

List of medias associated to the product.

attached_custom_fields
object[]
required

List of custom fields attached to the product.