---
title: "Change plan; shorter retention requires explicit deletion confirmation"
method: POST
path: "/api/subscription"
---

# Change plan; shorter retention requires explicit deletion confirmation

`POST /api/subscription`

## Request

- Base URL: `https://disban.io`
- URL: `https://disban.io/api/subscription`
- Auth: API key in cookie `disban_session`

## Request body

- object
  - `confirm_deletion` boolean: Send true only after accepting the retention warning returned with HTTP 409. Older activity is permanently deleted oldest first.
  - `plan_id` 'free', required

## Response `200`

Plan changed

- Subscription
  - `plan` Plan, required
    - `id` 'free' | 'launch' | 'growth' | 'scale', required
    - `selectable` boolean: Only Free can be activated. Launch, Growth, and Scale are coming soon.
    - `name` string, required
    - `monthly_checks` integer, required
    - `requests_per_second` integer, required
    - `description` string
  - `offer` Offer, required
    - `currency` 'USD', required
    - `monthly_price` 0, required
    - `discount_percent` 0, required
    - `payment_required` false, required
    - `auto_charge` false, required
    - `terms` string, required
  - `period` string, required
  - `used` integer, required: Total checks charged this UTC month, including bonus checks.
  - `monthly_used` integer
  - `monthly_remaining` integer
  - `bonus_used` integer
  - `bonus_remaining` integer
  - `remaining` integer, required
  - `resets_at` string, date-time, required

## Other responses

- `400`: Request could not be completed
- `401`: Request could not be completed
- `403`: Request could not be completed
- `409`: Request could not be completed
- `413`: Request could not be completed
- `415`: Request could not be completed
- `429`: Rate or quota limit; honor Retry-After
- `502`: Request could not be completed
- `503`: Request could not be completed

---

[API](https://skmtc.dev/disban/apis/disban-api.md) · [All operations](https://skmtc.dev/disban/apis/disban-api/llms.txt) · [OpenAPI document](https://skmtc.dev/disban/apis/disban-api/revisions/1becfdd524a2?raw)