Update a feature

curl --request PUT \
  --url https://api.getlago.com/api/v1/features/{code} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "feature": {
    "name": "Number of seats",
    "description": "Number of users of the account",
    "privileges": [
      {
        "code": "max",
        "name": "Maximum",
        "value_type": "integer"
      },
      {
        "code": "max_admins",
        "name": "Max Admins",
        "value_type": "integer"
      },
      {
        "code": "root",
        "name": "Allow root user",
        "value_type": "boolean"
      },
      {
        "code": "provider",
        "name": "SSO Provider",
        "value_type": "select",
        "config": {
          "select_options": [
            "google",
            "okta"
          ]
        }
      }
    ]
  }
}
'

{
  "feature": {
    "code": "seats",
    "name": "Number of seats",
    "description": "Number of users of the account",
    "privileges": [
      {
        "code": "max",
        "name": "Maximum",
        "value_type": "integer",
        "config": {}
      },
      {
        "code": "max_admins",
        "name": "Max Admins",
        "value_type": "integer",
        "config": {}
      },
      {
        "code": "root",
        "name": "Allow root user",
        "value_type": "boolean",
        "config": {}
      },
      {
        "code": "provider",
        "name": "SSO Provider",
        "value_type": "select",
        "config": {
          "select_options": [
            "google",
            "okta"
          ]
        }
      }
    ],
    "created_at": "2025-07-17T12:34:35Z"
  }
}

PUT

features

{code}

Update a feature

curl --request PUT \
  --url https://api.getlago.com/api/v1/features/{code} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "feature": {
    "name": "Number of seats",
    "description": "Number of users of the account",
    "privileges": [
      {
        "code": "max",
        "name": "Maximum",
        "value_type": "integer"
      },
      {
        "code": "max_admins",
        "name": "Max Admins",
        "value_type": "integer"
      },
      {
        "code": "root",
        "name": "Allow root user",
        "value_type": "boolean"
      },
      {
        "code": "provider",
        "name": "SSO Provider",
        "value_type": "select",
        "config": {
          "select_options": [
            "google",
            "okta"
          ]
        }
      }
    ]
  }
}
'

{
  "feature": {
    "code": "seats",
    "name": "Number of seats",
    "description": "Number of users of the account",
    "privileges": [
      {
        "code": "max",
        "name": "Maximum",
        "value_type": "integer",
        "config": {}
      },
      {
        "code": "max_admins",
        "name": "Max Admins",
        "value_type": "integer",
        "config": {}
      },
      {
        "code": "root",
        "name": "Allow root user",
        "value_type": "boolean",
        "config": {}
      },
      {
        "code": "provider",
        "name": "SSO Provider",
        "value_type": "select",
        "config": {
          "select_options": [
            "google",
            "okta"
          ]
        }
      }
    ],
    "created_at": "2025-07-17T12:34:35Z"
  }
}

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 feature.

Example:

"seats"

Body

application/json

Feature payload

feature

object

required

Show child attributes

feature.name

string | null

Name of the feature.

Example:

"Number of seats"

feature.description

string | null

Internal description of the feature.

Example:

"Number of users of the account"

feature.privileges

object[]

Privileges associated with this feature. Can be empty.

Show child attributes

feature.privileges.code

string

required

Unique code for the privilege.

Example:

"max"

feature.privileges.name

string | null

Display name for the privilege.

Example:

"Maximum"

feature.privileges.value_type

enum<string>

Data type of the privilege value. Default: string

Available options:

integer,

boolean,

string,

select

Example:

"integer"

feature.privileges.config

object

Show child attributes

feature.privileges.config.select_options

string[]

Array of string, required only when value_type is select.

Example:

["google", "okta"]

Example:

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

Response

Feature updated

feature

object

required

Show child attributes

feature.code

string

required

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

Example:

"seats"

feature.name

string | null

required

Name of the feature. Max 255 characters.

Example:

"Number of seats"

feature.description

string | null

required

Description of the feature. Max 600 characters.

Example:

"Number of users of the account"

feature.privileges

object[]

required

Privileges associated with this feature. Can be empty.

Show child attributes

feature.privileges.code

string

required

Unique code for the privilege.

Example:

"max"

feature.privileges.name

string | null

required

Display name for the privilege.

Example:

"Maximum"

feature.privileges.value_type

enum<string>

required

Data type of the privilege value. Default: string

Available options:

integer,

boolean,

string,

select

Example:

"integer"

feature.privileges.config

object

required

Show child attributes

feature.privileges.config.select_options

string[]

Array of string, required only when value_type is select.

Example:

["google", "okta"]

Example:

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

feature.created_at

string<date-time>

required

Creation date of the feature.

Example:

"2025-07-17T12:34:35Z"

Create a feature Delete a feature

⌘I

API Reference

Authorizations

Path Parameters

Body

Response