Skip to main content
DELETE
DELETE /subscription/plan/{id} soft-archives a plan by setting its deletedAt timestamp. Existing subscriptions on the archived plan continue billing normally. At each subscriber’s next renewal date, Therius will cancel those subscriptions rather than renewing them. No new subscribers can enroll in an archived plan.
This is a soft-delete — the plan row is not permanently removed, so it stays in the database for audit purposes. It is, however, excluded from GET /subscription/plan list results once archived (that endpoint filters out deleted plans); look it up directly via GET /subscription/plan/{id} if you need to inspect an archived plan.
Returns 200 OK with { "deleted": true }.

​
Errors

Once a plan is archived, existing subscribers will be automatically cancelled at their next renewal. Migrate subscribers to a new plan using change-plan before archiving if you want them to continue billing uninterrupted.

Authorizations

​
Authorization
string
header
required

Your secret API key: Bearer prv_production_xxx (production) or Bearer prv_sandbox_xxx (sandbox).

Path Parameters

​
id
string
required

Query Parameters

​
merchantCode
string
required

Your merchant account identifier. Validated against the Bearer key's merchant.

Response

200 - application/json

Plan archived

​
deleted
boolean
Example:

true