# GrowthBook Saved Group Revisions API

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

GrowthBook Saved Group 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 saved-group-revisions. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

Draft revisions for saved groups, including pending changes, approvals, and lifecycle (publish, discard, revert). Most callers can interact with these endpoints via shorthand actions (`/items/add`, `/items/remove`, single-field PUTs) instead of authoring JSON Patch ops directly. Pass `version: "new"` on edit endpoints to auto-create a draft.

## Operations (22)

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

## Machine-readable artifacts (2)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/growthbook/refs/heads/main/openapi/growthbook-saved-group-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

saved-group-revisions

---

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