# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Harness Attributes API
  version: 1.0.0
extends: openapi/harness-attributes-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: 5
- target: $.paths['/cf/admin/attributes'].get
  update:
    x-apievangelist-phrasing:
      intent: List custom target attributes in an environment
      effect: read
      questions:
      - Which custom attributes have feature flag targets reported in an environment?
      - Can I see how many targets use each custom attribute?
      instructions:
      - text: List custom attributes in environment {environment}.
        slots:
          environment: query.environmentIdentifier
      - text: Show attribute counts for environment {environment} in project {project}.
        slots:
          environment: query.environmentIdentifier
          project: query.projectIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cf/admin/attributes'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a custom target attribute
      effect: write
      questions:
      - How do I add a new custom attribute for feature flag targeting?
      - Can I define a custom attribute key for one environment?
      instructions:
      - text: Create custom attribute {key} in environment {environment}.
        slots:
          key: requestBody.key
          environment: query.environmentIdentifier
      - text: Add attribute key {key} to project {project}.
        slots:
          key: requestBody.key
          project: query.projectIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cf/admin/attributes/{key}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a custom target attribute
      effect: read
      questions:
      - What details are stored for a particular custom attribute?
      - Can I fetch one attribute by key in an environment?
      instructions:
      - text: Get attribute {key} in environment {environment}.
        slots:
          key: path.key
          environment: query.environmentIdentifier
      - text: Show custom attribute {key}.
        slots:
          key: path.key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cf/admin/attributes/{key}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a custom target attribute
      effect: destructive
      questions:
      - How do I remove a custom attribute from an environment?
      - Can I delete an attribute key I no longer target on?
      instructions:
      - text: Delete attribute {key} from environment {environment}.
        slots:
          key: path.key
          environment: query.environmentIdentifier
      - text: Remove custom attribute {key}.
        slots:
          key: path.key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cf/admin/attributes/{key}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a custom attribute via instructions
      effect: write
      questions:
      - How do I change a custom attribute's key details in an environment?
      - Can I patch an attribute with a comment explaining the change?
      instructions:
      - text: Apply patch instructions {instructions} to attribute {key}.
        slots:
          instructions: requestBody.instructions
          key: path.key
      - text: Update attribute {key} in environment {environment} with comment {comment}.
        slots:
          key: path.key
          environment: query.environmentIdentifier
          comment: requestBody.comment
      method: generated
      generated: '2026-09-26'