Sign in

v4

latestOpenAPI 3.1.0BSD-3-Clauseraw.githubusercontent.com2026-08-0154110202.6 KB
mcp

Creates a new feature flag in the specified project with default settings.

post/api/v1/projects/{project_pk}/features/

Path parameters

project_pkinteger required

Changing the project selected will remove previous Feature States for the previously associated projects Environments that are related to this Feature. New default Feature States will be created for the new selected projects Environments for this Feature. Also this will remove any Tags associated with a feature as Tags are Project defined

Request body

idinteger
namestring required
default_enabledboolean
initial_valuestring nullable
created_datestring date-time
descriptionstring nullable
tagsinteger[]
is_archivedboolean
ownersinteger[]
group_ownersinteger[]
uuidstring uuid
projectinteger

Changing the project selected will remove previous Feature States for the previously associated projects Environments that are related to this Feature. New default Feature States will be created for the new selected projects Environments for this Feature. Also this will remove any Tags associated with a feature as Tags are Project defined

num_segment_overridesinteger

Number of segment overrides that exist for the given feature in the environment provided by the environment query parameter.

num_identity_overridesinteger nullable

Number of identity overrides that exist for the given feature in the environment provided by the environment query parameter. Note: will return null for Edge enabled projects.

is_num_identity_overrides_completeboolean
is_server_key_onlyboolean
last_modified_in_any_environmentstring date-time nullable

Datetime representing the last time that the feature was modified in any environment in the given project. Note: requires feature versioning v2 enabled on the environment.

last_modified_in_current_environmentstring date-time nullable

Datetime representing the last time that the feature was modified in any environment in the current environment. Note: requires that the environment query parameter is passed and feature versioning v2 enabled on the environment.

lifecycle_stage'new' | 'live' | 'stale' | 'permanent' | 'needs_monitoring' | 'to_remove'
  • new - new
  • live - live
  • stale - stale
  • permanent - permanent
  • needs_monitoring - needs_monitoring
  • to_remove - to_remove

Response

idinteger
namestring required
default_enabledboolean
initial_valuestring nullable
created_datestring date-time
descriptionstring nullable
tagsinteger[]
is_archivedboolean
ownersinteger[]
group_ownersinteger[]
uuidstring uuid
projectinteger

Changing the project selected will remove previous Feature States for the previously associated projects Environments that are related to this Feature. New default Feature States will be created for the new selected projects Environments for this Feature. Also this will remove any Tags associated with a feature as Tags are Project defined

num_segment_overridesinteger

Number of segment overrides that exist for the given feature in the environment provided by the environment query parameter.

num_identity_overridesinteger nullable

Number of identity overrides that exist for the given feature in the environment provided by the environment query parameter. Note: will return null for Edge enabled projects.

is_num_identity_overrides_completeboolean
is_server_key_onlyboolean
last_modified_in_any_environmentstring date-time nullable

Datetime representing the last time that the feature was modified in any environment in the given project. Note: requires feature versioning v2 enabled on the environment.

last_modified_in_current_environmentstring date-time nullable

Datetime representing the last time that the feature was modified in any environment in the current environment. Note: requires that the environment query parameter is passed and feature versioning v2 enabled on the environment.

lifecycle_stage'new' | 'live' | 'stale' | 'permanent' | 'needs_monitoring' | 'to_remove'
  • new - new
  • live - live
  • stale - stale
  • permanent - permanent
  • needs_monitoring - needs_monitoring
  • to_remove - to_remove