Introduction
Understanding organizationsUnderstanding componentsManage organizationsManage componentsManage component Jira integrations
Set up your first organizationUnderstanding users and teamsUnderstanding role-based access controlManage usersManage teamsConfigure role-based access controlRBAC permissions reference
Understanding authentication in CloudBees UnifySet up multifactor authenticationConfigure SAML single sign-onConfigure OIDC authenticationConfigure network security policiesNetwork security reference
Understanding platform configurationUnderstanding environmentsManage properties and secretsManage environmentsTrack environment inventoryConfigure containersSet up preconfigured actionsConfigure notificationsSet up Slack webhook notifications
Accessibility policy referenceShared responsibility model referenceSubscription and services agreementSupport policiesSupported browsers and external tools
Introduction
Understanding CI workflowsUnderstanding custom actionsCreate a build workflowCreate a custom actionCreate and manage workflowsCreate reusable workflowsTest and validate containers in workflowsCheck out source codeTrigger workflows remotelyWorkflow syntax referenceJobs syntax referenceSteps syntax referenceServices syntax reference
Monitor workflow runsView test results in runsView evidence in runsView deployments in runsManage workflow artifactsPublish test resultsPublish evidence itemsGenerate a software bill of materialsManage ServiceNow change requests
Configure workflow credentialsConfigure AWS credentialsConfigure container registry credentialsConfigure Git credentialsIntegrate CyberArk Conjur secrets
Understanding GitHub Actions integrationSet up GitHub Actions integrationDisplay GitHub Actions workflows and runsRegister GHA build artifactsPublish GHA deployed artifactsPublish GHA test resultsPublish GHA evidence itemsTrigger CloudBees workflows from GitHub ActionsScan with GitHub Actions
Understanding CloudBees CI and Jenkins® integrationConnect CI and Jenkins controllersMonitor CI and Jenkins buildsRegister CI build artifactsRegister CI deployed artifactsPublish CI test resultsConfigure CI security scanningCI and Jenkins integration reference
Build and publish container imagesUnderstanding external CI/CD integrationsRun external CI/CD jobsExternal CI/CD action reference
Introduction
Understanding release orchestrationManage applicationsCreate deployer workflowsCreate staged workflowsCreate and manage releasesOrchestrate multi-workflow releasesRelease management reference
Understanding artifact managementRegister and track artifactsStore and retrieve artifactsPromote artifactsGenerate a software bill of materialsArtifact management reference
Deploy with HelmDeploy to KubernetesContainer deployment reference
Deploy to AWSAWS deployment reference
Deploy with enterprise platformsExecute remote deployment commandsEnterprise deployment reference
Verify deployments with New RelicDeployment verification reference
Introduction
Understanding feature managementUnderstanding Configuration as CodeGet started with feature managementCreate and manage feature flagsConfigure feature flag targetingOrganize feature flagsImplement feature flag governanceEnable secret modeConfiguration as Code reference
Understanding flag impressions and activity statusUnderstanding flag healthUnderstanding code referencesReview and clean up feature flagsSet up code references
Understanding Jira integration for feature flagsSet up the Jira integrationLink Jira tickets to feature flags
Understanding multiple SDK keysBuild your first mobile app with feature flagsBuild your first feature-flagged web applicationBuild your first feature-flagged backend serviceInstall client-side SDKsInstall server-side SDKsConfigure multiple SDK keysFlag implementation reference
Backend SDK referenceGo SDK referenceJava SDK referencePython SDK referenceRuby SDK referencePHP SDK reference.NET/C# (server-side) SDK referenceNode.js SDK referenceMobile SDK referenceAndroid SDK referenceiOS/tvOS SDK referenceObjective-C SDK referenceSwift SDK referenceReact Native SDK referenceWeb SDK referenceJavaScript (browser) SDK referenceJavaScript SSR SDK referenceClient SDK referenceJava client SDK reference.NET/C# (client-side) SDK referenceC (server-side) SDK referenceC++ (server-side) SDK referenceC (client-side) SDK referenceC++ client SDK reference

Target groups API example

2 minute read
Reference— Information-oriented: exact details, structured for lookup.

When you need to automate user segmentation for feature-flag targeting, use this target group API example to create and manage target groups programmatically. This example demonstrates how to define advanced criteria, such as age or location, so you can consistently roll out features to the right audience and maintain parity across your environments.

Example: Create a target group

Create a new target group for advanced targeting rules.

Request
curl -X POST 'https://api.cloudbees.io/v2/applications/<applicationId>/target-groups' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <personal_access_token>' \
  --data '{
    "name": "BetaTesters",
    "conditions": {
      "allOf": [
        {
          "property": {
            "name": "age",
            "operator": "gte",
            "operands": [18]
          }
        },
        {
          "property": {
            "name": "country",
            "operator": "in-array",
            "operands": ["US", "CA"]
          }
        }
      ]
    }
  }'
▼
Response
{
  "targetGroup": {
    "id": "12345678-1234-5678-1234-56781234abcd",
    "name": "BetaTesters",
    "conditions": {
      "allOf": [
        {
          "property": {
            "name": "age",
            "operator": "gte",
            "operands": [18]
          }
        },
        {
          "property": {
            "name": "country",
            "operator": "in-array",
            "operands": ["US", "CA"]
          }
        }
      ]
    }
  }
}
▼

The conditions object

The conditions object defines the targeting logic for a target group. It is not exposed in the API reference site and is documented here for reference.

{
  "operator": "and | or",
  "conditions": [Condition]
}
▼
Field Type Description

operator

enum

Logical operator combining conditions: and or or

conditions

array

Array of condition objects

Condition types

Property condition

Evaluates a named property against a value.

{
  "property": "string",
  "operator": "string",
  "operand": "any"
}
▼
Field Type Description

property

string

Property name to evaluate

operator

string

Comparison operator (see Operators below)

operand

any

Value to compare against (not required for is-true, is-false, is-undefined)

Group condition

Evaluates against a named group.

{
  "group": {
    "name": "string | [string]",
    "operator": "and | or | not"
  },
  "value": "any"
}
▼

Dependency condition

Evaluates against the value of another flag.

{
  "dependency": {
    "flag": "string",
    "value": "any"
  },
  "value": "any"
}
▼

Version condition

Evaluates a semantic version property.

{
  "version": {
    "operator": "string",
    "semver": "string"
  },
  "value": "any"
}
▼

Operators

Operator Type Description

is-undefined

Boolean

Property has no value

is-true

Boolean

Boolean property is true

is-false

Boolean

Boolean property is false

eq

Comparison

Equals

ne

Comparison

Not equals

gt

Comparison

Greater than

gte

Comparison

Greater than or equal

lt

Comparison

Less than

lte

Comparison

Less than or equal

in-array

Array

Value is in the provided array

regex

String

Matches regular expression

semver-eq

Semver

Version equals

semver-ne

Semver

Version not equals

semver-gt

Semver

Version greater than

semver-gte

Semver

Version greater than or equal

semver-lt

Semver

Version less than

semver-lte

Semver

Version less than or equal
Organizations