Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.particle.pro/llms.txt

Use this file to discover all available pages before exploring further.

HTTP status409 Conflict
Error codecancellation_revertable
Resolve actionresume_subscription

What happened

POST /v1/organizations/{orgId}/billing/subscription (select-plan) or PUT /v1/organizations/{orgId}/billing/subscription (change-plan) was called on an organization whose subscription is canceled but the cancellation has not yet taken effect — the underlying Orb subscription is still active with a scheduled end date in the future. This is the typical state for paid plans (e.g. Growth) canceled mid-billing-period. Selecting or changing a plan in this state would strand the still-active Orb subscription with a pending cancellation, so the API rejects the request and points you at the resume endpoint instead.

How to fix

Call POST /v1/organizations/{orgId}/billing/subscription/resume to unschedule the cancellation. This restores subscription_status to ACTIVE and clears canceled_at — no new credit is granted, and the previous plan is preserved. To switch plans after resuming, follow up with PUT /v1/organizations/{orgId}/billing/subscription.