The core Optimizely REST API v2 shared by Web Experimentation and Feature Experimentation — projects, experiments, campaigns, audiences, pages, events, attributes, environments, features, groups, extensions, holdout exports, webhooks, subject access requests and results/reporting. 108 operations. Published by Optimizely in its own RFC 9727 API catalog and harvested verbatim 2026-08-13.
Optimizely Experimentation REST API v2 is one of 50 APIs that Optimizely publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include Experimentation, A/B Testing, and Feature Flags. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.
This API exposes
108 operations
across 63 paths,
organized into 28 resource areas,
and defines 113 schemas.
It is described by OpenAPI 3.0.0, at version 2.0.
Requests are made against a single base URL, https://api.optimizely.com/v2.
108 operations63 paths113 schemas14 DELETE58 GET17 PATCH19 POST
Metadata
The identity and technical contract details declared by the specification.
Specification
OpenAPI 3.0.0
API Version
2.0
Base URL
https://api.optimizely.com/v2
Authentication
OAuth 2.0, HTTP Bearer
Resource Areas
28
Authentication & Security 2
Optimizely Experimentation REST API v2 declares
2 security schemes
for authenticating requests.
It supports OAuth 2.0 (OAuth2) using the authorizationCode flow, exposing 1 scope.
It accepts HTTP bearer tokens (apiKey).
By default, every request must be authenticated.
OAuth2 — Write applications that authenticate with the REST API via OAuth 2.0. Or, to authenticate using a personal token, see https://docs.developers.optimizely.com/we…
Paths & Operations 108
Across 63 paths, the API surfaces 108 operations — 14 DELETE, 58 GET, 17 PATCH, 19 POST. They span 28 resource areas, including Attributes, Attribution, Audiences, Impressions Usage, Campaigns, Change History, Collaborators, Environments, and 20 more. Each is listed below with its method, path, parameters, and response codes.
Attributes 5
Define characteristics of audiences that decide the experiences they will be included in
Create Features and parameterize them using Variables for parts of your application you'd like to toggle, roll out, or experiment on. Note - If you are using a Targeted Rollouts L…
GET
/features
Get Features by Project
list_features3 params→ 200401403default
POST
/features
Create a Feature
create_featurebody→ 201400401default
DELETE
/features/{feature_id}
Archive a Feature
delete_feature1 param→ 204401403404default
GET
/features/{feature_id}
Read a Feature
get_feature1 param→ 200401403404default
PATCH
/features/{feature_id}
Update a Feature
update_feature1 parambody→ 200400401403404default
Groups 5
Make experiments and campaigns mutually exclusive from each other using Exclusion Groups
GET
/groups
List Exclusion Groups
list_groups3 params→ 200401403404default
POST
/groups
Create an Exclusion Group
create_groupbody→ 201400401403default
DELETE
/groups/{group_id}
Archive an Exclusion Group
delete_group1 param→ 204401403404default
GET
/groups/{group_id}
Get an Exclusion Group
get_group1 param→ 200400401403404default
PATCH
/groups/{group_id}
Update an Exclusion Group
update_group1 parambody→ 200400401403404default
Subject Access Requests 6
Manage information about Subject Access Requests (includes GDPR)
GET
/internal-subject-access-requests
List Subject Access Requests by data source and status
A List Attribute is a set of user identifiers that you have uploaded to Optimizely. Membership in a list can be used to define an Optimizely audience, so you can target experiment…
The contract defines 113 schemas that model the data the API accepts and returns. The most detailed are Experiment (31 properties), SearchResult (26 properties), Campaign (20 properties), Change (18 properties). Each schema is shown below with its type and property counts.
Account
object
2 properties
AccountFeature
object
2 properties
AccountFeatureSource
object
2 properties
Action
object
3 properties1 required
Attribute
object
8 properties2 required
AttributeUpdate
object
4 properties
Audience
object
12 properties1 required
AudienceUpdate
object
6 properties
BucketingInformation
object
3 properties
BucketingInformationItem
object
5 properties
CSSAttribute
object
12 properties
Campaign
object
20 properties1 required
CampaignMetricResults
object
Results specific to an Event
10 properties
CampaignResults
object
6 properties
CampaignUpdate
object
10 properties
Change
object
18 properties1 required
ChangeAttribute
object
8 properties
ChangeDetail
object
4 properties
ChangeHistoryChange
object
10 properties1 required
ChangeRevision
object
2 properties
Choices
object
2 properties
CollaboratorEntry
object
3 properties
CompoundSubMetric
object
A metric that is used only as part of the calculation for a ratio metric.
5 properties
CredentialsItem
object
Credentials item containing information on access key and secrets
4 properties
CurrentAccount
object
2 properties
CustomEvent
object
12 properties1 required
CustomEventUpdate
object
5 properties
Datafile
object
6 properties
Datapoint
object
A value with statistical context
10 properties
E3Credentials
object
2 properties
E3CredentialsGCP
object
2 properties
Entity
object
6 properties
Environment
object
12 properties3 required
EnvironmentUpdate
object
6 properties
Error
object
4 properties
Event
object
15 properties
EventCategories
string
1 property
EventProperty
object
A user-defined data element giving additional detail about the event.
2 properties
Experiment
object
31 properties1 required
ExperimentEnvironment
object
1 property1 required
ExperimentEnvironmentUpdate
object
1 property1 required
ExperimentMetricConclusion
object
2 properties
ExperimentMetricResults
object
Results specific to an Event
11 properties
ExperimentMetricTimeseries
object
Results time series specific to an Event
10 properties
ExperimentResults
object
8 properties
ExperimentResultsReport
object
4 properties
ExperimentSummary
object
11 properties
ExperimentTimeseries
object
7 properties
ExperimentUpdate
object
15 properties
ExperimentVariationReach
object
6 properties
Extension
object
12 properties4 required
ExtensionUpdate
object
7 properties
Feature
object
10 properties2 required
FeatureEnvironment
object
3 properties1 required
FeatureUpdate
object
6 properties
FeatureVariable
object
5 properties3 required
FeatureVariableUpdate
object
6 properties
Field
object
5 properties4 required
Group
object
8 properties2 required
GroupEntity
object
3 properties3 required
GroupUpdate
object
4 properties
Implementation
object
4 properties
ImpressionsUsage
object
7 properties7 required
ImpressionsUsageSummary
object
6 properties6 required
InPageEvent
object
An Event that can occur only within the context of a specific Page (allowed in Web Projects only)
13 properties2 required
InPageEventConfig
object
1 property1 required
InPageEventUpdate
object
8 properties
ListAttribute
object
14 properties3 required
ListAttributeUpdate
object
6 properties
Me
object
5 properties
Metric
object
9 properties
MetricEventProperties
object
The conditions used to filter the metric on specific event property values.
1 property
MetricFilter
object
The set of event property conditions a conversion must match to be counted toward the metric.
2 properties
MetricFilterCondition
object
defines the event property values and operator used to check whether the conversion meets the condition.
4 properties
Metrics
object
16 properties5 required
Options
object
1 property
Page
object
14 properties3 required
PageUpdate
object
9 properties
Plan
object
5 properties
ProductUsage
object
9 properties
Project
object
16 properties1 required
ProjectRole
object
3 properties
ProjectUpdate
object
7 properties
ResultsShareLink
object
1 property
Revision
object
1 property
RolloutRule
object
4 properties
Schedule
object
3 properties
ScheduleUpdate
object
3 properties
ScheduledJob
object
9 properties3 required
ScheduledJobUpdate
object
7 properties
SearchResult
object
26 properties
Section
object
7 properties1 required
SectionUpdate
object
4 properties
SharedCodeChange
object
8 properties2 required
StatsConfig
object
Stats Engine configuration settings
3 properties
SubjectAccessRequest
object
13 properties4 required
SubjectAccessRequestInternal
object
15 properties5 required
SubjectAccessRequestUpdate
object
4 properties1 required
TimeseriesDatapoint
object
6 properties
URLTargeting
object
6 properties1 required
User
object
6 properties2 required
UserProfile
object
4 properties
UserProxy
object
3 properties2 required
VariantResults
object
11 properties
VariantTimeseries
object
6 properties
Variation
object
10 properties1 required
VariationReach
object
4 properties
VariationUpdate
object
10 properties1 required
WebSnippet
object
12 properties
WebSnippetUpdate
object
10 properties
Webhook
object
9 properties3 required
WebhookRequestBody
object
Webhook request body
4 properties4 required
Webhooks
array
List of webhooks.
Specification
The full machine-readable OpenAPI contract behind this narrative.
Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.
Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.
MCP tools for apis
4 tools reach this content
search_api_evangelistSearch every content type across the network at once.
find_relatedThe shared-tag relevance graph — what else covers this.
get_tagEverything one tag labels, across all content types.
guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
A second provider on the same verified email joins the account you already have.
Your account
ⓘWhere this information came from
This is an independent, third-party profile of Optimizely Experimentation REST API v2, published by
API Evangelist. We do not operate, host, resell, or
support these APIs, and we are not affiliated with or endorsed by the company unless stated above.
Everything here is built from publicly available information — the company's own site,
developer portal, documentation, public repositories, and the specifications it publishes for public use.
Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's
public API artifacts, scored against a published rubric. They are not certifications,
endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and
you do not need to justify the request. A removed company is recorded as unrated, never scored
zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy → On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.
