Rest APIS

About the Feature Experimentation APIs
Generate tokens and use the REST APIs
REST API cookbook

Optimizely Feature Experimentation API

Environments
- List Environmentsget
Flags
Reports
Rulesets
Rules
Variations
Groups
Variable Definitions
Changes
- Get Change Historyget

Optimizely API

Overview
Projects
Campaigns
Experiments
Audiences
Pages
Events
Attributes
Groups
Extensions
Plan
- Get Plan & Usage information for all productsget
Scheduled Jobs
User
- Get current User informationget
List Attributes
Sections
Features
Subject Access Requests
Environments
Search
- Searchget
Change History
- Retrieve changes for a project.get
Attribution
- Get bucketing information for a visitorget
Export Credentials
- Get aws credentials to access enriched events datasetget
Metrics
Impressions Usage
- Get Impressions Usageget
- Get Impressions Usage Summaryget
Collaborators
ExperimentSummary
- Summaries of Experiments and Campaignsget
Reports
- Get Experiment Result's Reportget
Webhooks
Recommendations

Permission Service

Entity
Team Management

Optimizely Flags Scheduling API

Scheduled Changes
- List Scheduled changes of a flagget
- Create a Schedule Change for a flag in an environmentpost
Scheduled Change
- Delete a Scheduled Change for a flag in an environmentdelete
- Update the Scheduled Change for a flag in an environmentpatch

Optimizely Agent API

/v1/config
- Return the Optimizely config for the given environmentget
/v1/datafile
- Return the datafile for the given environment. If you need strict consistency, you can pass the datafile to other Optimizely instances. so that all initialize from exactly the same datafile version (rather than each fetching the datafile separately from the Optimizely CDN).get
/v1/decide
- Decide makes feature decisions for the selected query parameters.post
/v1/lookup
- Lookup returns saved user profile.post
/v1/save
- Save saves user profile.post
/v1/track
- Track event for the given user.post
/v1/send-odp-event
- Send event to Optimizely Data Platform (ODP).post
/v1/activate
- Activate selected features and experiments for the given user.post
/v1/override
- Override an experiment decision for a userpost
/oauth/token
- Get JWT token to authenticate all requests.post
/v1/batch
- Batch multiple API endpoints into one request.post

Metrics Hub Service API

MetricSets
Metrics

Rest APIS

About the Feature Experimentation APIs
Generate tokens and use the REST APIs
REST API cookbook

Optimizely Feature Experimentation API

Environments
- List Environmentsget
Flags
Reports
Rulesets
Rules
Variations
Groups
Variable Definitions
Changes
- Get Change Historyget

Optimizely API

Overview
Projects
Campaigns
Experiments
Audiences
Pages
Events
Attributes
Groups
Extensions
Plan
- Get Plan & Usage information for all productsget
Scheduled Jobs
User
- Get current User informationget
List Attributes
Sections
Features
Subject Access Requests
Environments
Search
- Searchget
Change History
- Retrieve changes for a project.get
Attribution
- Get bucketing information for a visitorget
Export Credentials
- Get aws credentials to access enriched events datasetget
Metrics
Impressions Usage
- Get Impressions Usageget
- Get Impressions Usage Summaryget
Collaborators
ExperimentSummary
- Summaries of Experiments and Campaignsget
Reports
- Get Experiment Result's Reportget
Webhooks
Recommendations

Permission Service

Entity
Team Management

Optimizely Flags Scheduling API

Scheduled Changes
- List Scheduled changes of a flagget
- Create a Schedule Change for a flag in an environmentpost
Scheduled Change
- Delete a Scheduled Change for a flag in an environmentdelete
- Update the Scheduled Change for a flag in an environmentpatch

Optimizely Agent API

/v1/config
- Return the Optimizely config for the given environmentget
/v1/datafile
- Return the datafile for the given environment. If you need strict consistency, you can pass the datafile to other Optimizely instances. so that all initialize from exactly the same datafile version (rather than each fetching the datafile separately from the Optimizely CDN).get
/v1/decide
- Decide makes feature decisions for the selected query parameters.post
/v1/lookup
- Lookup returns saved user profile.post
/v1/save
- Save saves user profile.post
/v1/track
- Track event for the given user.post
/v1/send-odp-event
- Send event to Optimizely Data Platform (ODP).post
/v1/activate
- Activate selected features and experiments for the given user.post
/v1/override
- Override an experiment decision for a userpost
/oauth/token
- Get JWT token to authenticate all requests.post
/v1/batch
- Batch multiple API endpoints into one request.post

Metrics Hub Service API

MetricSets
Metrics

Read a Feature

get https://api.optimizely.com/v2/features/{feature_id}

Get metadata for a single Feature. Note this endpoint is incompatible with Full Stack Targeted Rollouts projects
(default in accounts created after July 2020) and with non-legacy Full Stack projects (default in projects created after February 2021).
See the compatible API at https://library.optimizely.com/docs/api/flags/v1/index.html#tag/Flags.

URL Expired

The URL for this request expired after 30 days.

❗️
Warning
The Read a Feature endpoint is not available in Optimizely Feature Experimentation.

Path Params

feature_id

int64

required

The unique identifier for the Feature

Responses

Response body

object

archived

boolean

Defaults to false

Whether the Feature has been archived

created

date-time

Time when the Feature was created

description

string

A short description of this Feature

environments

object

The configuration for this Feature's Rollout within each Environment, keyed by Environment key

int64

The ID of this Feature

key

string

required

length ≤ 64

Unique string identifier for this Feature within the Project

last_modified

date-time

Date last modified

name

string

Name of the Feature

project_id

int64

required

The ID of the Project this Feature belongs to

variables

array of objects

Variables define the dynamic configuration of a feature, and each variable can take on a different value on a per-variation basis within a feature test.

variables

object

archived

boolean

Defaults to false

Whether or not this Feature Variable is archived

default_value

string

required

The stringified default value for this Feature Variable. The default value is the value Optimizely SDKs will return when this Feature Variable is accessed by getFeatureVariableValue unless the Feature Variable's value is a part of a feature test variation.

int64

The ID of this Feature Variable

key

string

required

Unique string identifier for this Feature Variable within the Feature

type

string

required

The datatype for this Feature Variable

boolean string double integer json

Response body

object

code

string

message

string

messages

object

Has additional fields

uuid

Response body

object

code

string

message

string

messages

object

Has additional fields

uuid

Response body

object

code

string

message

string

messages

object

Has additional fields

uuid

Response body

object

code

string

message

string

messages

object

Has additional fields

uuid

Updated 10 months ago

Archive a Feature

Update a Feature

Did this page help you?

Language

Credentials


xxxxxxxxxx
1
curl --request GET \
2
     --url https://api.optimizely.com/v2/features/feature_id \
3
     --header 'accept: application/json'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

Updated 10 months ago

Archive a Feature

Update a Feature

Did this page help you?

Rest APIS
About the Feature Experimentation APIs
Generate tokens and use the REST APIs
REST API cookbook

Optimizely Feature Experimentation API
Environments
List Environmentsget
Flags
Fetch a Single Flagget
Delete a Flagdelete
Unarchive Flagspost
Archive Flagspost
Create a New Flagpost
Update Flagspatch
List Flagsget
Reports
Reset the results for a Reportpost
Fetch a Single Reportget
Delete a Reportdelete
Unarchive Reportspost
Archive Reportspost
List Reportsget
Rulesets
Enable the Ruleset for a Flag in an Environmentpost
Disable the Ruleset for a Flag in an Environmentpost
Update the Ruleset for a Flag in an Environmentpatch
Fetch the Ruleset for a Flag in an Environmentget
Rules
Fetch a Rule for a specific experiment_idget
List Rulesget
Fetch the Rule for a Ruleset in an Environmentget
Variations
Fetch a Single Variationget
Delete a Variationdelete
Unarchive Variationspost
Brainstorm variations definitions using AI.post
Archive Variationspost
Create a New Variationpost
Update Variationspatch
List Variationsget
Groups
Fetch a Single Exclusion Groupget
Delete an Exclusion Groupdelete
Unarchive Exclusion Groupspost
Archive Exclusion Groupspost
Create an Exclusion Grouppost
Update Exclusion Groupspatch
List Exclusion Groupsget
Variable Definitions
Fetch a single variable definition by its key.get
Delete a Variable Definitiondelete
Brainstorm variable definitions using AI.post
Create Variable Definitionpost
Update Variable Definitionspatch
Fetch all variable definitions for flag.get
Changes
Get Change Historyget

Optimizely API
Overview
Projects
Update a Projectpatch
Read a Projectget
Create a Projectpost
List Projectsget
Campaigns
Get Campaign results as a CSVget
Get a sharable link for the campaign's results pageget
Get Campaign resultsget
Update a Campaignpatch
Read a Campaignget
Archive a Campaigndelete
Create a Campaignpost
List Campaignsget
Experiments
Get Experiment results as a CSVget
Get Experiment results time seriesget
Get a sharable link for the experiment's results pageget
Get Experiment resultsget
Update an Experimentpatch
Read an Experimentget
Archive an Experimentdelete
Create an Experimentpost
List Experimentsget
Audiences
Update an Audiencepatch
Read an Audienceget
Create an Audiencepost
List Audiencesget
Pages
Update a Pagepatch
Read a pageget
Archived a Pagedelete
Create a Pagepost
List Pagesget
Events
Update a Custom Eventpatch
Archive a Custom Eventdelete
Create a Custom Eventpost
Update an In-Page Eventpatch
Archive an In-Page Eventdelete
Create an In-Page Eventpost
Get Event by IDget
List all Eventsget
Attributes
Update an Attributepatch
Read an Attributeget
Archive an Attributedelete
Create an Attributepost
List Attributesget
Groups
Update an Exclusion Grouppatch
Get an Exclusion Groupget
Archive an Exclusion Groupdelete
Create an Exclusion Grouppost
List Exclusion Groupsget
Extensions
Update an Extensionpatch
Get an Extensionget
Archive an Extensiondelete
Create an Extensionpost
List Extensionsget
Plan
Get Plan & Usage information for all productsget
Scheduled Jobs
Update a Scheduled Jobpatch
Get a Scheduled Jobget
Archive a Scheduled Jobdelete
Create a Scheduled Jobpost
Get a list of Scheduled Jobsget
User
Get current User informationget
List Attributes
Update a List Attributepatch
Read a List Attributeget
Archive a List Attributedelete
Create a List Attributepost
Get list attributes by projectget
Sections
Update a Section by IDpatch
Read a Section of a Multivariate Testget
Archive a Section by IDdelete
Create a new Section in a Multivariate Testpost
Read all the Sections in a Multivariate Testget
Features
Update a Featurepatch
Read a Featureget
Archive a Featuredelete
Create a Featurepost
Get Features by Projectget
Subject Access Requests
Get Subject Access Requestget
Create a Subject Access Requestpost
List Subject Access Requestsget
Update a Subject Access Requestpost
Update a Subject Access Requestpatch
List Subject Access Requests by data source and statusget
Environments
Read the datafile of an Environmentget
Update an Environmentpatch
Read an Environmentget
Archive an Environmentdelete
Create an Environmentpost
Get Environments by Projectget
Search
Searchget
Change History
Retrieve changes for a project.get
Attribution
Get bucketing information for a visitorget
Export Credentials
Get aws credentials to access enriched events datasetget
Metrics
Create a Global Metricpost
Read global metrics by projectsget
Update a Global Metricpatch
Get all of the global metrics of an accountget
Impressions Usage
Get Impressions Usage Summaryget
Get Impressions Usageget
Collaborators
List Collaborators who have not yet accepted the invitationsget
Invite Collaboratorspost
List Collaboratorsget
ExperimentSummary
Summaries of Experiments and Campaignsget
Reports
Get Experiment Result's Reportget
Webhooks
Update a Webhookpatch
Read a Webhookget
Delete a Webhookdelete
Create a Webhookpost
Get Webhooks by Projectget
Recommendations
Download a CSV with summary stats dataget
Download a CSV with all computed recommendations output dataget
Download a CSV with all current catalog dataget

Permission Service
Entity
Change Permissionspatch
Get Entity Permissionsget
Get Team Permissions For Project Entity Typeget
Get User Permissions For Project Entity Typeget
Team Management
Update Teampatch
Get Team Infoget
Delete Teamdelete
Create Teampost
Get Teamsget

Optimizely Flags Scheduling API
Scheduled Changes
Create a Schedule Change for a flag in an environmentpost
List Scheduled changes of a flagget
Scheduled Change
Update the Scheduled Change for a flag in an environmentpatch
Delete a Scheduled Change for a flag in an environmentdelete

Optimizely Agent API
/v1/config
Return the Optimizely config for the given environmentget
/v1/datafile
Return the datafile for the given environment. If you need strict consistency, you can pass the datafile to other Optimizely instances. so that all initialize from exactly the same datafile version (rather than each fetching the datafile separately from the Optimizely CDN).get
/v1/decide
Decide makes feature decisions for the selected query parameters.post
/v1/lookup
Lookup returns saved user profile.post
/v1/save
Save saves user profile.post
/v1/track
Track event for the given user.post
/v1/send-odp-event
Send event to Optimizely Data Platform (ODP).post
/v1/activate
Activate selected features and experiments for the given user.post
/v1/override
Override an experiment decision for a userpost
/oauth/token
Get JWT token to authenticate all requests.post
/v1/batch
Batch multiple API endpoints into one request.post

Metrics Hub Service API
MetricSets
Associate metrics as an ordered, identifiable setpatch
Delete Metric Setsdelete
Associate metrics as an ordered, identifiable setput
List Metric Setsget
Metrics
Delete a Metricdelete
Read a Metricget
Update a Metricpatch
Create a Metricpost
List Metricsget

Rest APIS
About the Feature Experimentation APIs
Generate tokens and use the REST APIs
REST API cookbook

Optimizely Feature Experimentation API
Environments
List Environmentsget
Flags
Fetch a Single Flagget
Delete a Flagdelete
Unarchive Flagspost
Archive Flagspost
Create a New Flagpost
Update Flagspatch
List Flagsget
Reports
Reset the results for a Reportpost
Fetch a Single Reportget
Delete a Reportdelete
Unarchive Reportspost
Archive Reportspost
List Reportsget
Rulesets
Enable the Ruleset for a Flag in an Environmentpost
Disable the Ruleset for a Flag in an Environmentpost
Update the Ruleset for a Flag in an Environmentpatch
Fetch the Ruleset for a Flag in an Environmentget
Rules
Fetch a Rule for a specific experiment_idget
List Rulesget
Fetch the Rule for a Ruleset in an Environmentget
Variations
Fetch a Single Variationget
Delete a Variationdelete
Unarchive Variationspost
Brainstorm variations definitions using AI.post
Archive Variationspost
Create a New Variationpost
Update Variationspatch
List Variationsget
Groups
Fetch a Single Exclusion Groupget
Delete an Exclusion Groupdelete
Unarchive Exclusion Groupspost
Archive Exclusion Groupspost
Create an Exclusion Grouppost
Update Exclusion Groupspatch
List Exclusion Groupsget
Variable Definitions
Fetch a single variable definition by its key.get
Delete a Variable Definitiondelete
Brainstorm variable definitions using AI.post
Create Variable Definitionpost
Update Variable Definitionspatch
Fetch all variable definitions for flag.get
Changes
Get Change Historyget

Optimizely API
Overview
Projects
Update a Projectpatch
Read a Projectget
Create a Projectpost
List Projectsget
Campaigns
Get Campaign results as a CSVget
Get a sharable link for the campaign's results pageget
Get Campaign resultsget
Update a Campaignpatch
Read a Campaignget
Archive a Campaigndelete
Create a Campaignpost
List Campaignsget
Experiments
Get Experiment results as a CSVget
Get Experiment results time seriesget
Get a sharable link for the experiment's results pageget
Get Experiment resultsget
Update an Experimentpatch
Read an Experimentget
Archive an Experimentdelete
Create an Experimentpost
List Experimentsget
Audiences
Update an Audiencepatch
Read an Audienceget
Create an Audiencepost
List Audiencesget
Pages
Update a Pagepatch
Read a pageget
Archived a Pagedelete
Create a Pagepost
List Pagesget
Events
Update a Custom Eventpatch
Archive a Custom Eventdelete
Create a Custom Eventpost
Update an In-Page Eventpatch
Archive an In-Page Eventdelete
Create an In-Page Eventpost
Get Event by IDget
List all Eventsget
Attributes
Update an Attributepatch
Read an Attributeget
Archive an Attributedelete
Create an Attributepost
List Attributesget
Groups
Update an Exclusion Grouppatch
Get an Exclusion Groupget
Archive an Exclusion Groupdelete
Create an Exclusion Grouppost
List Exclusion Groupsget
Extensions
Update an Extensionpatch
Get an Extensionget
Archive an Extensiondelete
Create an Extensionpost
List Extensionsget
Plan
Get Plan & Usage information for all productsget
Scheduled Jobs
Update a Scheduled Jobpatch
Get a Scheduled Jobget
Archive a Scheduled Jobdelete
Create a Scheduled Jobpost
Get a list of Scheduled Jobsget
User
Get current User informationget
List Attributes
Update a List Attributepatch
Read a List Attributeget
Archive a List Attributedelete
Create a List Attributepost
Get list attributes by projectget
Sections
Update a Section by IDpatch
Read a Section of a Multivariate Testget
Archive a Section by IDdelete
Create a new Section in a Multivariate Testpost
Read all the Sections in a Multivariate Testget
Features
Update a Featurepatch
Read a Featureget
Archive a Featuredelete
Create a Featurepost
Get Features by Projectget
Subject Access Requests
Get Subject Access Requestget
Create a Subject Access Requestpost
List Subject Access Requestsget
Update a Subject Access Requestpost
Update a Subject Access Requestpatch
List Subject Access Requests by data source and statusget
Environments
Read the datafile of an Environmentget
Update an Environmentpatch
Read an Environmentget
Archive an Environmentdelete
Create an Environmentpost
Get Environments by Projectget
Search
Searchget
Change History
Retrieve changes for a project.get
Attribution
Get bucketing information for a visitorget
Export Credentials
Get aws credentials to access enriched events datasetget
Metrics
Create a Global Metricpost
Read global metrics by projectsget
Update a Global Metricpatch
Get all of the global metrics of an accountget
Impressions Usage
Get Impressions Usage Summaryget
Get Impressions Usageget
Collaborators
List Collaborators who have not yet accepted the invitationsget
Invite Collaboratorspost
List Collaboratorsget
ExperimentSummary
Summaries of Experiments and Campaignsget
Reports
Get Experiment Result's Reportget
Webhooks
Update a Webhookpatch
Read a Webhookget
Delete a Webhookdelete
Create a Webhookpost
Get Webhooks by Projectget
Recommendations
Download a CSV with summary stats dataget
Download a CSV with all computed recommendations output dataget
Download a CSV with all current catalog dataget

Permission Service
Entity
Change Permissionspatch
Get Entity Permissionsget
Get Team Permissions For Project Entity Typeget
Get User Permissions For Project Entity Typeget
Team Management
Update Teampatch
Get Team Infoget
Delete Teamdelete
Create Teampost
Get Teamsget

Optimizely Flags Scheduling API
Scheduled Changes
Create a Schedule Change for a flag in an environmentpost
List Scheduled changes of a flagget
Scheduled Change
Update the Scheduled Change for a flag in an environmentpatch
Delete a Scheduled Change for a flag in an environmentdelete

Optimizely Agent API
/v1/config
Return the Optimizely config for the given environmentget
/v1/datafile
Return the datafile for the given environment. If you need strict consistency, you can pass the datafile to other Optimizely instances. so that all initialize from exactly the same datafile version (rather than each fetching the datafile separately from the Optimizely CDN).get
/v1/decide
Decide makes feature decisions for the selected query parameters.post
/v1/lookup
Lookup returns saved user profile.post
/v1/save
Save saves user profile.post
/v1/track
Track event for the given user.post
/v1/send-odp-event
Send event to Optimizely Data Platform (ODP).post
/v1/activate
Activate selected features and experiments for the given user.post
/v1/override
Override an experiment decision for a userpost
/oauth/token
Get JWT token to authenticate all requests.post
/v1/batch
Batch multiple API endpoints into one request.post

Metrics Hub Service API
MetricSets
Associate metrics as an ordered, identifiable setpatch
Delete Metric Setsdelete
Associate metrics as an ordered, identifiable setput
List Metric Setsget
Metrics
Delete a Metricdelete
Read a Metricget
Update a Metricpatch
Create a Metricpost
List Metricsget

Optimizely developer documentation

How can we help you?

Optimizely developer documentation

How can we help you?

Read a Feature

❗️
Warning

❗️Warning

200Successfully retrieved the Feature

401Invalid credentials

403You do not have permission to access specified Feature

404Feature not found

defaultUnexpected error

❗️
Warning