---
title: "Expire Subscription Item Feature"
method: POST
path: "/api/v1/subscription-item-features/{id}/expire"
tags: ["Subscription Item Features"]
---

# Expire Subscription Item Feature

`POST /api/v1/subscription-item-features/{id}/expire`

Expire a feature attached to a subscription item, no longer granting the customer access to it

## Path parameters

- `id` string, required

## Request body

- object
  - `expiredAt` integer — Epoch milliseconds.

## Response `200`

Successful response

- object
  - `subscriptionItemFeature` union, required
    - object
      - `id` string, required
      - `createdAt` integer, required — Epoch milliseconds.
      - `updatedAt` integer, required — Epoch milliseconds.
      - `livemode` boolean, required
      - `subscriptionItemId` string, required
      - `featureId` string, required
      - `productFeatureId` string, nullable
      - `type` 'toggle', required
      - `amount` unknown
      - `usageMeterId` unknown
      - `renewalFrequency` unknown
      - `expiredAt` integer, nullable — Epoch milliseconds.
      - `detachedAt` integer, nullable — Epoch milliseconds.
      - `detachedReason` string, nullable
      - `manuallyCreated` boolean, required
      - `name` string, required
      - `slug` string, required
    - object
      - `id` string, required
      - `createdAt` integer, required — Epoch milliseconds.
      - `updatedAt` integer, required — Epoch milliseconds.
      - `livemode` boolean, required
      - `subscriptionItemId` string, required
      - `featureId` string, required
      - `productFeatureId` string, nullable
      - `type` 'usage_credit_grant', required
      - `amount` integer, required
      - `usageMeterId` string, required
      - `renewalFrequency` 'once' | 'every_billing_period', required
      - `expiredAt` integer, nullable — Epoch milliseconds.
      - `detachedAt` integer, nullable — Epoch milliseconds.
      - `detachedReason` string, nullable
      - `manuallyCreated` boolean, required
      - `name` string, required
      - `slug` string, required

## Other responses

- `400` — Invalid input data
- `401` — Authorization not provided
- `403` — Insufficient access
- `500` — Internal server error

## Changes

- **2025-12-08** `d53efdb1a902` — 2 info
  - added the required property `subscriptionItemFeature/oneOf[#/components/schemas/ToggleSubscriptionItemFeatureRecord]/manuallyCreated` to the response with the `200` status
  - added the required property `subscriptionItemFeature/oneOf[#/components/schemas/UsageCreditGrantSubscriptionItemFeatureRecord]/manuallyCreated` to the response with the `200` status
- **2025-11-25** `71d495f9b7d8` — 1 breaking, 2 info
  - added `#/components/schemas/UsageCreditGrantSubscriptionItemFeatureRecord` to the `subscriptionItemFeature` response property `oneOf` list for the response status `200`
  - mapped value for discriminator key `usage_credit_grant` changed from `#/components/schemas/UsageCreditGrantSubscriptionItemFeatureClientSelectSchema` to `#/components/schemas/UsageCreditGrantSubscriptionItemFeatureRecord` for `subscriptionItemFeature` response property for the response status `200`
  - removed `#/components/schemas/UsageCreditGrantSubscriptionItemFeatureClientSelectSchema` from the `subscriptionItemFeature` response property `oneOf` list for the response status `200`
- …earlier changes not shown

[Full history](https://skmtc.dev/flowglad/apis/flowglad-api/changes/api/v1/subscription-item-features/:id/expire/post.md)

---

[API](https://skmtc.dev/flowglad/apis/flowglad-api.md) · [All operations](https://skmtc.dev/flowglad/apis/flowglad-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/flowglad/flowglad-api/revisions/d53efdb1a902/schema)