v52

latestOpenAPI 3.0.1AGPL-3.0raw.githubusercontent.com2026-08-01255473862.7 KB
Entitlements

Update entitlement

Use when changing an entitlement (e.g. increasing or decreasing a limit). Request body contains the fields to update.

put/entitlements/{id}

Path parameters

idstring required

Entitlement ID

Request body

aggregation_mode'additive' | 'parallel'
clear_grant_configboolean

Grant config — nil fields leave the current value alone. ClearGrantConfig=true wipes the whole grant config (back to a legacy entitlement).

config_valueobject
grant_duration_unit'hour' | 'day' | 'week'
grant_duration_valueinteger
grant_measure'quantity' | 'amount'
grant_quotastring
is_enabledboolean
is_soft_limitboolean
static_valuestring
usage_limitinteger
usage_reset_period'MONTHLY' | 'ANNUAL' | 'WEEKLY' | 'DAILY' | 'QUARTERLY' | 'HALF_YEARLY' | 'NEVER'

Response

OK

aggregation_mode'additive' | 'parallel'
config_valueobject
created_atstring date-time
created_bystring
display_orderinteger
end_datestring date-time
entity_idstring
entity_type'PLAN' | 'SUBSCRIPTION' | 'ADDON'
environment_idstring
feature_idstring
feature_type'metered' | 'boolean' | 'static' | 'config'
grant_duration_unit'hour' | 'day' | 'week'
grant_duration_valueinteger
grant_measure'quantity' | 'amount'
grant_quotanumber
idstring
is_enabledboolean
is_soft_limitboolean
parent_entitlement_idstring
plan_idstring

TODO: Remove this once we have a proper entitlement entity type

start_datestring date-time
static_valuestring
status'published' | 'deleted' | 'archived'
tenant_idstring
updated_atstring date-time
updated_bystring
usage_limitinteger
usage_reset_period'MONTHLY' | 'ANNUAL' | 'WEEKLY' | 'DAILY' | 'QUARTERLY' | 'HALF_YEARLY' | 'NEVER'