Generated by API Evangelist
Written by API Evangelist tooling for Harness's API. It is a proposal applied on top of the contract, not a document Harness publishes.
# 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 Certificates API
version: 1.0.0
extends: openapi/harness-repository-certificates-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: 3
- target: $.paths['/gitops/api/v1/agents/{agentIdentifier}/certificates'].get
update:
x-apievangelist-phrasing:
intent: List repository certificates on a GitOps agent
effect: read
questions:
- Which repository TLS and SSH certificates are installed on my GitOps agent?
- Can I filter a GitOps agent's certificates by host name pattern or type?
instructions:
- text: List repository certificates on GitOps agent {agent}.
slots:
agent: path.agentIdentifier
- text: Show {cert_type} certificates on agent {agent} for hosts matching {host}.
slots:
cert_type: query.query.certType
agent: path.agentIdentifier
host: query.query.hostNamePattern
method: generated
generated: '2026-09-26'
- target: $.paths['/gitops/api/v1/agents/{agentIdentifier}/certificates'].post
update:
x-apievangelist-phrasing:
intent: Add repository certificates to a GitOps agent
effect: write
questions:
- How do I add a TLS or SSH known-host certificate so a GitOps agent trusts my repo server?
- Can I overwrite certificates that already exist when adding new ones?
instructions:
- text: 'Add these repository certificates to GitOps agent {agent}: {certificates}.'
slots:
agent: path.agentIdentifier
certificates: requestBody.certificates
- text: Upsert certificates {certificates} on agent {agent}, upsert {upsert}.
slots:
certificates: requestBody.certificates
agent: path.agentIdentifier
upsert: requestBody.upsert
method: generated
generated: '2026-09-26'
- target: $.paths['/gitops/api/v1/agents/{agentIdentifier}/certificates'].delete
update:
x-apievangelist-phrasing:
intent: Remove repository certificates from a GitOps agent
effect: destructive
questions:
- How do I delete repository certificates from a GitOps agent?
- Can I remove only the certificates for a particular host pattern?
instructions:
- text: Delete the repository certificates on GitOps agent {agent} for hosts matching {host}.
slots:
agent: path.agentIdentifier
host: query.query.hostNamePattern
- text: Remove all {cert_type} certificates from agent {agent}.
slots:
cert_type: query.query.certType
agent: path.agentIdentifier
method: generated
generated: '2026-09-26'
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.