Skip to main content
PUT
Create or update a bundle

Authorizations

Authorization
string
header
required

API key issued by VitaRelay. Send as Authorization: Bearer vr_live_… (production) or Authorization: Bearer vr_test_… (sandbox).

Body

application/json
name
string
required
pricing_mode
enum<string>
required
Available options:
sum,
flat,
package_markup
items
object[]
required
Minimum array length: 1
id
string<uuid> | null
description
string | null
image_url
string | null
flat_price_cents
integer | null

Required and must be above zero when pricing_mode is flat.

package_markup_type
enum<string> | null
Available options:
percent,
flat,
null
package_markup_value
number
Required range: x >= 0
is_listed
boolean
default:true
is_subscribable
boolean
deprecated

Legacy alias. Prefer purchase_mode.

purchase_mode
enum<string>

Controls whether checkout permits one-time purchases, subscriptions, or both.

Available options:
one_time,
subscription,
both
default_cadence
enum<string> | null

Required when is_subscribable is true.

Available options:
weekly,
monthly,
quarterly,
null
first_order_immediate
boolean

Response

The created or updated bundle.

bundle
object

A multi-product package, optionally subscribable.