Delete a plan entitlement

Delete an entitlement

curl --request DELETE \
  --url https://api.getlago.com/api/v1/plans/{code}/entitlements/{feature_code} \
  --header 'Authorization: Bearer <token>'

{
  "entitlement": {
    "code": "seats",
    "name": "Number of seats",
    "description": "Number of users of the account",
    "privileges": [
      {
        "code": "max",
        "name": "Maximum",
        "value_type": "integer",
        "config": {},
        "value": 10
      },
      {
        "code": "max_admins",
        "name": "Max Admins",
        "value_type": "integer",
        "config": {},
        "value": 5
      },
      {
        "code": "root",
        "name": "Allow root user",
        "value_type": "boolean",
        "config": {},
        "value": true
      },
      {
        "code": "provider",
        "name": "SSO Provider",
        "value_type": "select",
        "value": "google",
        "config": {
          "select_options": [
            "google",
            "okta"
          ]
        }
      }
    ]
  }
}

DELETE

plans

{code}

entitlements

{feature_code}

Delete an entitlement

curl --request DELETE \
  --url https://api.getlago.com/api/v1/plans/{code}/entitlements/{feature_code} \
  --header 'Authorization: Bearer <token>'

{
  "entitlement": {
    "code": "seats",
    "name": "Number of seats",
    "description": "Number of users of the account",
    "privileges": [
      {
        "code": "max",
        "name": "Maximum",
        "value_type": "integer",
        "config": {},
        "value": 10
      },
      {
        "code": "max_admins",
        "name": "Max Admins",
        "value_type": "integer",
        "config": {},
        "value": 5
      },
      {
        "code": "root",
        "name": "Allow root user",
        "value_type": "boolean",
        "config": {},
        "value": true
      },
      {
        "code": "provider",
        "name": "SSO Provider",
        "value_type": "select",
        "value": "google",
        "config": {
          "select_options": [
            "google",
            "okta"
          ]
        }
      }
    ]
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

code

string

required

Code of the existing plan.

Example:

"startup"

feature_code

string

required

Code of the existing feature.

Example:

"seats"

Response

Entitlement deleted

entitlement

object

required

Show child attributes

entitlement.code

string

required

Unique code used to identify the feature. Max 255 characters.

Example:

"seats"

entitlement.name

string | null

required

Name of the feature. Max 255 characters.

Example:

"Number of seats"

entitlement.description

string | null

required

Description of the feature. Max 600 characters.

Example:

"Number of users of the account"

entitlement.privileges

object[]

required

Privileges associated with this feature. Each privilege must have a value assigned.

Show child attributes

entitlement.privileges.code

string

required

Unique code for the privilege.

Example:

"max"

entitlement.privileges.name

string | null

required

Display name for the privilege.

Example:

"Maximum"

entitlement.privileges.value_type

enum<string>

required

Data type of the privilege value. Default: string

Available options:

integer,

boolean,

string,

select

Example:

"integer"

entitlement.privileges.config

object

required

Show child attributes

entitlement.privileges.config.select_options

string[]

Array of string, required only when value_type is select.

Example:

["google", "okta"]

entitlement.privileges.value

required

Value assigned to this privilege in the entitlement. Type depends on the privilege's value_type.

Example:

10

Example:

[
  {
    "code": "max",
    "name": "Maximum",
    "value_type": "integer",
    "config": {},
    "value": 10
  },
  {
    "code": "max_admins",
    "name": "Max Admins",
    "value_type": "integer",
    "config": {},
    "value": 5
  },
  {
    "code": "root",
    "name": "Allow root user",
    "value_type": "boolean",
    "config": {},
    "value": true
  },
  {
    "code": "provider",
    "name": "SSO Provider",
    "value_type": "select",
    "value": "google",
    "config": { "select_options": ["google", "okta"] }
  }
]

Update plan entitlements Delete a plan entitlement privilege

⌘I

API Reference

Authorizations

Path Parameters

Response