> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.qonversion.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Entitlements

> Create entitlement definitions and grant or revoke user access

**Entitlements** model premium access in your app. In v4 there are two layers: **entitlement definitions** (the list of entitlements available in the project, managed under `/v4/entitlements`) and **user entitlements** (grants attached to a specific user, under `/v4/users/{user_id}/entitlements`).

## Key concepts

* **Definition** — Project-level entitlement (e.g., `plus`, `premium`). Defines the ID, an optional description, and the products that grant it.
* **User entitlement** — A grant tied to a specific user, either earned via a purchase or granted manually.
* **Source** — `appstore`, `playstore`, `stripe`, `manual`, or `unknown`.
* **Expiration** — Subscriptions expire; non-recurring entitlements may be permanent.

## Available endpoints

| Method | Endpoint                                         | Description                                | Status                                  |
| ------ | ------------------------------------------------ | ------------------------------------------ | --------------------------------------- |
| GET    | `/entitlements`                                  | List entitlement definitions               | New                                     |
| POST   | `/entitlements`                                  | Create an entitlement definition           | New                                     |
| DELETE | `/entitlements/{entitlement_id}`                 | Delete an entitlement definition           | New                                     |
| GET    | `/entitlements/{entitlement_id}`                 | Get an entitlement definition              | New                                     |
| PATCH  | `/entitlements/{entitlement_id}`                 | Update an entitlement definition (partial) | New                                     |
| GET    | `/users/{user_id}/entitlements`                  | List user entitlements                     | Updated — [v3](/reference/entitlements) |
| POST   | `/users/{user_id}/entitlements`                  | Grant an entitlement to a user             | Updated — [v3](/reference/entitlements) |
| DELETE | `/users/{user_id}/entitlements/{entitlement_id}` | Revoke a user entitlement                  | Updated — [v3](/reference/entitlements) |

## Authentication

All v4 endpoints require a **Secret Key**. Granting or revoking a user entitlement is a privileged operation in the manifest sense, but the token type is the same as for reads. See [Authentication](/reference/v4/authentication).