Sign in

v1

latestOpenAPI 3.0.02026-07-13103151174.7 KB
Variations

Create a Feature Variation

Create a new variation within a Feature

post/v1/projects/{project}/features/{feature}/variations

Path parameters

projectstring required

A Project key or ID

featurestring required

A Feature key or ID

Request body

keystring required

Unique key by Feature, can be used in the SDK / API to reference by 'key' rather than _id. Must only contain lower-case characters and _, - or ..

namestring required

Variation display name.

variablesobject

A key-value map of variables to their value for this variation

Example request

{
  "key": "variation-1",
  "name": "User's with dashboard access",
  "variables": {
    "show-new-dashboard": true,
    "string-var": "hello world",
    "bool-var": true,
    "num-var": 99,
    "json-var": {
      "foo": "bar"
    }
  }
}

Response

_idstring required

A unique Feature ID

_projectstring required

The Project owning the Feature

source'api' | 'dashboard' | 'importer' | 'github.code_usages' | 'github.pr_insights' | 'gitlab.code_usages' | 'gitlab.pr_insights' | 'bitbucket.code_usages' | 'bitbucket.pr_insights' | 'terraform' | 'cli' | 'slack' | 'mcp' required

Source that created the Feature

status'active' | 'complete' | 'archived' required

Status of the Feature

type'release' | 'experiment' | 'permission' | 'ops'

The Feature type

namestring required

Name of the Feature

keystring required

Unique key by Project, can be used in the SDK / API to reference by 'key' rather than _id. Must only contain lower-case characters and _, - or ..

descriptionstring

Feature description.

_createdBystring

ID of the User who created the Feature

createdAtstring date-time required

The date the Feature was created

updatedAtstring date-time required

The date the Feature was last updated

prodTargetingUpdatedAtstring date-time

The date the Feature had an update that impacted production targeting

controlVariationstring required

The key of the variation that is used as the control variation for Metrics

staticVariationstring

The key of the variation that is set when the Feature's status is set to complete

tagsstring[]

Tags to organize Features on the dashboard

ldLinkstring

A link to the feature on LaunchDarkly if it has importedByLD type

readonlyboolean required

Controls whether the feature is editable for a given user

changeRequestsobject[]

Pending change requests for this Feature

stalenessFeatureStaleness