Optimizely

Optimizely Variations API

APIs to interact with Variations

GitHub OpenAPI
Business capability
Feature Flag Management BC-4210.50

Operations 8

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /projects/{project_id}/flags/{flag_key}/variations List a flag's variations · List Variations #
Ask an LLM
“What variations does a feature flag have in my Optimizely Feature Experimentation project?”
“Can I list only the archived variations of a flag?”
Tell an agent
List variations of flag {flag_key} in project {project_id}.
List archived variations of flag {flag_key} in project {project_id} with archived {archived}.
PATCH /projects/{project_id}/flags/{flag_key}/variations Update a flag's variations with a JSON patch · Update Variations #
Ask an LLM
“How do I edit several variations of a flag in one JSON patch request?”
“Can I change variation names or variables using JSON patch?”
Tell an agent
Apply a JSON patch to the variations of flag {flag_key} in project {project_id}.
Bulk-edit variations on flag {flag_key} (project {project_id}).
POST /projects/{project_id}/flags/{flag_key}/variations Create a flag variation · Create a New Variation #
Ask an LLM
“How do I add a new variation to a feature flag?”
“Can I set variable values when creating a variation?”
Tell an agent
Create variation {key} named {name} on flag {flag_key} in project {project_id}.
Add variation {key} ({name}) to flag {flag_key} in project {project_id} with variables {variables}.
POST /projects/{project_id}/flags/{flag_key}/variations/archived Archive flag variations · Archive Variations #
Ask an LLM
“How do I hide variations I no longer use without permanently deleting them?”
“Can I archive several variations of a flag at once?”
Tell an agent
Archive variations {keys} on flag {flag_key} in project {project_id}.
Archive the unused variations {keys} of flag {flag_key} (project {project_id}).
POST /projects/{project_id}/flags/{flag_key}/variations/brainstorm Brainstorm variation ideas with AI · Brainstorm variations definitions using AI #
Ask an LLM
“Can Optimizely's AI suggest new variation definitions for a flag?”
“How do I get AI-generated variation ideas based on a conversation?”
Tell an agent
Brainstorm variations for flag {flag_key} in project {project_id} from interactions {interactions}.
Use AI to suggest variation definitions for flag {flag_key} (project {project_id}) given {interactions}.
POST /projects/{project_id}/flags/{flag_key}/variations/unarchived Restore archived flag variations · Unarchive Variations #
Ask an LLM
“How do I bring back variations I archived earlier?”
“Can I unarchive multiple variations of a flag in one call?”
Tell an agent
Unarchive variations {keys} on flag {flag_key} in project {project_id}.
Restore archived variations {keys} of flag {flag_key} (project {project_id}).
DELETE /projects/{project_id}/flags/{flag_key}/variations/{variation_key} Permanently delete a flag variation · Delete a Variation #
Ask an LLM
“How do I permanently delete a variation so its data is gone for good?”
“Once I delete a variation, is there any way to get its data back?”
Tell an agent destructive · confirm first
Permanently delete variation {variation_key} from flag {flag_key} in project {project_id}.
Remove variation {variation_key} of flag {flag_key} (project {project_id}) forever.
GET /projects/{project_id}/flags/{flag_key}/variations/{variation_key} Get a single flag variation · Fetch a Single Variation #
Ask an LLM
“What variables and settings does a specific variation of a flag have?”
“How do I fetch one variation by its key?”
Tell an agent
Get variation {variation_key} of flag {flag_key} in project {project_id}.
Show the variables of variation {variation_key} on flag {flag_key} (project {project_id}).

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/optimizely/refs/heads/main/openapi/optimizely-variations-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/optimizely:optimizely-variations-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

optimizely-variations-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  description: 'This page documents how to use the Optimizely FX API.

    With this API you can view and manage Feature Flags and all of their

    related entities including Variables, Variations, Rules, and Reports.


    The base URL is https://api.optimizely.com/flags/v1. Append any paths

    listed in these docs onto that url in order to make requests to the API.'
  title: Optimizely Feature Experimentation Variations API
  version: 0.3.7
  x-logo:
    url: https://app.optimizely.com/static/img/rebrand/logo.svg
servers:
- url: https://api.optimizely.com/flags/v1/
security:
- apiKey: []
- OAuth2:
  - read
  - write
tags:


# --- truncated at 32 KB (39 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/optimizely/refs/heads/main/openapi/optimizely-variations-api-openapi.yml