How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Harness Target Groups API

APIs to create and manage Feature Flag Target Groups

Harness Target Groups API is one of 488 APIs that Harness publishes on the 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, API documentation, an API reference, a getting-started guide, authentication docs, and rate-limit docs.

This API exposes 7 operations across 4 paths, and defines 14 schemas. It is described by OpenAPI 3.2.0, at version 1.0.

Requests are made against 2 base URLs: https://app.harness.io, https://{vanity}.

7 operations 4 paths 14 schemas 1 DELETE4 GET1 PATCH1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0
Base URL
https://app.harness.io
Authentication
API Key
Terms of Service
Resource Areas
1

Authentication & Security 1

Harness Target Groups API declares 1 security scheme for authenticating requests. An API key is passed in the header as x-api-key (x-api-key). By default, every request must be authenticated.

  • x-api-key — API key is a token provided while making the API calls. This is used to authenticate the client at the exposed endpoint.

Paths & Operations 7

Across 4 paths, the API surfaces 7 operations — 1 DELETE, 4 GET, 1 PATCH, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Target Groups 7

APIs to create and manage Feature Flag Target Groups

GET
/cf/admin/segments
Returns all Target Groups
GetAllSegments 11 params → 200401403500
POST
/cf/admin/segments
Creates a Target Group
CreateSegment 2 params body → 201400401403409500
DELETE
/cf/admin/segments/{identifier}
Deletes a Target Group
DeleteSegment 5 params → 204401403404500
GET
/cf/admin/segments/{identifier}
Returns Target Group details for the given identifier
GetSegment 6 params → 200401403404500
PATCH
/cf/admin/segments/{identifier}
Updates a Target Group
PatchSegment 5 params body → 200400401403404409500
GET
/cf/admin/segments/{identifier}/available_flags
Returns Feature Flags that are available to be added to the given Target Group
GetAvailableFlagsForSegment 10 params → 200401403404500
GET
/cf/admin/segments/{identifier}/flags
Returns Feature Flags in a Target Group
GetSegmentFlags 5 params → 200401403404500

Schemas 14

The contract defines 14 schemas that model the data the API accepts and returns. The most detailed are Segment (11 properties), Target (10 properties), SegmentFlag (8 properties), Pagination (5 properties). Each schema is shown below with its type and property counts.

Tag
object
A Tag object used to tag feature flags - consists of name and identifier
2 properties 2 required
FlagBasicInfo
object
A flag Identifier and name
2 properties 2 required
Segments
object
A list of Target Groups (Segments)
GitSyncPatchOperation
object
4 properties 1 required
Pagination
object
5 properties 4 required
PatchInstruction
array
A list of Patch Instructions
CfGitDetails
object
The commit message to use as part of a gitsync operation
1 property 1 required
SegmentFlag
object
Details of a Feature Flag that has been included in a Target Group (Segment)
8 properties 6 required
Target
object
A Target object
10 properties 6 required
CfError
object
3 properties 2 required
Clause
object
A clause describes what conditions are used to evaluate a flag
5 properties 4 required
GroupServingRule
object
The rule used to determine what variation to serve to a target
3 properties 3 required
Segment
object
A Target Group (Segment) response
11 properties 2 required
FlagBasicInfos
object
A list of Flags

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

harness-target-groups-api-openapi.yml Raw ↑

Other APIs Harness publishes across the network.

Harness Continuous Integration API
Harness Continuous Delivery and GitOps API
Harness Feature Management and Experimentation API
Harness Cloud Cost Management API
Harness Chaos Engineering API
Harness Security Testing Orchestration API
Harness Internal Developer Portal API
Harness Code Repository API
Harness Service Reliability Management API
Harness Infrastructure as Code Management API
Harness Supply Chain Security API
Harness Software Engineering Insights API
Where this information came from

This is an independent, third-party profile of Harness Target Groups API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.