---
title: "Remove an entitlement from a subscription"
method: DELETE
path: "/subscriptions/{external_id}/entitlements/{feature_code}"
tags: ["entitlements"]
---

# Remove an entitlement from a subscription

`DELETE /subscriptions/{external_id}/entitlements/{feature_code}`

This endpoint removes a specific feature entitlement from a subscription. The entitlement remains available from the plan.

## Query parameters

- `subscription_status` 'pending' | 'active' | 'terminated' | 'canceled'

## Response `200`

Subscription entitlement removed

- SubscriptionEntitlement
  - `entitlement` SubscriptionEntitlementObject, required
    - `code` string, required — Unique code used to identify the feature. Max 255 characters.
    - `name` string, nullable, required — Name of the feature. Max 255 characters.
    - `description` string, nullable, required — Description of the feature. Max 600 characters.
    - `privileges` SubscriptionEntitlementPrivilegeObject[], required — Privileges associated with this feature. Each privilege shows the plan value and any subscription override.
      - `code` string, required — Unique code for the privilege.
      - `name` string, nullable, required — Display name for the privilege.
      - `value_type` 'integer' | 'boolean' | 'string' | 'select', required — Data type of the privilege value. Default: string
      - `config` object, required
        - `select_options` string[] — Array of string, required only when value_type is `select`.
      - `value` union, required — Applicable value this this subscription (override_value if set, plan_value otherwise). Type depends on the privilege's value_type.
        - integer — Value for integer type privileges
        - boolean — Value for boolean type privileges
        - string — Value for string or select type privileges
      - `plan_value` union, required — Value assigned to this privilege in the plan. Type depends on the privilege's value_type.
        - integer — Value for integer type privileges
        - boolean — Value for boolean type privileges
        - string — Value for string or select type privileges
      - `override_value` union, required — Value assigned to this subscription specifically. Type depends on the privilege's value_type. Null if no override is set.
        - integer — Value for integer type privileges
        - boolean — Value for boolean type privileges
        - string — Value for string or select type privileges
    - `overrides` object, required

## Other responses

- `401` — Unauthorized error
- `404` — Not Found error

---

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