# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Harness Delegate Token Resource API
  version: 1.0.0
extends: openapi/harness-delegate-token-resource-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['/ng/api/delegate-token-ng'].get
  update:
    x-apievangelist-phrasing:
      intent: List delegate tokens
      effect: read
      questions:
      - Which delegate tokens exist in my Harness project?
      - Can I list only revoked or only active delegate tokens?
      instructions:
      - text: List delegate tokens in project {project}.
        slots:
          project: query.projectIdentifier
      - text: Show delegate tokens with status {status}.
        slots:
          status: query.status
      - text: Find the delegate token named {name}.
        slots:
          name: query.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ng/api/delegate-token-ng'].put
  update:
    x-apievangelist-phrasing:
      intent: Revoke a delegate token
      effect: destructive
      questions:
      - How do I revoke a delegate token that may have leaked?
      - Can I stop delegates from authenticating with a specific token?
      instructions:
      - text: Revoke delegate token {tokenName}.
        slots:
          tokenName: query.tokenName
      - text: Revoke delegate token {tokenName} in project {project}.
        slots:
          tokenName: query.tokenName
          project: query.projectIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ng/api/delegate-token-ng'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a delegate token
      effect: write
      questions:
      - How do I generate a new token for installing Harness delegates?
      - Can a delegate token be set to revoke itself automatically after a time?
      instructions:
      - text: Create delegate token {tokenName}.
        slots:
          tokenName: query.tokenName
      - text: Create delegate token {tokenName} that revokes after {revokeAfter}.
        slots:
          tokenName: query.tokenName
          revokeAfter: query.revokeAfter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ng/api/delegate-token-ng'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a revoked delegate token
      effect: destructive
      questions:
      - How do I permanently delete a delegate token after revoking it?
      - Can I delete a delegate token that is still active?
      instructions:
      - text: Delete the revoked delegate token {tokenName}.
        slots:
          tokenName: query.tokenName
      - text: Permanently remove revoked token {tokenName} from project {project}.
        slots:
          tokenName: query.tokenName
          project: query.projectIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ng/api/delegate-token-ng/delegate-groups'].get
  update:
    x-apievangelist-phrasing:
      intent: List delegate groups using a token
      effect: read
      questions:
      - Which delegate groups are still using a given token?
      - What will break if I revoke this delegate token?
      instructions:
      - text: List delegate groups using token {delegateTokenName}.
        slots:
          delegateTokenName: query.delegateTokenName
      - text: Show which delegates in project {project} use token {delegateTokenName}.
        slots:
          project: query.projectIdentifier
          delegateTokenName: query.delegateTokenName
      method: generated
      generated: '2026-09-26'