Sign in
Feature Flags

post/projects/{project_id}/flags

Request

  • Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/projects/{project_id}/flags
  • Auth: HTTP bearer

Path parameters

project_idinteger required

Project ID

Request body

client_visibleboolean

Whether the flag may be exposed on the unauthenticated same-origin evaluation endpoint. Defaults to false: flags are server-only unless explicitly opted in, because targeting rules can encode business logic.

default_valueunknown required
descriptionstring nullable
keystring required

Stable key used in application code. Immutable after create.

value_type'bool' | 'string' | 'number' | 'json' required

The declared type of a flag's value. Fixed at create time.

Example request

{
  "key": "checkout.v2"
}

Response

Flag created

archived_atstring nullable
client_visibleboolean required
created_atstring required
default_valueunknown required
descriptionstring nullable
idinteger required
keystring required
last_evaluated_atstring nullable

When an app last actually evaluated this flag. None means never seen, which is a real answer rather than missing data.

updated_atstring required
value_typestring required

Changes

No recorded changes to this operation across all 50 revisions of this API.