Release a Subscription Schedule

​

Releases the schedule from the subscription. Sets status to RELEASED. The subscription continues to bill independently on its existing cadence; the schedule no longer controls future phase transitions.

Path Parameters
  • id
    Type: string
    required

    Subscription schedule ID (ULID).

Body
application/json

All fields are optional. Omit the body or send {} to release immediately.

  • preserve_cancel_date
    Type: boolean

    If true, any cancel_at date already set on the subscription is preserved after release. Defaults to false (the cancel date is cleared).

Responses
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for post/v1/subscription-schedules/{id}/release
curl https://api.paypercut.io/v1/subscription-schedules/01HD7M6DRKZ4Q4QEVWJB0RC1S6/release \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{}'

{
  "id": "01HD7M6DRKZ4Q4QEVWJB0RC1S6",
  "customer": "01KJQ34MWYH0TES77RDXA8T8TT",
  "status": "RELEASED",
  "end_behavior": "RELEASE",
  "subscription": "01XXXXXXXXXXXXXXXXXXXXXXX",
  "released_subscription": "01XXXXXXXXXXXXXXXXXXXXXXX",
  "livemode": false,
  "start_date": "2026-03-01T00:00:00Z",
  "current_phase_index": 1,
  "current_phase": null,
  "next_action_at": null,
  "canceled_at": null,
  "completed_at": null,
  "released_at": "2026-04-01T00:00:00Z",
  "phases": [
    {
      "start_date": "2026-03-01T00:00:00Z",
      "end_date": "2026-04-01T00:00:00Z",
      "phase_index": 0,
      "items": [
        {
          "price": "price_monthly",
          "unit_amount": 1000,
          "currency": "usd",
          "recurring": {
            "interval": "monthly",
            "interval_count": 1,
            "usage_type": "licensed"
          }
        }
      ]
    },
    {
      "start_date": "2026-04-01T00:00:00Z",
      "phase_index": 1,
      "items": [
        {
          "price": "price_monthly",
          "unit_amount": 1000,
          "currency": "usd",
          "recurring": {
            "interval": "monthly",
            "interval_count": 1,
            "usage_type": "licensed"
          }
        }
      ]
    }
  ],
  "created": "2026-02-28T12:00:00Z",
  "updated_at": "2026-04-01T00:00:00Z"
}

Schedule released successfully.