# GrowthBook Constant Revisions API

**Canonical:** https://apis.io/apis/growthbook/growthbook-constant-revisions-api/  
**Provider:** GrowthBook — https://apis.io/providers/growthbook/  
**Base URL:** https://api.growthbook.io/api  
**Documentation:** https://docs.growthbook.io/api

GrowthBook Constant Revisions API is one of 51 APIs that [GrowthBook](https://apis.io/providers/growthbook/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include constant-revisions. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

**Beta** — these endpoints are new and may change in backwards-incompatible ways. Draft revisions for constants, including pending changes, approvals, and lifecycle (publish, discard, revert). Pass `version: "new"` on edit endpoints to auto-create a draft.

## Operations (19)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/constants-revisions` | List constant revisions across the organization |
| GET | `/v1/constants-revisions/{key}` | List revisions for a constant |
| POST | `/v1/constants-revisions/{key}` | Create a draft revision |
| GET | `/v1/constants-revisions/{key}/latest` | Get the most recent active draft revision |
| GET | `/v1/constants-revisions/{key}/{version}` | Get a single constant revision |
| PUT | `/v1/constants-revisions/{key}/{version}/metadata` | Update constant metadata in a draft revision |
| PUT | `/v1/constants-revisions/{key}/{version}/value` | Update the value of a constant draft revision |
| PUT | `/v1/constants-revisions/{key}/{version}/archive` | Stage an archive/unarchive in a draft revision |
| POST | `/v1/constants-revisions/{key}/{version}/request-review` | Request review for a draft revision |
| POST | `/v1/constants-revisions/{key}/{version}/submit-review` | Submit a review on a draft revision |
| POST | `/v1/constants-revisions/{key}/{version}/recall-review` | Recall a review request |
| POST | `/v1/constants-revisions/{key}/{version}/reopen` | Reopen a discarded revision |
| POST | `/v1/constants-revisions/{key}/{version}/schedule-publish` | Schedule (or cancel) a deferred publish |
| POST | `/v1/constants-revisions/{key}/{version}/undo-review` | Retract your own review verdict |
| GET | `/v1/constants-revisions/{key}/{version}/merge-status` | Get merge status for a draft revision |
| POST | `/v1/constants-revisions/{key}/{version}/rebase` | Rebase a draft revision onto the current live constant |
| POST | `/v1/constants-revisions/{key}/{version}/publish` | Publish a draft revision |
| POST | `/v1/constants-revisions/{key}/{version}/discard` | Discard a draft revision |
| POST | `/v1/constants-revisions/{key}/{version}/revert` | Revert the constant to a prior revision |

## Machine-readable artifacts (2)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/growthbook/refs/heads/main/openapi/growthbook-constant-revisions-api-openapi.yml
- **Documentation** — https://docs.growthbook.io/api

## Other GrowthBook APIs (12)

- [GrowthBook AnalyticsExplorations API](https://apis.io/apis/growthbook/growthbook-analyticsexplorations-api/)
- [GrowthBook Archetypes API](https://apis.io/apis/growthbook/growthbook-archetypes-api/)
- [GrowthBook Attributes API](https://apis.io/apis/growthbook/growthbook-attributes-api/)
- [GrowthBook Code References API](https://apis.io/apis/growthbook/growthbook-code-references-api/)
- [GrowthBook Dashboards API](https://apis.io/apis/growthbook/growthbook-dashboards-api/)
- [GrowthBook Data Sources API](https://apis.io/apis/growthbook/growthbook-data-sources-api/)
- [GrowthBook Dimensions API](https://apis.io/apis/growthbook/growthbook-dimensions-api/)
- [GrowthBook Environments API](https://apis.io/apis/growthbook/growthbook-environments-api/)
- [GrowthBook Experiments API](https://apis.io/apis/growthbook/growthbook-experiments-api/)
- [GrowthBook Fact Metrics API](https://apis.io/apis/growthbook/growthbook-fact-metrics-api/)
- [GrowthBook Fact Tables API](https://apis.io/apis/growthbook/growthbook-fact-tables-api/)
- [GrowthBook Feature Revisions API](https://apis.io/apis/growthbook/growthbook-feature-revisions-api/)

## Tags

constant-revisions

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/growthbook/growthbook-constant-revisions-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/growthbook/.