# CloudBees Target groups API

**Canonical:** https://apis.io/apis/cloudbees/cloudbees-target-groups-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 Target groups 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 Target Groups. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, API documentation, and authentication docs.

Define reusable sets of targeting conditions for feature flags. Specify rules once (such as matching users by role, region, or custom property) and apply them across multiple flags. Changes to a target group propagate automatically to every flag that references it.

## Operations (8)

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

## Machine-readable artifacts (6)

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

Target Groups

---

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