curl --location --request PUT 'https://api.stateset.com/v1/subscriptions/sub_0901f083-aa1c-43c5-af5c-0a9d2fc64e30' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data-raw '{
"items": [
{
"id": "si_123456",
"quantity": 3
},
{
"product_id": "prod_premium_support",
"quantity": 1
}
],
"coupon_id": "SAVE20"
}'
const subscription = await stateset.subscriptions.update(
'sub_0901f083-aa1c-43c5-af5c-0a9d2fc64e30',
{
items: [
{
id: "si_123456",
quantity: 3
},
{
product_id: "prod_premium_support",
quantity: 1
}
],
coupon_id: "SAVE20"
}
);
subscription = stateset.subscriptions.update(
'sub_0901f083-aa1c-43c5-af5c-0a9d2fc64e30',
items=[
{
"id": "si_123456",
"quantity": 3
},
{
"product_id": "prod_premium_support",
"quantity": 1
}
],
coupon_id="SAVE20"
)
{
"id": "sub_0901f083-aa1c-43c5-af5c-0a9d2fc64e30",
"object": "subscription",
"updated_at": "2024-01-20T14:00:00Z",
"status": "active",
"items": [
{
"id": "si_123456",
"product_id": "prod_addon_storage",
"product_name": "Additional Storage (10GB)",
"quantity": 3,
"unit_price": 500,
"amount": 1500
},
{
"id": "si_789012",
"product_id": "prod_premium_support",
"product_name": "Premium Support",
"quantity": 1,
"unit_price": 2900,
"amount": 2900
}
],
"discount": {
"coupon": {
"id": "SAVE20",
"percent_off": 20,
"duration": "repeating",
"duration_in_months": 3
}
},
"subtotal": 14300,
"discount_amount": 2860,
"tax_amount": 915,
"total_amount": 12355
}
Update Subscription
Update an existing subscription
PUT
/
v1
/
subscriptions
/
:id
curl --location --request PUT 'https://api.stateset.com/v1/subscriptions/sub_0901f083-aa1c-43c5-af5c-0a9d2fc64e30' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data-raw '{
"items": [
{
"id": "si_123456",
"quantity": 3
},
{
"product_id": "prod_premium_support",
"quantity": 1
}
],
"coupon_id": "SAVE20"
}'
const subscription = await stateset.subscriptions.update(
'sub_0901f083-aa1c-43c5-af5c-0a9d2fc64e30',
{
items: [
{
id: "si_123456",
quantity: 3
},
{
product_id: "prod_premium_support",
quantity: 1
}
],
coupon_id: "SAVE20"
}
);
subscription = stateset.subscriptions.update(
'sub_0901f083-aa1c-43c5-af5c-0a9d2fc64e30',
items=[
{
"id": "si_123456",
"quantity": 3
},
{
"product_id": "prod_premium_support",
"quantity": 1
}
],
coupon_id="SAVE20"
)
{
"id": "sub_0901f083-aa1c-43c5-af5c-0a9d2fc64e30",
"object": "subscription",
"updated_at": "2024-01-20T14:00:00Z",
"status": "active",
"items": [
{
"id": "si_123456",
"product_id": "prod_addon_storage",
"product_name": "Additional Storage (10GB)",
"quantity": 3,
"unit_price": 500,
"amount": 1500
},
{
"id": "si_789012",
"product_id": "prod_premium_support",
"product_name": "Premium Support",
"quantity": 1,
"unit_price": 2900,
"amount": 2900
}
],
"discount": {
"coupon": {
"id": "SAVE20",
"percent_off": 20,
"duration": "repeating",
"duration_in_months": 3
}
},
"subtotal": 14300,
"discount_amount": 2860,
"tax_amount": 915,
"total_amount": 12355
}
This endpoint updates subscription details including items, quantities, and payment methods. Plan changes take effect at the next billing cycle.
Authentication
This endpoint requires a valid API key withsubscriptions:write permissions.
Authorization: Bearer YOUR_API_KEY
Path Parameters
string
required
The unique identifier of the subscription
Request Body
string
Change to a different plan (takes effect next billing cycle)
integer
Update subscription quantity
array
string
Update default payment method
string
Apply a coupon
string
Extend or end trial period
object
Update custom fields
Response
Returns the updated subscription object.curl --location --request PUT 'https://api.stateset.com/v1/subscriptions/sub_0901f083-aa1c-43c5-af5c-0a9d2fc64e30' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data-raw '{
"items": [
{
"id": "si_123456",
"quantity": 3
},
{
"product_id": "prod_premium_support",
"quantity": 1
}
],
"coupon_id": "SAVE20"
}'
const subscription = await stateset.subscriptions.update(
'sub_0901f083-aa1c-43c5-af5c-0a9d2fc64e30',
{
items: [
{
id: "si_123456",
quantity: 3
},
{
product_id: "prod_premium_support",
quantity: 1
}
],
coupon_id: "SAVE20"
}
);
subscription = stateset.subscriptions.update(
'sub_0901f083-aa1c-43c5-af5c-0a9d2fc64e30',
items=[
{
"id": "si_123456",
"quantity": 3
},
{
"product_id": "prod_premium_support",
"quantity": 1
}
],
coupon_id="SAVE20"
)
{
"id": "sub_0901f083-aa1c-43c5-af5c-0a9d2fc64e30",
"object": "subscription",
"updated_at": "2024-01-20T14:00:00Z",
"status": "active",
"items": [
{
"id": "si_123456",
"product_id": "prod_addon_storage",
"product_name": "Additional Storage (10GB)",
"quantity": 3,
"unit_price": 500,
"amount": 1500
},
{
"id": "si_789012",
"product_id": "prod_premium_support",
"product_name": "Premium Support",
"quantity": 1,
"unit_price": 2900,
"amount": 2900
}
],
"discount": {
"coupon": {
"id": "SAVE20",
"percent_off": 20,
"duration": "repeating",
"duration_in_months": 3
}
},
"subtotal": 14300,
"discount_amount": 2860,
"tax_amount": 915,
"total_amount": 12355
}
โI