List feature-flags

GET

/feature-flags

• Current canonical versioned path (F3.API.01)

Gradual rollout feature flags. Controls which organisations see new features via percentage-based bucketing, plan allowlists, and explicit org whitelists (F2.GATEWAY.10).

Authorizations

• bearerAuth
• apiTokenAuth

Parameters

Query Parameters

pagination[page]

integer

pagination[pageSize]

integer

filters

Strapi REST filter syntax

object

sort

string

populate

string

Responses

200

OK

object

data

Array

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

meta

object

pagination

object

page

integer

pageSize

integer

pageCount

integer

total

integer

401

Missing or invalid authentication

403

Not authorized (tenant scope or capability)