# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Harness Project Certificate API
  version: 1.0.0
extends: openapi/harness-project-certificate-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['/v1/orgs/{org}/projects/{project}/certificates/{certificate}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a project certificate
      effect: read
      questions:
      - What are the details of a certificate stored in my project?
      - Can I look up one project-level certificate by identifier?
      instructions:
      - text: Get certificate {certificate} in project {project} of org {org}.
        slots:
          certificate: path.certificate
          project: path.project
          org: path.org
      - text: Show project {project} certificate {certificate} in org {org}.
        slots:
          project: path.project
          certificate: path.certificate
          org: path.org
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/orgs/{org}/projects/{project}/certificates/{certificate}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a project certificate
      effect: write
      questions:
      - How do I replace the certificate value stored in a project?
      - Can I rename or retag a project certificate?
      instructions:
      - text: Update certificate {certificate} in project {project} of org {org} with value {value}.
        slots:
          certificate: path.certificate
          project: path.project
          org: path.org
          value: requestBody.certificate_value
      - text: Rename project {project} certificate {certificate} in org {org} to {name}.
        slots:
          project: path.project
          certificate: path.certificate
          org: path.org
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/orgs/{org}/projects/{project}/certificates/{certificate}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a project certificate
      effect: destructive
      questions:
      - How do I remove a certificate from a project?
      - Can I force-delete a project certificate that is still in use?
      instructions:
      - text: Delete certificate {certificate} from project {project} in org {org}.
        slots:
          certificate: path.certificate
          project: path.project
          org: path.org
      - text: Force delete project {project} certificate {certificate} in org {org}.
        slots:
          project: path.project
          certificate: path.certificate
          org: path.org
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/orgs/{org}/projects/{project}/certificates/validate-unique-identifier/{certificate}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a project certificate ID is available
      effect: read
      questions:
      - Is a certificate identifier still free to use in my project?
      - Can I check for a name clash before adding a project certificate?
      instructions:
      - text: Check whether certificate identifier {certificate} is available in project {project} of org {org}.
        slots:
          certificate: path.certificate
          project: path.project
          org: path.org
      - text: Validate that {certificate} is unused as a certificate ID in org {org} project {project}.
        slots:
          certificate: path.certificate
          org: path.org
          project: path.project
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/orgs/{org}/projects/{project}/certificates'].get
  update:
    x-apievangelist-phrasing:
      intent: List a project's certificates
      effect: read
      questions:
      - Which certificates are stored in my project?
      - Can I search project certificates and include ones inherited from higher scopes?
      instructions:
      - text: List certificates in project {project} of org {org}.
        slots:
          project: path.project
          org: path.org
      - text: Search project {project} certificates in org {org} for {term}.
        slots:
          project: path.project
          org: path.org
          term: query.search_term
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/orgs/{org}/projects/{project}/certificates'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a certificate to a project
      effect: write
      questions:
      - How do I upload a new certificate at project scope?
      - What fields are required to create a project certificate?
      instructions:
      - text: Create certificate {name} with identifier {identifier} in project {project} of org {org}.
        slots:
          name: requestBody.name
          identifier: requestBody.identifier
          project: path.project
          org: path.org
      - text: Upload certificate file {file} to project {project} in org {org}.
        slots:
          file: requestBody.file
          project: path.project
          org: path.org
      method: generated
      generated: '2026-09-26'