Split Feature Flag Definition Structure
The full definition of a Split feature flag in a specific environment, including treatments, targeting rules, and rollout configuration.
Type:
Properties: 0
ExperimentationFeature FlagsFeature ManagementRolloutsSDK
FeatureFlagDefinition is a JSON Structure definition published by Split.
{
"name": "FeatureFlagDefinition",
"description": "The full definition of a Split feature flag in a specific environment, including treatments, targeting rules, and rollout configuration.",
"fields": [
{
"name": "name",
"type": "string",
"description": "Name of the feature flag.",
"required": true
},
{
"name": "environment",
"type": "object",
"description": "Reference to the environment where this definition applies.",
"required": false,
"fields": [
{
"name": "id",
"type": "string",
"description": "Environment identifier.",
"required": false
},
{
"name": "name",
"type": "string",
"description": "Environment name.",
"required": false
}
]
},
{
"name": "killed",
"type": "boolean",
"description": "When true, all evaluations return the default treatment regardless of targeting rules.",
"required": false
},
{
"name": "treatments",
"type": "array",
"description": "List of possible treatments this flag can return.",
"required": true,
"items": {
"name": "Treatment",
"fields": [
{
"name": "name",
"type": "string",
"description": "Treatment name (e.g., on, off, v1, v2).",
"required": true
},
{
"name": "description",
"type": "string",
"description": "Description of what this treatment does.",
"required": false
},
{
"name": "configurations",
"type": "string",
"description": "JSON string of dynamic configuration for this treatment.",
"required": false
}
]
}
},
{
"name": "defaultTreatment",
"type": "string",
"description": "Treatment returned when no rules match or the flag is killed.",
"required": true
},
{
"name": "rules",
"type": "array",
"description": "Ordered list of targeting rules evaluated top to bottom.",
"required": false,
"items": {
"name": "TargetingRule",
"fields": [
{
"name": "condition",
"type": "object",
"description": "Condition that must be satisfied for this rule to apply.",
"required": false
},
{
"name": "buckets",
"type": "array",
"description": "Percentage distribution of treatments for matching traffic.",
"required": false
}
]
}
},
{
"name": "defaultRule",
"type": "array",
"description": "Percentage-based rollout applied when no targeting rules match.",
"required": true
},
{
"name": "trafficAllocation",
"type": "integer",
"description": "Percentage of traffic included in flag evaluation (0-100).",
"required": false
}
]
}
Every JSON Structure 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 json structure
4 MCP tools reach this
find_json_structuresBrowse and filter every JSON Structure in the catalog.
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 JSON Structure
curl "https://apis.io/api/v1/json-structures/split-feature-flag-definition-structure"
All json structure
curl "https://apis.io/api/v1/json-structures?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no email required.
A second provider on the same verified email joins the account you already have.