How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

GrowthBook feature-revisions API

Draft revisions for feature flags, including rules, scheduling, and approval workflows.**These are v1 endpoints.** New integrations should use the v2 Feature Revisions endpoints.

GrowthBook feature-revisions API is one of 36 APIs that GrowthBook publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include feature-revisions. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 24 operations across 21 paths, and defines 10 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against 2 base URLs: https://api.growthbook.io/api, https://{domain}/api.

24 operations 21 paths 10 schemas 2 DELETE5 GET10 POST7 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://api.growthbook.io/api
Authentication
HTTP Bearer, HTTP Basic
Resource Areas
1

Authentication & Security 2

GrowthBook feature-revisions API declares 2 security schemes for authenticating requests. It accepts HTTP bearer tokens (bearerAuth). It accepts HTTP basic authentication (basicAuth). By default, every request must be authenticated.

  • bearerAuth — If using Bearer auth, pass the Secret Key as the token: bash curl https://api.growthbook.io/api/v1/features -H "Authorization: Bearer secretabc123DEF456"
  • basicAuth — If using HTTP Basic auth, pass the Secret Key as the username and leave the password blank: bash curl https://api.growthbook.io/api/v1/features -u secretabc123…

Paths & Operations 24

Across 21 paths, the API surfaces 24 operations — 2 DELETE, 5 GET, 10 POST, 7 PUT. Each is listed below with its method, path, parameters, and response codes.

feature-revisions 24

Draft revisions for feature flags, including rules, scheduling, and approval workflows. These are v1 endpoints. New integrations should use the v2 Feature Revisions endpoints.

GET
/v1/revisionsdeprecated
List feature revisions
listRevisions 7 params → 200
GET
/v1/features/{id}/revisionsdeprecated
List revisions for a feature
getFeatureRevisions 6 params → 200
POST
/v1/features/{id}/revisionsdeprecated
Create a draft revision
postFeatureRevision 1 param body → 200
GET
/v1/features/{id}/revisions/latestdeprecated
Get the most recent active draft revision
getFeatureRevisionLatest 2 params → 200
GET
/v1/features/{id}/revisions/{version}deprecated
Get a single feature revision
getFeatureRevision 2 params → 200
PUT
/v1/features/{id}/revisions/{version}/metadatadeprecated
Update revision metadata (comment, title, feature metadata)
putFeatureRevisionMetadata 2 params body → 200
PUT
/v1/features/{id}/revisions/{version}/default-valuedeprecated
Set the default value in a draft revision
putFeatureRevisionDefaultValue 2 params body → 200
PUT
/v1/features/{id}/revisions/{version}/prerequisitesdeprecated
Set feature-level prerequisites in a draft revision
putFeatureRevisionPrerequisites 2 params body → 200
PUT
/v1/features/{id}/revisions/{version}/holdoutdeprecated
Set holdout in a draft revision
putFeatureRevisionHoldout 2 params body → 200
PUT
/v1/features/{id}/revisions/{version}/archivedeprecated
Set archived state in a draft revision
putFeatureRevisionArchive 2 params body → 200
POST
/v1/features/{id}/revisions/{version}/toggledeprecated
Toggle an environment on/off in a draft revision
postFeatureRevisionToggle 2 params body → 200
POST
/v1/features/{id}/revisions/{version}/rulesdeprecated
Add a rule to a draft revision
postFeatureRevisionRuleAdd 2 params body → 200
PUT
/v1/features/{id}/revisions/{version}/rules/{ruleId}deprecated
Update a rule in a draft revision
putFeatureRevisionRule 3 params body → 200
DELETE
/v1/features/{id}/revisions/{version}/rules/{ruleId}deprecated
Delete a rule from a draft revision
deleteFeatureRevisionRule 3 params body → 200
POST
/v1/features/{id}/revisions/{version}/rules/reorderdeprecated
Reorder rules in an environment
postFeatureRevisionRulesReorder 2 params body → 200
PUT
/v1/features/{id}/revisions/{version}/rules/{ruleId}/ramp-scheduledeprecated
Set ramp schedule for a rule
putFeatureRevisionRuleRampSchedule 3 params body → 200
DELETE
/v1/features/{id}/revisions/{version}/rules/{ruleId}/ramp-scheduledeprecated
Remove ramp schedule from a rule
deleteFeatureRevisionRuleRampSchedule 3 params body → 200
POST
/v1/features/{id}/revisions/{version}/request-reviewdeprecated
Request review for a draft revision
postFeatureRevisionRequestReview 2 params body → 200
POST
/v1/features/{id}/revisions/{version}/submit-reviewdeprecated
Submit a review on a draft revision
postFeatureRevisionSubmitReview 2 params body → 200
GET
/v1/features/{id}/revisions/{version}/merge-statusdeprecated
Get merge status for a draft revision
getFeatureRevisionMergeStatus 2 params → 200
POST
/v1/features/{id}/revisions/{version}/rebasedeprecated
Rebase a draft revision onto the current live version
postFeatureRevisionRebase 2 params body → 200
POST
/v1/features/{id}/revisions/{version}/publishdeprecated
Publish a draft revision
postFeatureRevisionPublish 2 params body → 200
POST
/v1/features/{id}/revisions/{version}/discarddeprecated
Discard a draft revision
postFeatureRevisionDiscard 2 params body → 200
POST
/v1/features/{id}/revisions/{version}/revertdeprecated
Revert the feature to a prior revision
postFeatureRevisionRevert 2 params body → 200

Schemas 10

The contract defines 10 schemas that model the data the API accepts and returns. The most detailed are FeatureRevision (15 properties), result (7 properties), conflicts (6 properties), ScheduleRule (2 properties). Each schema is shown below with its type and property counts.

FeatureRevision
object
15 properties 7 required
result
object
7 properties
FeatureForceRule
FeatureExperimentRule
FeatureExperimentRefRule
conflicts
object
6 properties 6 required
FeatureRule
FeatureRolloutRule
ScheduleRule
object
2 properties 2 required
FeatureSafeRolloutRule

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

growthbook-feature-revisions-api-openapi.yml Raw ↑

Other APIs GrowthBook publishes across the network.

GrowthBook AnalyticsExplorations API
GrowthBook archetypes API
GrowthBook attributes API
GrowthBook code-references API
GrowthBook CustomFields API
GrowthBook Dashboards API
GrowthBook data-sources API
GrowthBook dimensions API
GrowthBook environments API
GrowthBook experiments API
GrowthBook ExperimentTemplates API
GrowthBook fact-metrics API
Where this information came from

This is an independent, third-party profile of GrowthBook feature-revisions API, 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.