# Flagsmith Feature states API

**Canonical:** https://apis.io/apis/flagsmith/flagsmith-feature-states-api/  
**Provider:** Flagsmith — https://apis.io/providers/flagsmith/  
**Base URL:** https://edge.api.flagsmith.com  
**Documentation:** https://docs.flagsmith.com/integrating-with-flagsmith/flagsmith-api-overview/flags-api/

Flagsmith Feature states API is one of 24 APIs that [Flagsmith](https://apis.io/providers/flagsmith/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Feature states. The published artifact set on APIs.io includes an OpenAPI specification.

Manage feature states and feature versioning.

## Operations (17)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/environment-feature-versions/{id}/` | Api v1 environment feature versions retrieve |
| GET | `/api/v1/environments/{environment_api_key}/featurestates/` | Api v1 environments featurestates list |
| POST | `/api/v1/environments/{environment_api_key}/featurestates/` | Api v1 environments featurestates create |
| GET | `/api/v1/environments/{environment_api_key}/featurestates/{id}/` | Api v1 environments featurestates retrieve |
| PATCH | `/api/v1/environments/{environment_api_key}/featurestates/{id}/` | Api v1 environments featurestates partial update |
| DELETE | `/api/v1/environments/{environment_api_key}/featurestates/{id}/` | Api v1 environments featurestates destroy |
| PATCH | `/api/v1/environments/{environment_pk}/features/{feature_pk}/versions/{environment_feature_version_pk}/featurestates/{id}/` | Api v1 environments features versions featurestates partial update |
| DELETE | `/api/v1/environments/{environment_pk}/features/{feature_pk}/versions/{environment_feature_version_pk}/featurestates/{id}/` | Api v1 environments features versions featurestates destroy |
| POST | `/api/v1/feature-health/{path}` | Api v1 feature health create |
| GET | `/api/v1/features/featurestates/` | Api v1 features featurestates list |
| POST | `/api/v1/features/featurestates/` | Api v1 features featurestates create |
| PATCH | `/api/v1/features/featurestates/{id}/` | Api v1 features featurestates partial update |
| GET | `/api/v1/features/featurestates/get-by-uuid/{uuid}/` | Api v1 features featurestates get by uuid retrieve |
| POST | `/api/v1/projects/{project_pk}/feature-health/events/{id}/dismiss/` | Api v1 projects feature health events dismiss create |
| GET | `/api/v1/projects/{project_pk}/feature-health/providers/` | Api v1 projects feature health providers list |
| POST | `/api/v1/projects/{project_pk}/feature-health/providers/` | Api v1 projects feature health providers create |
| DELETE | `/api/v1/projects/{project_pk}/feature-health/providers/{name}/` | Api v1 projects feature health providers destroy |

## Machine-readable artifacts (1)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/flagsmith/refs/heads/main/openapi/flagsmith-feature-states-api-openapi.yml

## Other Flagsmith APIs (12)

- [Flagsmith Flags API](https://apis.io/apis/flagsmith/flags-api/)
- [flagsmith Environments API](https://apis.io/apis/flagsmith/flagsmith-environments-api/)
- [flagsmith Features API](https://apis.io/apis/flagsmith/flagsmith-features-api/)
- [flagsmith Identities API](https://apis.io/apis/flagsmith/flagsmith-identities-api/)
- [flagsmith Organisations API](https://apis.io/apis/flagsmith/flagsmith-organisations-api/)
- [flagsmith Projects API](https://apis.io/apis/flagsmith/flagsmith-projects-api/)
- [flagsmith Segments API](https://apis.io/apis/flagsmith/flagsmith-segments-api/)
- [flagsmith Users API](https://apis.io/apis/flagsmith/flagsmith-users-api/)
- [flagsmith Webhooks API](https://apis.io/apis/flagsmith/flagsmith-webhooks-api/)
- [Flagsmith Admin dashboard API](https://apis.io/apis/flagsmith/flagsmith-admin-dashboard-api/)
- [Flagsmith Analytics API](https://apis.io/apis/flagsmith/flagsmith-analytics-api/)
- [Flagsmith Audit API](https://apis.io/apis/flagsmith/flagsmith-audit-api/)

## Tags

Feature states

---

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