# CloudBees Flags API

**Canonical:** https://apis.io/apis/cloudbees/cloudbees-flags-api/  
**Provider:** CloudBees — https://apis.io/providers/cloudbees/  
**Base URL:** https://example.cloudbees.com  
**Documentation:** https://docs.cloudbees.com/docs/cloudbees-ci-kb/latest/best-practices/best-practice-for-using-jenkins-rest-api

CloudBees Flags API is one of 23 APIs that [CloudBees](https://apis.io/providers/cloudbees/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Flags. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, API documentation, and authentication docs.

Control runtime feature visibility and behavior to enable gradual rollouts, A/B testing, progressive delivery, and safe deployments without redeployment.

## Operations (9)

| Method | Path | Summary |
|---|---|---|
| GET | `/v2/applications/{applicationId}/flags` | List feature flags |
| POST | `/v2/applications/{applicationId}/flags` | Create a feature flag |
| GET | `/v2/applications/{applicationId}/flags/by-name/{name}` | Get a feature flag by name |
| GET | `/v2/applications/{applicationId}/flags/labels` | List flag labels |
| GET | `/v2/applications/{applicationId}/flags/{id}` | Get a feature flag |
| PUT | `/v2/applications/{applicationId}/flags/{id}` | Update a feature flag |
| DELETE | `/v2/applications/{applicationId}/flags/{id}` | Delete a feature flag |
| GET | `/v2/applications/{applicationId}/flags/{id}/configuration-state` | Get flag configuration state per environment |
| GET | `/v2/applications/{applicationId}/flags/{id}/flag-usage-per-environment` | Get flag target group usage per environment |

## Machine-readable artifacts (6)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/cloudbees/refs/heads/main/openapi/cloudbees-flags-api-openapi.yml
- **ToolCrosswalk** — https://raw.githubusercontent.com/api-evangelist/cloudbees/refs/heads/main/mcp/cloudbees-tool-crosswalk.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/cloudbees/refs/heads/main/data-model/cloudbees-data-model.yml
- **APIReference** — https://apidocs.cloudbees.io/
- **Documentation** — https://docs.cloudbees.com/docs/cloudbees-unify/latest/api-references/
- **Authentication** — https://docs.cloudbees.com/docs/cloudbees-platform/latest/workflows/personal-access-token

## Other CloudBees APIs (12)

- [CloudBees CI REST API](https://apis.io/apis/cloudbees/ci/)
- [CloudBees CD/RO REST API](https://apis.io/apis/cloudbees/cd-ro/)
- [CloudBees Feature Management REST API](https://apis.io/apis/cloudbees/feature-management/)
- [CloudBees CD/RO Jenkins Plugin Steps](https://apis.io/apis/cloudbees/jenkins-plugin/)
- [CloudBees Computer API](https://apis.io/apis/cloudbees/cloudbees-computer-api/)
- [CloudBees CreateItem API](https://apis.io/apis/cloudbees/cloudbees-createitem-api/)
- [CloudBees Job API](https://apis.io/apis/cloudbees/cloudbees-job-api/)
- [CloudBees Json API](https://apis.io/apis/cloudbees/cloudbees-json-api/)
- [CloudBees Python API](https://apis.io/apis/cloudbees/cloudbees-python-api/)
- [CloudBees Queue API](https://apis.io/apis/cloudbees/cloudbees-queue-api/)
- [CloudBees Xml API](https://apis.io/apis/cloudbees/cloudbees-xml-api/)
- [CloudBees Components API](https://apis.io/apis/cloudbees/cloudbees-components-api/)

## Tags

Flags

---

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