# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Harness Targets API
  version: 1.0.0
extends: openapi/harness-targets-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 8
- target: $.paths['/cf/admin/targets'].get
  update:
    x-apievangelist-phrasing:
      intent: List feature flag targets in an environment
      effect: read
      questions:
      - Which feature flag targets exist in one of my environments?
      - Can I search targets by name or identifier and sort the list?
      instructions:
      - text: List feature flag targets in environment {environmentIdentifier} of project {projectIdentifier}.
        slots:
          environmentIdentifier: query.environmentIdentifier
          projectIdentifier: query.projectIdentifier
      - text: Find targets named {targetName} in environment {environmentIdentifier}.
        slots:
          targetName: query.targetName
          environmentIdentifier: query.environmentIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cf/admin/targets'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a feature flag target
      effect: write
      questions:
      - How do I register a new user or device as a feature flag target?
      - Can I set custom attributes on a target when I create it?
      instructions:
      - text: Create target {name} with identifier {identifier} in environment {environment} of project {project}.
        slots:
          name: requestBody.name
          identifier: requestBody.identifier
          environment: requestBody.environment
          project: requestBody.project
      - text: Add a new flag target {identifier} with attributes {attributes}.
        slots:
          identifier: requestBody.identifier
          attributes: requestBody.attributes
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cf/admin/targets/upload'].post
  update:
    x-apievangelist-phrasing:
      intent: Bulk add targets from a CSV file
      effect: write
      questions:
      - Can I import a batch of feature flag targets from a CSV?
      - What's the fastest way to add hundreds of targets at once?
      instructions:
      - text: Upload targets from {fileName} into environment {environmentIdentifier}.
        slots:
          fileName: requestBody.fileName
          environmentIdentifier: query.environmentIdentifier
      - text: Bulk import the CSV of targets into project {projectIdentifier}, environment {environmentIdentifier}.
        slots:
          projectIdentifier: query.projectIdentifier
          environmentIdentifier: query.environmentIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cf/admin/targets/{identifier}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a feature flag target's details
      effect: read
      questions:
      - How do I look up one feature flag target and its attributes?
      - What does Harness store about a single target?
      instructions:
      - text: Get target {identifier} in environment {environmentIdentifier}.
        slots:
          identifier: path.identifier
          environmentIdentifier: query.environmentIdentifier
      - text: Show the details of flag target {identifier}.
        slots:
          identifier: path.identifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cf/admin/targets/{identifier}'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a target's name and attributes
      effect: write
      questions:
      - How do I overwrite a target's full definition, including attributes?
      - Can I rename a feature flag target?
      instructions:
      - text: Replace target {identifier} with name {name} and attributes {attributes}.
        slots:
          identifier: path.identifier
          name: requestBody.name
          attributes: requestBody.attributes
      - text: Rename flag target {identifier} to {name}.
        slots:
          identifier: path.identifier
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cf/admin/targets/{identifier}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a feature flag target
      effect: destructive
      questions:
      - How do I remove a target from an environment?
      - Can I delete a feature flag target I no longer use?
      instructions:
      - text: Delete target {identifier} from environment {environmentIdentifier}.
        slots:
          identifier: path.identifier
          environmentIdentifier: query.environmentIdentifier
      - text: Remove flag target {identifier}.
        slots:
          identifier: path.identifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cf/admin/targets/{identifier}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Apply patch instructions to a target
      effect: write
      questions:
      - Can I change a target with patch instructions, like adding it to a target group?
      - Is it possible to schedule a target change for a later execution time?
      instructions:
      - text: Apply instructions {instructions} to target {identifier}.
        slots:
          instructions: requestBody.instructions
          identifier: path.identifier
      - text: Patch target {identifier} with {instructions} and comment {comment}.
        slots:
          identifier: path.identifier
          instructions: requestBody.instructions
          comment: requestBody.comment
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cf/admin/targets/{identifier}/segments'].get
  update:
    x-apievangelist-phrasing:
      intent: List the target groups a target belongs to
      effect: read
      questions:
      - Which target groups is a particular target a member of?
      - How do I check a target's segment membership?
      instructions:
      - text: List the target groups for target {identifier} in environment {environmentIdentifier}.
        slots:
          identifier: path.identifier
          environmentIdentifier: query.environmentIdentifier
      - text: Show which segments include target {identifier}.
        slots:
          identifier: path.identifier
      method: generated
      generated: '2026-09-26'