# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Relevance AI Endpoints Branding Kits API
  version: 1.0.0
extends: openapi/relevance-ai-branding-kits-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['/branding_kits'].get
  update:
    x-apievangelist-phrasing:
      intent: List all branding kits
      effect: read
      questions:
      - What branding kits do I have saved?
      - Can I see every brand kit in my project at once?
      instructions:
      - text: List all my branding kits.
      - text: Show every brand kit saved in this project.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/branding_kits'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a branding kit
      effect: write
      questions:
      - How do I set up a new branding kit with logos, colors and fonts?
      - Can a branding kit store brand tone, voice and slide instructions?
      instructions:
      - text: Create a branding kit named {name} with colors {colors}.
        slots:
          name: requestBody.name
          colors: requestBody.colors
      - text: Create brand kit {name} with brand voice {brand_voice} and logos {logos}.
        slots:
          name: requestBody.name
          brand_voice: requestBody.brand_voice
          logos: requestBody.logos
      method: generated
      generated: '2026-09-26'
- target: $.paths['/branding_kits/{branding_kit_id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an existing branding kit
      effect: write
      questions:
      - Can I change the colors on a branding kit I already made?
      - How do I update the brand tone of an existing kit?
      instructions:
      - text: Update branding kit {branding_kit_id} with colors {colors}.
        slots:
          branding_kit_id: path.branding_kit_id
          colors: requestBody.colors
      - text: Change the brand tone of kit {branding_kit_id} to {brand_tone}.
        slots:
          branding_kit_id: path.branding_kit_id
          brand_tone: requestBody.brand_tone
      method: generated
      generated: '2026-09-26'
- target: $.paths['/branding_kits/{branding_kit_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a branding kit
      effect: destructive
      questions:
      - How do I delete a branding kit?
      - Can I remove a brand kit I no longer use?
      instructions:
      - text: Delete branding kit {branding_kit_id}.
        slots:
          branding_kit_id: path.branding_kit_id
      - text: Remove brand kit {branding_kit_id} permanently.
        slots:
          branding_kit_id: path.branding_kit_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/branding_kits/generate'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate a branding kit from images
      effect: write
      questions:
      - Can a branding kit be generated automatically from a few images?
      - What do I need to provide to auto-create a brand kit from pictures?
      instructions:
      - text: Generate a branding kit from images {image_urls}.
        slots:
          image_urls: requestBody.image_urls
      - text: 'Build a complete brand kit using these image URLs: {image_urls}.'
        slots:
          image_urls: requestBody.image_urls
      method: generated
      generated: '2026-09-26'