# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Confluent Cloud Certificate Authorities (iam/v2) API
  version: 1.0.0
extends: openapi/confluent-certificate-authorities-iam-v2-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['/iam/v2/certificate-authorities'].get
  update:
    x-apievangelist-phrasing:
      intent: List certificate authorities
      effect: read
      questions:
      - Which certificate authorities are registered for mTLS in my organization?
      - How do I page through all my certificate authorities?
      instructions:
      - text: List all certificate authorities.
      - text: Show the next page of certificate authorities after {page_token}.
        slots:
          page_token: query.page_token
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iam/v2/certificate-authorities'].post
  update:
    x-apievangelist-phrasing:
      intent: Register a certificate authority
      effect: write
      questions:
      - How do I upload a CA certificate chain so clients can authenticate with mTLS?
      - Can I require CRL checks on client certificates when adding a certificate authority?
      instructions:
      - text: Create a certificate authority named {display_name} from chain {certificate_chain}.
        slots:
          display_name: requestBody.display_name
          certificate_chain: requestBody.certificate_chain
      - text: Add certificate authority {display_name} with its CRL fetched from {crl_url}.
        slots:
          display_name: requestBody.display_name
          crl_url: requestBody.crl_url
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iam/v2/certificate-authorities/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a certificate authority
      effect: read
      questions:
      - What certificate chain and CRL settings does one of my CAs have?
      - Can I read a single certificate authority by its ID?
      instructions:
      - text: Get certificate authority {id}.
        slots:
          id: path.id
      - text: Show the settings of CA {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iam/v2/certificate-authorities/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a certificate authority
      effect: write
      questions:
      - How do I rotate the certificate chain on an existing certificate authority?
      - Can I change the CRL URL for a CA I already registered?
      instructions:
      - text: Replace the certificate chain on CA {id} with {certificate_chain} from file {certificate_chain_filename}.
        slots:
          id: path.id
          certificate_chain: requestBody.certificate_chain
          certificate_chain_filename: requestBody.certificate_chain_filename
      - text: Point certificate authority {id} at CRL URL {crl_url}.
        slots:
          id: path.id
          crl_url: requestBody.crl_url
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iam/v2/certificate-authorities/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a certificate authority
      effect: destructive
      questions:
      - What removes a certificate authority from my organization?
      - Can I delete a CA I no longer trust for mTLS?
      instructions:
      - text: Delete certificate authority {id}.
        slots:
          id: path.id
      - text: Remove CA {id} from the organization.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'