Product Bundles
Update a product bundle
Patches an existing product bundle. Supplying prices replaces the bundle’s full price set.
PATCH
/
bundles
/
{id}
Update a product bundle
curl --request PATCH \
--url https://api.alguna.io/bundles/{id} \
--header 'Alguna-Version: <alguna-version>' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"description": "<string>",
"name": "Updated Plan",
"prices": [
{
"billing_direction": "arrears",
"charge_on_contract_start": true,
"fee_type": "fixed",
"product_id": "<string>",
"type": "unit",
"billing_interval": "monthly",
"billing_interval_count": 3,
"billing_interval_unit": "month",
"display_order": 123,
"metric_ids": [
"<string>"
],
"recurring_instalment_interval_count": 1,
"recurring_instalment_interval_unit": "month",
"trial_period_days": 123
}
]
}
'{
"id": "bnd_01H1VECT",
"name": "Standard Plan",
"prices": [
{
"billing_direction": "arrears",
"charge_on_contract_start": true,
"created_at": "2023-11-07T05:31:56Z",
"currency": "USD",
"fee_type": "fixed",
"id": "<string>",
"product": {
"description": "<string>",
"fee_type": "fixed",
"id": "<string>",
"name": "Platform Fee",
"payment_terms": "arrears",
"metric_ids": [
"<string>"
]
},
"product_id": "<string>",
"type": "unit",
"updated_at": "2023-11-07T05:31:56Z",
"billing_frequency": "recurring",
"billing_interval": "monthly",
"billing_interval_count": 3,
"billing_interval_unit": "month",
"discount": {
"amount": "<string>",
"duration_unit": "<string>",
"duration_value": 123
},
"display_order": 123,
"expression_pricing_model": {
"charges": [
{
"description": "<string>",
"quantity_expression": "<string>",
"unit_price_expression": "<string>"
}
]
},
"fixed_pricing_model": {
"price_per_unit": "<string>",
"total": "<string>",
"units": 123
},
"graduated_percentage_pricing_model": {
"tiers": [
{
"min_units": 123,
"fixed_fee": "<string>",
"max_units": 123,
"percentage": "<string>"
}
]
},
"graduated_tiered_pricing_model": {
"tiers": [
{
"min_units": 123,
"fixed_fee": "<string>",
"max_units": 123,
"price_per_unit": "<string>"
}
],
"units": 123
},
"maximum_spend": {
"amount": "<string>",
"period": "<string>"
},
"metric_ids": [
"<string>"
],
"minimum_spend": {
"amount": "<string>",
"period": "<string>"
},
"prepaid_fixed_tiered_pricing_model": {
"overages_charge_interval": "<string>",
"prepaid_units": 123,
"tiers": [
{
"min_units": 123,
"fixed_fee": "<string>",
"max_units": 123,
"price_per_unit": "<string>"
}
]
},
"prepaid_tiered_pricing_model": {
"prepaid_units": 123,
"tiers": [
{
"min_units": 123,
"fixed_fee": "<string>",
"max_units": 123,
"price_per_unit": "<string>"
}
]
},
"tiered_percentage_pricing_model": {
"tiers": [
{
"min_units": 123,
"fixed_fee": "<string>",
"max_units": 123,
"percentage": "<string>"
}
]
},
"tiered_pricing_model": {
"tiers": [
{
"min_units": 123,
"fixed_fee": "<string>",
"max_units": 123,
"price_per_unit": "<string>"
}
],
"units": 123
},
"trial_period_days": 123,
"unit_pricing_model": {
"price_per_unit": "<string>"
},
"volume_percentage_pricing_model": {
"percentage": "<string>",
"price_per_unit": "<string>",
"fixed_fee": "<string>"
}
}
],
"description": "Our standard plan bundle"
}Authorizations
API key authentication. Pass your API key as a Bearer token.
Headers
Available options:
2026-04-01 A unique string used to ensure the request is processed exactly once. If you retry a request with the same idempotency key within 24 hours, the original response is returned without re-executing the operation.
Maximum string length:
255Example:
"ik_a1b2c3d4e5f6"
Path Parameters
Unique identifier for the bundle
Body
application/json
Response
Success
Unique identifier for the bundle
Example:
"bnd_01H1VECT"
The name of the bundle
Example:
"Standard Plan"
Prices included in this bundle
Show child attributes
Show child attributes
A brief description of the bundle
Example:
"Our standard plan bundle"
Previous
List productsReturns a paginated list of products. Supports filtering by fee type (`fixed` or `metered`), payment terms (`advance` or `arrears`), and associated metric IDs.
Next
⌘I
Update a product bundle
curl --request PATCH \
--url https://api.alguna.io/bundles/{id} \
--header 'Alguna-Version: <alguna-version>' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"description": "<string>",
"name": "Updated Plan",
"prices": [
{
"billing_direction": "arrears",
"charge_on_contract_start": true,
"fee_type": "fixed",
"product_id": "<string>",
"type": "unit",
"billing_interval": "monthly",
"billing_interval_count": 3,
"billing_interval_unit": "month",
"display_order": 123,
"metric_ids": [
"<string>"
],
"recurring_instalment_interval_count": 1,
"recurring_instalment_interval_unit": "month",
"trial_period_days": 123
}
]
}
'{
"id": "bnd_01H1VECT",
"name": "Standard Plan",
"prices": [
{
"billing_direction": "arrears",
"charge_on_contract_start": true,
"created_at": "2023-11-07T05:31:56Z",
"currency": "USD",
"fee_type": "fixed",
"id": "<string>",
"product": {
"description": "<string>",
"fee_type": "fixed",
"id": "<string>",
"name": "Platform Fee",
"payment_terms": "arrears",
"metric_ids": [
"<string>"
]
},
"product_id": "<string>",
"type": "unit",
"updated_at": "2023-11-07T05:31:56Z",
"billing_frequency": "recurring",
"billing_interval": "monthly",
"billing_interval_count": 3,
"billing_interval_unit": "month",
"discount": {
"amount": "<string>",
"duration_unit": "<string>",
"duration_value": 123
},
"display_order": 123,
"expression_pricing_model": {
"charges": [
{
"description": "<string>",
"quantity_expression": "<string>",
"unit_price_expression": "<string>"
}
]
},
"fixed_pricing_model": {
"price_per_unit": "<string>",
"total": "<string>",
"units": 123
},
"graduated_percentage_pricing_model": {
"tiers": [
{
"min_units": 123,
"fixed_fee": "<string>",
"max_units": 123,
"percentage": "<string>"
}
]
},
"graduated_tiered_pricing_model": {
"tiers": [
{
"min_units": 123,
"fixed_fee": "<string>",
"max_units": 123,
"price_per_unit": "<string>"
}
],
"units": 123
},
"maximum_spend": {
"amount": "<string>",
"period": "<string>"
},
"metric_ids": [
"<string>"
],
"minimum_spend": {
"amount": "<string>",
"period": "<string>"
},
"prepaid_fixed_tiered_pricing_model": {
"overages_charge_interval": "<string>",
"prepaid_units": 123,
"tiers": [
{
"min_units": 123,
"fixed_fee": "<string>",
"max_units": 123,
"price_per_unit": "<string>"
}
]
},
"prepaid_tiered_pricing_model": {
"prepaid_units": 123,
"tiers": [
{
"min_units": 123,
"fixed_fee": "<string>",
"max_units": 123,
"price_per_unit": "<string>"
}
]
},
"tiered_percentage_pricing_model": {
"tiers": [
{
"min_units": 123,
"fixed_fee": "<string>",
"max_units": 123,
"percentage": "<string>"
}
]
},
"tiered_pricing_model": {
"tiers": [
{
"min_units": 123,
"fixed_fee": "<string>",
"max_units": 123,
"price_per_unit": "<string>"
}
],
"units": 123
},
"trial_period_days": 123,
"unit_pricing_model": {
"price_per_unit": "<string>"
},
"volume_percentage_pricing_model": {
"percentage": "<string>",
"price_per_unit": "<string>",
"fixed_fee": "<string>"
}
}
],
"description": "Our standard plan bundle"
}