# GrowthBook Configs API

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

GrowthBook Configs 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 Configs. 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. Reusable, typed, inheritable JSON objects referenced from feature flag values as `@config:key`. A config carries a field `schema` (with TypeScript/JSON Schema import-export) and a lineage `parent`. Inheritance is expressed via `parent`, never an in-value `@config:` entry. Values layer as a **deep, targeted patch**: a child (or a config-backed feature value) restates only the leaves it changes and inherits the rest — unlike a constant's `$extends`, whose own keys replace wholesale. Schema fields colliding with a published ancestor's key follow 'base wins': identical re-declarations are stripped with a warning, differing ones are rejected.

## Operations (14)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/configs` | Get all configs |
| POST | `/v1/configs` | Create a single config |
| GET | `/v1/configs/{key}/references` | Get features and configs that reference this config |
| GET | `/v1/configs/{key}/key-usage` | Get the feature rules and default values implementing each key |
| GET | `/v1/configs/{key}/lineage` | Get the full lineage (family tree) for a config |
| POST | `/v1/configs/{key}/schema/verify` | Verify a config's schema against a source (drift check) |
| GET | `/v1/configs/{key}/schema` | Export a config's schema |
| GET | `/v1/configs/{key}` | Get a single config |
| POST | `/v1/configs/{key}` | Partially update a single config |
| DELETE | `/v1/configs/{key}` | Delete a single config |
| POST | `/v1/configs/{key}/archive` | Archive a single config |
| POST | `/v1/configs/{key}/unarchive` | Unarchive a single config |
| POST | `/v1/configs/{key}/lock` | Lock a config at its current published revision |
| POST | `/v1/configs/{key}/unlock` | Unlock a config |

## Machine-readable artifacts (2)

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

Configs

---

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