# 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 API Keys (iam/v2) API
  version: 1.0.0
extends: openapi/confluent-the-data-streaming-platform-api-keys-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/api-keys'].get
  update:
    x-apievangelist-phrasing:
      intent: List API keys
      effect: read
      questions:
      - Which API keys exist in my Confluent Cloud organization?
      - Can I list only the API keys owned by a particular service account?
      - Which keys grant access to one specific Kafka cluster?
      instructions:
      - text: List all API keys.
      - text: List API keys owned by {owner}.
        slots:
          owner: query.spec.owner
      - text: Show API keys scoped to resource {resource}.
        slots:
          resource: query.spec.resource
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iam/v2/api-keys'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an API key
      effect: write
      questions:
      - How do I create an API key for a service account?
      - Can I create a key scoped to a single cluster?
      instructions:
      - text: Create an API key with spec {spec}.
        slots:
          spec: requestBody.spec
      - text: Generate a new API key for owner and resource defined in {spec}.
        slots:
          spec: requestBody.spec
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iam/v2/api-keys/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Read an API key
      effect: read
      questions:
      - Who owns a given API key and what resource is it for?
      - Can I look up an API key's details by its ID?
      instructions:
      - text: Get API key {id}.
        slots:
          id: path.id
      - text: Show the owner and resource of key {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iam/v2/api-keys/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an API key
      effect: destructive
      questions:
      - How do I revoke an API key that leaked?
      - Does deleting an API key immediately cut off access?
      instructions:
      - text: Delete API key {id}.
        slots:
          id: path.id
      - text: Revoke key {id} now.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iam/v2/api-keys/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an API key
      effect: write
      questions:
      - Can I change the display name or description of an API key?
      - What can be edited on an existing API key?
      instructions:
      - text: Update API key {id} with spec {spec}.
        slots:
          id: path.id
          spec: requestBody.spec
      - text: Change the description of key {id} to match {spec}.
        slots:
          id: path.id
          spec: requestBody.spec
      method: generated
      generated: '2026-09-26'