# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Qonto Business Cards API
  version: 1.0.0
extends: openapi/qonto-cards-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 2
- target: $.paths['/v2/cards'].get
  update:
    x-apievangelist-phrasing:
      intent: List the organization's payment cards
      effect: read
      questions:
      - Which cards have been issued on my Qonto business account?
      - Can I see every virtual and physical card my team holds?
      - What cards exist across the organization right now?
      instructions:
      - text: List all the cards issued on our business account.
      - text: Show me every card currently held by members of the organization.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/cards'].post
  update:
    x-apievangelist-phrasing:
      intent: Issue a new virtual or physical card
      effect: write
      questions:
      - How do I issue a new company card for a team member?
      - Can I create a virtual card instead of ordering a physical one?
      - Is there a way to retry card creation safely without issuing two cards?
      instructions:
      - text: Issue a new virtual card for our business account.
      - text: Order a new physical card using idempotency key {idempotency_key} so a retry won't duplicate it.
        slots:
          idempotency_key: header.X-Qonto-Idempotency-Key
      method: generated
      generated: '2026-10-01'