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

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

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
Impressions Usage
- Get Impressions Usageget
- Get Impressions Usage Summaryget
Collaborators
ExperimentSummary
- Summaries of Experiments and Campaignsget
Reports
- Get Experiment Result's Reportget
Webhooks
Recommendations

Entity
Team Management

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

/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

MetricSets
Metrics

Update an Extension

patch https://api.optimizely.com/v2/extensions/{extension_id}

Update an extension by ID.

time	status	user agent
Retrieving recent requests…

Loading…

URL Expired

The URL for this request expired after 30 days.

❗️
Warning
The Update an Extension endpoint is not available in Optimizely Feature Experimentation.

Path Params

extension_id

int64

required

The extension ID of the extension you want to change

Body Params

A string in JSON format that includes all the fields you'd like to change for an extension

archived

boolean

Whether the extension is archived

description

string

The description for the extension

edit_url

string

The URL to load when editing the extension

enabled

boolean

Whether the extension is enabled

fields

array of objects

Array of editable fields in the extension

fields

implementation

object

name

string

Name of the extension

Responses

Response body

object

archived

boolean

Whether the extension is archived

created

date-time

The time when the extension was initially created

description

string

The description for the extension

edit_url

string

required

The URL to load when editing the extension

enabled

boolean

Whether the extension is enabled. A disabled extension won't appear in the editor and won't be built into the snippet

fields

array of objects

Defaults to

Array of editable fields in the extension

fields

object

api_name

string

required

The API name of the field

default_value

string

required

A string in JSON format that corresponds to the default_value of the field

field_type

string

required

The type of the field

selector text multi_text rich_text number html css js toggle dropdown multi_select image color slider

label

string

required

The label of the field

options

object

int64

The unique identifier for the extension

implementation

object

required

apply_js

string

The Apply JS code is used to inject the extension onto the page

css

string

Some extensions may not need any CSS because they inherit styles from the page itself. However, you can add additional styling here. This will be injected on the page through a

html

string

The html implementation of the field

reset_js

string

Reset JS is used to "clean up" after a extension. It's used in the editor, when changing field values or removing an existing extension. Reset JS should remove the element and any other side-effects

last_modified

date-time

The last time when the extension was modified

name

string

required

Name of the extension

project_id

int64

required

The project the extension is in

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

Response body

object

code

string

message

string

messages

object

Has additional fields

uuid

Updated almost 2 years ago

Get an Extension

Plan

Did this page help you?

Language

Credentials


xxxxxxxxxx
1
curl --request PATCH \
2
     --url https://api.optimizely.com/v2/extensions/extension_id \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json'

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

application/json

Updated almost 2 years ago

Get an Extension

Plan

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
Fetch holdouts for a specific rule_keyget
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
Holdouts
Update Holdoutspost
Fetch a single Holdoutget
Delete a Holdoutdelete
Create a new Holdoutpost
List Holdouts for a projectget

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
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
List Metric Sets by Metric idsget
Update a Metric Setpatch
Delete Metric Setsdelete
Create a Metric 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?

Update an Extension

❗️
Warning

❗️Warning

200Return the updated extension

400Invalid request body supplied

401Invalid credentials

403You do not have permission to edit the specified extension

404Extension not found

defaultUnexpected error

❗️
Warning