Create Override

POST

/v1/billing/flags/overrides

Create a per-tenant feature flag override. Admin only.

Request Body ^required

TenantFeatureOverrideCreate

Fields required to create a per-tenant feature override that layers on top of the plan preset.

Only deviations from the preset should be stored — one row per (tenant_id, flag_key) pair.

object

tenant_id

required

Tenant Id

string format: uuid

plan_preset_id

required

Plan Preset Id

string format: uuid

flag_key

required

Flag Key

string

>= 1 characters <= 255 characters

flag_value

required

Flag Value

Bool, int, or str — stored as JSONB

reason

Any of:

string

string

<= 1000 characters

null

null

expires_at

Any of:

string

string format: date-time

null

null

created_by

Any of:

string

string format: uuid

null

null

Responses

201

Successful Response

Response[TenantFeatureOverrideRead]

object

data

required

TenantFeatureOverrideRead

Full representation of a TenantFeatureOverride record.

object

id

required

Id

string format: uuid

created_at

required

Created At

string format: date-time

updated_at

required

Updated At

string format: date-time

tenant_id

required

Tenant Id

string format: uuid

plan_preset_id

required

Plan Preset Id

string format: uuid

flag_key

required

Flag Key

string

flag_value

required

Flag Value

reason

Any of:

string

string

null

null

expires_at

Any of:

string

string format: date-time

null

null

created_by

Any of:

string

string format: uuid

null

null

meta

ResponseMeta

Metadata included in every response envelope.

object

request_id

Any of:

string

string

null

null

organization_id

Any of:

string

string

null

null

422

Validation Error

HTTPValidationError

object

detail

Detail

Array<object>

ValidationError

object

loc

required

Location

Array

msg

required

Message

string

type

required

Error Type

string

input

Input

ctx

Context

object