API functions
Push
Get

Get started with Experimentation REST API
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

MetricSets
Metrics

Update an Environment

patch https://api.optimizely.com/v2/environments/{environment_id}

Update an Environment by ID

URL Expired

The URL for this request expired after 30 days.

Path Params

environment_id

int64

required

The unique identifier for the Environment

Body Params

archived

boolean

Boolean representing whether the Environment is archived.

description

string

Text description of the Environment.

has_restricted_permissions

boolean

Defaults to false

Boolean representing whether starting experiments should be restricted to publishers and above in this Environment.

key

string

length ≤ 64

Unique string identifier for this Environment within the Project.

name

string

Name of the Environment.

priority

integer

Integer representing the priority of the Environment. This is used for ordering in the UI.

Responses

Response body

object

archived

boolean

Boolean representing whether the Environment is archived.

created

string

Created time.

datafile

object

integer

ID of Datafile.

latest_file_size

integer

The current size in bytes of the Datafile.

other_urls

array of urls

List of other URLs where this Datafile is also available.

other_urls

revision

integer

Current revision number.

sdk_key

string

Unique key to identify this specific Environment and Datafile programmatically in our SDKs.

url

URL where this Datafile is available.

description

string

A short description of the Environment.

has_restricted_permissions

boolean

Defaults to false

Boolean representing whether starting experiments should be restricted to publishers and above in this Environment.

integer

ID of this Environment.

is_primary

boolean

Boolean representing if this is the primary (default) Environment.

key

string

required

length ≤ 64

Unique string identifier for this Environment within the Project.

last_modified

string

Last modification time.

name

string

required

Name of the Environment.

priority

integer

Integer representing the priority of the Environment. This is used for ordering in the UI.

project_id

integer

required

ID of the project of the Environment.

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 3 months ago

Read an Environment

Read the datafile of an Environment

Language

Credentials


xxxxxxxxxx
1
curl --request PATCH \
2
     --url https://api.optimizely.com/v2/environments/environment_id \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json' \
5
     --data '
6
{
7
  "has_restricted_permissions": false
8
}
9
'

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

application/json

Updated 3 months ago

Read an Environment

Read the datafile of an Environment

Optimizely Web Experimentation
API functions
Push
Tags
User
Wait for origin sync
Send events
Page
Opt out
Log
Extend cookie lifetime
Hold events
Disable
Disable cross origin
Event
Cookie domain
Bucket visitor
Add listener
Cookie expiration
Activate
Get
Visitor ID
Visitor
Utils
State
Session
Data
jQuery
DCP
Behavior

Optimizely API
Get started with Experimentation REST API
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

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 Environment

200Successfully updated the Environment

400Invalid request body content

401Invalid credentials

403You do not have permission to update specified Environment

404Environment not found

defaultUnexpected error