Skip to content
Sencai Logo Sencai Logo Sencai Docs

Create a feature-flag

POST
/feature-flags

Authorizations

Section titled “Authorizations ”

Request Body required

Section titled “Request Body required ”
object
data
object
key
required

Unique identifier used in code, e.g. ‘new-billing-ui’ or ‘graphql-enabled’.

string
description
string
rollout_pct

Percentage of organisations that see this flag (0–100). Assigned deterministically via DJB2 hash of org documentId.

integer
enabled_plans

Array of plan names that always see this flag, e.g. [“enterprise”, “pro”].

enabled_orgs

Array of organisation documentIds that are explicitly whitelisted.

is_enabled

Master switch. When false the flag evaluates to false for all orgs regardless of other settings.

boolean
expires_at

Optional expiry. After this timestamp the flag evaluates to false automatically.

string format: date-time

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Created

object
data
object
key
required

Unique identifier used in code, e.g. ‘new-billing-ui’ or ‘graphql-enabled’.

string
description
string
rollout_pct

Percentage of organisations that see this flag (0–100). Assigned deterministically via DJB2 hash of org documentId.

integer
enabled_plans

Array of plan names that always see this flag, e.g. [“enterprise”, “pro”].

enabled_orgs

Array of organisation documentIds that are explicitly whitelisted.

is_enabled

Master switch. When false the flag evaluates to false for all orgs regardless of other settings.

boolean
expires_at

Optional expiry. After this timestamp the flag evaluates to false automatically.

string format: date-time
documentId
string
id
integer
createdAt
string format: date-time
updatedAt
string format: date-time
publishedAt
string format: date-time
nullable

400

Section titled “400 ”

Validation error

401

Section titled “401 ”

Missing or invalid authentication

403

Section titled “403 ”

Not authorized (tenant scope or capability)