Optimizely

Optimizely Flags API

Create and manage feature flags with variables and variations for controlled rollouts and experimentation.

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 List feature flags in a project · List flags #
Ask an LLM
“Which feature flags exist in my Optimizely project?”
“Can I see every flag defined for one project?”
Tell an agent
List all feature flags in project {project_id}.
Show me the flags configured for project {project_id}.
POST /projects/{project_id}/flags Create a feature flag · Create a flag #
Ask an LLM
“How do I create a new feature flag in a project?”
“Can I define variables and variations when I first create a flag?”
Tell an agent
Create a flag with key {key} named {name} in project {project_id}.
Add a new feature flag {key} described as {description}.
PATCH /projects/{project_id}/flags Bulk update flags with a JSON patch · Update Flags #
Ask an LLM
“Can I update several feature flags at once with one JSON patch?”
“What happens to read-only properties included in a bulk flag patch?”
Tell an agent
Apply a JSON patch to multiple flags in project {project_id}.
Bulk edit many flags at once in project {project_id} using a patch document.
GET /projects/{project_id}/flags/{flag_key} Get one feature flag · Get a flag #
Ask an LLM
“What variables and variations does a particular flag have?”
“Can I look up a feature flag by its key?”
Tell an agent
Get flag {flag_key} in project {project_id}.
Show the details of feature flag {flag_key}.
PATCH /projects/{project_id}/flags/{flag_key} Update a single feature flag · Update a flag #
Ask an LLM
“How do I rename one feature flag or change its description?”
“Can I change the variations on just one existing flag?”
Tell an agent
Rename flag {flag_key} in project {project_id} to {name}.
Update the description of the single flag {flag_key} to {description}.
DELETE /projects/{project_id}/flags/{flag_key} Delete a feature flag permanently · Delete a flag #
Ask an LLM
“How do I permanently delete a feature flag instead of archiving it?”
“Is deleting a flag reversible?”
Tell an agent destructive · confirm first
Permanently delete flag {flag_key} from project {project_id}.
Remove the feature flag {flag_key} for good.
POST /projects/{project_id}/flags/archived Archive feature flags · Archive Flags #
Ask an LLM
“How do I archive flags I no longer use without deleting them?”
“Can I archive several flags in one request?”
Tell an agent
Archive flags {keys} in project {project_id}.
Move the flags {keys} into the archive.
POST /projects/{project_id}/flags/unarchived Restore archived feature flags · Unarchive Flags #
Ask an LLM
“Can I bring archived flags back into use?”
“What call unarchives a group of flags at once?”
Tell an agent
Unarchive flags {keys} in project {project_id}.
Restore the archived flags {keys}.

Documentation

📖
Documentation
https://docs.developers.optimizely.com/web-experimentation/docs/rest-api-introduction
📖
Documentation
https://docs.developers.optimizely.com/feature-experimentation/reference/feature-experimentation-api-overview
📖
Documentation
https://docs.developers.optimizely.com/optimizely-campaign/docs/rest-api
📖
Documentation
https://docs.developers.optimizely.com/content-management-system/v1.5.0-content-delivery-api/docs/content-delivery-api
📖
Documentation
https://docs.developers.optimizely.com/content-management-system/v1.6.0-content-management-api/docs/getting-started
📖
Documentation
https://docs.developers.optimizely.com/platform-optimizely/docs/getting-started-with-graphql-api
📖
Documentation
https://docs.developers.optimizely.com/optimizely-data-platform/reference/introduction
📖
Documentation
https://docs.developers.optimizely.com/content-marketing-platform/docs/open-api-introduction
📖
Documentation
https://docs.developers.optimizely.com/commerce-connect/v1.3.0-service-api-developer-guide/docs/optimizely-service-api

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/optimizely/refs/heads/main/openapi/optimizely-flags-api-openapi.yml
⚙
AsyncAPI
https://raw.githubusercontent.com/api-evangelist/optimizely/refs/heads/main/asyncapi/optimizely-feature-experimentation-asyncapi.yml
⚙
AsyncAPI
https://raw.githubusercontent.com/api-evangelist/optimizely/refs/heads/main/asyncapi/optimizely-cmp-asyncapi.yml

Other Resources

🔗
GraphQL
https://raw.githubusercontent.com/api-evangelist/optimizely/refs/heads/main/graphql/optimizely-graphql.md

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-flags-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-flags-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Optimizely Flags API
  x-refined-note:
  - x-logo differs across the merged source definitions and was not carried
  version: '1.0'
  description: 'Operations tagged Flags across 2 of this provider''s published API definitions: optimizely-feature-experimentation-openapi.yml, optimizely-feature-experimentation-optimizely-feature-experimentation-api-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.optimizely.com/v2
  description: Optimizely REST API v2 Management Server
- url: https://api.optimizely.com/flags/v1
  description: Optimizely Flags API v1 Server
- url: https://api.optimizely.com/flags/v1/
tags:


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