Edit an owned product subscription
Apply safe edits through the shared subscription update domain. The member credential fixes ownership; saved payment and address references are rechecked under write locks. Subscription country is immutable. Dates use the subscription’s timezone and existing schedule limits. Bundle points changes are atomic; co-submitted quantity and payment changes apply only to the target. This operation does not quote, charge or dispatch a renewal. Return refreshed detail and public resolved/changed subscription IDs, including an empty changed_ids array for no-op edits. Responses are no-store and never return 304. backup_cards_enabled, sent on its own, turns backup cards on or off for the member at this company instead of editing the subscription. A shopper’s earlier next_bill_date needs confirm_early_order set to true; without it the 422 carries the early_order_confirmation_required code with scheduled_date, requested_date and last_bill_date, which is null when the subscription has never billed.
curl --request PATCH \
--url https://api.fluid.app/api/member/v2026-10/subscriptions/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"quantity": 2,
"auto_apply_points": false
}
'{
"status": 200,
"data": {
"id": "019a23a4-9211-71bf-8fa5-a5f31a82a0de",
"status": "active",
"frequency": {
"interval": 1,
"unit": "month"
},
"next_billing_at": "2026-11-01T12:00:00Z",
"currency": "USD",
"next_total": null,
"items_count": 2,
"paused_until": null,
"created_at": "2026-10-01T12:00:00Z",
"items": [
{
"id": "019a23a4-9211-71bf-8fa5-a5f31a82a0e2",
"title": "Monthly wellness bundle",
"variant_title": "Standard",
"sku": "WELLNESS-01",
"quantity": 2,
"unit_price": "20.0",
"total": "40.0",
"image_url": null
}
],
"shipping_address": null,
"payment_method": null,
"discounts": [],
"next_order_preview": null,
"auto_apply_points": false,
"auto_apply_points_available": true,
"billing_cycle_limit_reached": false,
"backup_cards_available": true,
"backup_cards_enabled": false
},
"meta": {
"request_uuid": "019a23a4-9211-71bf-8fa5-a5f31a82a0de",
"timestamp": "2026-10-01T12:00:00Z",
"bundle_pagination": {
"next_cursor": null
},
"subscription_update": {
"resolved_ids": [
"019a23a4-9211-71bf-8fa5-a5f31a82a0de"
],
"changed_ids": [
"019a23a4-9211-71bf-8fa5-a5f31a82a0de"
]
}
}
}{
"status": 123,
"error": {
"message": "<string>",
"details": {}
},
"meta": {
"request_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"timestamp": "2023-11-07T05:31:56Z",
"subscription_schedule": {
"next_bill_date": "2023-12-25",
"latest_skip_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pending_skip_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pending_skip_date": "2023-12-25",
"can_skip": true,
"applied": true
},
"code": "next_bill_date_blackout",
"blocked_date": "2026-11-30",
"blocked_day": 30,
"allowed_date": "2026-11-28",
"scheduled_date": "2026-12-10",
"last_bill_date": "2026-11-10",
"requested_date": "2026-11-30"
}
}{
"status": 123,
"error": {
"message": "<string>",
"details": {}
},
"meta": {
"request_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"timestamp": "2023-11-07T05:31:56Z",
"subscription_schedule": {
"next_bill_date": "2023-12-25",
"latest_skip_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pending_skip_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pending_skip_date": "2023-12-25",
"can_skip": true,
"applied": true
},
"code": "next_bill_date_blackout",
"blocked_date": "2026-11-30",
"blocked_day": 30,
"allowed_date": "2026-11-28",
"scheduled_date": "2026-12-10",
"last_bill_date": "2026-11-10",
"requested_date": "2026-11-30"
}
}{
"status": 123,
"error": {
"message": "<string>",
"details": {}
},
"meta": {
"request_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"timestamp": "2023-11-07T05:31:56Z",
"subscription_schedule": {
"next_bill_date": "2023-12-25",
"latest_skip_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pending_skip_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pending_skip_date": "2023-12-25",
"can_skip": true,
"applied": true
},
"code": "next_bill_date_blackout",
"blocked_date": "2026-11-30",
"blocked_day": 30,
"allowed_date": "2026-11-28",
"scheduled_date": "2026-12-10",
"last_bill_date": "2026-11-10",
"requested_date": "2026-11-30"
}
}{
"status": 123,
"error": {
"message": "<string>",
"details": {}
},
"meta": {
"request_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"timestamp": "2023-11-07T05:31:56Z",
"subscription_schedule": {
"next_bill_date": "2023-12-25",
"latest_skip_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pending_skip_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pending_skip_date": "2023-12-25",
"can_skip": true,
"applied": true
},
"code": "next_bill_date_blackout",
"blocked_date": "2026-11-30",
"blocked_day": 30,
"allowed_date": "2026-11-28",
"scheduled_date": "2026-12-10",
"last_bill_date": "2026-11-10",
"requested_date": "2026-11-30"
}
}{
"status": 123,
"error": {
"message": "<string>",
"details": {}
},
"meta": {
"request_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"timestamp": "2023-11-07T05:31:56Z",
"subscription_schedule": {
"next_bill_date": "2023-12-25",
"latest_skip_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pending_skip_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pending_skip_date": "2023-12-25",
"can_skip": true,
"applied": true
},
"code": "next_bill_date_blackout",
"blocked_date": "2026-11-30",
"blocked_day": 30,
"allowed_date": "2026-11-28",
"scheduled_date": "2026-12-10",
"last_bill_date": "2026-11-10",
"requested_date": "2026-11-30"
}
}{
"status": 123,
"error": {
"message": "<string>",
"details": {}
},
"meta": {
"request_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"timestamp": "2023-11-07T05:31:56Z",
"subscription_schedule": {
"next_bill_date": "2023-12-25",
"latest_skip_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pending_skip_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pending_skip_date": "2023-12-25",
"can_skip": true,
"applied": true
},
"code": "next_bill_date_blackout",
"blocked_date": "2026-11-30",
"blocked_day": 30,
"allowed_date": "2026-11-28",
"scheduled_date": "2026-12-10",
"last_bill_date": "2026-11-10",
"requested_date": "2026-11-30"
}
}{
"status": 123,
"error": {
"message": "<string>",
"details": {}
},
"meta": {
"request_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"timestamp": "2023-11-07T05:31:56Z",
"subscription_schedule": {
"next_bill_date": "2023-12-25",
"latest_skip_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pending_skip_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pending_skip_date": "2023-12-25",
"can_skip": true,
"applied": true
},
"code": "next_bill_date_blackout",
"blocked_date": "2026-11-30",
"blocked_day": 30,
"allowed_date": "2026-11-28",
"scheduled_date": "2026-12-10",
"last_bill_date": "2026-11-10",
"requested_date": "2026-11-30"
}
}Authorizations
Body
One or more safe top-level subscription fields. Query parameters and unknown fields are rejected.
- Option 1
- Option 2
- Option 3
- Option 4
- Option 5
- Option 6
Safe subscription edits. Omitted fields retain their current values. References use public UUIDs.
Turn backup cards on or off for the member at this company. When a renewal is declined, Fluid then charges the member's default card, then their other saved cards. The choice is stored on the member, not on the subscription, so it covers every subscription they have at the company and changed_ids is empty. Requires an actual JSON boolean and must be sent on its own. Turning it on is refused with 422 while backup_cards_available is false; turning it off always succeeds, so a member can withdraw even while the company does not offer backup cards.
Response
Updated subscription detail and the public UUIDs covered and changed by the edit.
Refreshed detail plus public IDs covered and changed by the edit. No-op edits have an empty changed_ids array.
curl --request PATCH \
--url https://api.fluid.app/api/member/v2026-10/subscriptions/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"quantity": 2,
"auto_apply_points": false
}
'{
"status": 200,
"data": {
"id": "019a23a4-9211-71bf-8fa5-a5f31a82a0de",
"status": "active",
"frequency": {
"interval": 1,
"unit": "month"
},
"next_billing_at": "2026-11-01T12:00:00Z",
"currency": "USD",
"next_total": null,
"items_count": 2,
"paused_until": null,
"created_at": "2026-10-01T12:00:00Z",
"items": [
{
"id": "019a23a4-9211-71bf-8fa5-a5f31a82a0e2",
"title": "Monthly wellness bundle",
"variant_title": "Standard",
"sku": "WELLNESS-01",
"quantity": 2,
"unit_price": "20.0",
"total": "40.0",
"image_url": null
}
],
"shipping_address": null,
"payment_method": null,
"discounts": [],
"next_order_preview": null,
"auto_apply_points": false,
"auto_apply_points_available": true,
"billing_cycle_limit_reached": false,
"backup_cards_available": true,
"backup_cards_enabled": false
},
"meta": {
"request_uuid": "019a23a4-9211-71bf-8fa5-a5f31a82a0de",
"timestamp": "2026-10-01T12:00:00Z",
"bundle_pagination": {
"next_cursor": null
},
"subscription_update": {
"resolved_ids": [
"019a23a4-9211-71bf-8fa5-a5f31a82a0de"
],
"changed_ids": [
"019a23a4-9211-71bf-8fa5-a5f31a82a0de"
]
}
}
}{
"status": 123,
"error": {
"message": "<string>",
"details": {}
},
"meta": {
"request_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"timestamp": "2023-11-07T05:31:56Z",
"subscription_schedule": {
"next_bill_date": "2023-12-25",
"latest_skip_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pending_skip_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pending_skip_date": "2023-12-25",
"can_skip": true,
"applied": true
},
"code": "next_bill_date_blackout",
"blocked_date": "2026-11-30",
"blocked_day": 30,
"allowed_date": "2026-11-28",
"scheduled_date": "2026-12-10",
"last_bill_date": "2026-11-10",
"requested_date": "2026-11-30"
}
}{
"status": 123,
"error": {
"message": "<string>",
"details": {}
},
"meta": {
"request_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"timestamp": "2023-11-07T05:31:56Z",
"subscription_schedule": {
"next_bill_date": "2023-12-25",
"latest_skip_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pending_skip_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pending_skip_date": "2023-12-25",
"can_skip": true,
"applied": true
},
"code": "next_bill_date_blackout",
"blocked_date": "2026-11-30",
"blocked_day": 30,
"allowed_date": "2026-11-28",
"scheduled_date": "2026-12-10",
"last_bill_date": "2026-11-10",
"requested_date": "2026-11-30"
}
}{
"status": 123,
"error": {
"message": "<string>",
"details": {}
},
"meta": {
"request_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"timestamp": "2023-11-07T05:31:56Z",
"subscription_schedule": {
"next_bill_date": "2023-12-25",
"latest_skip_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pending_skip_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pending_skip_date": "2023-12-25",
"can_skip": true,
"applied": true
},
"code": "next_bill_date_blackout",
"blocked_date": "2026-11-30",
"blocked_day": 30,
"allowed_date": "2026-11-28",
"scheduled_date": "2026-12-10",
"last_bill_date": "2026-11-10",
"requested_date": "2026-11-30"
}
}{
"status": 123,
"error": {
"message": "<string>",
"details": {}
},
"meta": {
"request_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"timestamp": "2023-11-07T05:31:56Z",
"subscription_schedule": {
"next_bill_date": "2023-12-25",
"latest_skip_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pending_skip_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pending_skip_date": "2023-12-25",
"can_skip": true,
"applied": true
},
"code": "next_bill_date_blackout",
"blocked_date": "2026-11-30",
"blocked_day": 30,
"allowed_date": "2026-11-28",
"scheduled_date": "2026-12-10",
"last_bill_date": "2026-11-10",
"requested_date": "2026-11-30"
}
}{
"status": 123,
"error": {
"message": "<string>",
"details": {}
},
"meta": {
"request_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"timestamp": "2023-11-07T05:31:56Z",
"subscription_schedule": {
"next_bill_date": "2023-12-25",
"latest_skip_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pending_skip_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pending_skip_date": "2023-12-25",
"can_skip": true,
"applied": true
},
"code": "next_bill_date_blackout",
"blocked_date": "2026-11-30",
"blocked_day": 30,
"allowed_date": "2026-11-28",
"scheduled_date": "2026-12-10",
"last_bill_date": "2026-11-10",
"requested_date": "2026-11-30"
}
}{
"status": 123,
"error": {
"message": "<string>",
"details": {}
},
"meta": {
"request_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"timestamp": "2023-11-07T05:31:56Z",
"subscription_schedule": {
"next_bill_date": "2023-12-25",
"latest_skip_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pending_skip_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pending_skip_date": "2023-12-25",
"can_skip": true,
"applied": true
},
"code": "next_bill_date_blackout",
"blocked_date": "2026-11-30",
"blocked_day": 30,
"allowed_date": "2026-11-28",
"scheduled_date": "2026-12-10",
"last_bill_date": "2026-11-10",
"requested_date": "2026-11-30"
}
}{
"status": 123,
"error": {
"message": "<string>",
"details": {}
},
"meta": {
"request_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"timestamp": "2023-11-07T05:31:56Z",
"subscription_schedule": {
"next_bill_date": "2023-12-25",
"latest_skip_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pending_skip_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pending_skip_date": "2023-12-25",
"can_skip": true,
"applied": true
},
"code": "next_bill_date_blackout",
"blocked_date": "2026-11-30",
"blocked_day": 30,
"allowed_date": "2026-11-28",
"scheduled_date": "2026-12-10",
"last_bill_date": "2026-11-10",
"requested_date": "2026-11-30"
}
}