# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Harness Repository credentials API
  version: 1.0.0
extends: openapi/harness-repository-credentials-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: 6
- target: $.paths['/gitops/api/v1/agents/{agentIdentifier}/repocreds'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a GitOps repository credential template
      effect: write
      questions:
      - How do I add a credential template so a GitOps agent can access many repos?
      - Can I upsert repository credentials on a GitOps agent?
      instructions:
      - text: Create repository credentials {id} on GitOps agent {agent}.
        slots:
          id: query.identifier
          agent: path.agentIdentifier
      - text: Add a repo credential template to agent {agent}, overwriting if it exists.
        slots:
          agent: path.agentIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gitops/api/v1/agents/{agentIdentifier}/repocreds/get'].post
  update:
    x-apievangelist-phrasing:
      intent: Find the credential that matches a repo URL
      effect: read
      questions:
      - Which credential template would a GitOps agent use for a given repository URL?
      - Can I look up repo credentials by URL instead of by identifier?
      instructions:
      - text: Find the credentials agent {agent} uses for repository URL {url}.
        slots:
          agent: path.agentIdentifier
          url: requestBody.url
      - text: Look up repo credentials matching {url} on GitOps agent {agent}.
        slots:
          url: requestBody.url
          agent: path.agentIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gitops/api/v1/agents/{agentIdentifier}/repocreds/{identifier}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a GitOps repository credential
      effect: read
      questions:
      - Where can I see one repository credential template by its identifier?
      - What URL pattern does a given repo credential cover?
      instructions:
      - text: Get repository credential {id} on agent {agent}.
        slots:
          id: path.identifier
          agent: path.agentIdentifier
      - text: Show repo credential {id} from GitOps agent {agent}.
        slots:
          id: path.identifier
          agent: path.agentIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gitops/api/v1/agents/{agentIdentifier}/repocreds/{identifier}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a GitOps repository credential
      effect: write
      questions:
      - How do I rotate the password or key in a repository credential template?
      - Can I update only some fields of a repo credential with an update mask?
      instructions:
      - text: Update repository credential {id} on agent {agent}.
        slots:
          id: path.identifier
          agent: path.agentIdentifier
      - text: Rotate the secret in repo credential {id} for GitOps agent {agent}.
        slots:
          id: path.identifier
          agent: path.agentIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gitops/api/v1/agents/{agentIdentifier}/repocreds/{identifier}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a GitOps repository credential
      effect: destructive
      questions:
      - How do I remove a repository credential template from a GitOps agent?
      - What happens to repos that relied on a credential I delete?
      instructions:
      - text: Delete repository credential {id} from agent {agent}.
        slots:
          id: path.identifier
          agent: path.agentIdentifier
      - text: Remove repo credential {id} on GitOps agent {agent}.
        slots:
          id: path.identifier
          agent: path.agentIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gitops/api/v1/repocreds'].post
  update:
    x-apievangelist-phrasing:
      intent: List GitOps repository credentials
      effect: read
      questions:
      - Which repository credential templates are configured for GitOps?
      - Can I list repo credentials including those from child scopes?
      instructions:
      - text: List repository credentials for agent {agent}.
        slots:
          agent: requestBody.agentIdentifier
      - text: Search GitOps repo credentials for {term}.
        slots:
          term: requestBody.searchTerm
      method: generated
      generated: '2026-09-26'