# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Edge Impulse Themes API
  version: 1.0.0
extends: openapi/edge-impulse-themes-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: 6
- target: $.paths['/api/themes'].get
  update:
    x-apievangelist-phrasing:
      intent: List available Studio themes
      effect: read
      questions:
      - What Studio themes are available in Edge Impulse?
      - Can I see every theme I could apply to the Studio?
      instructions:
      - text: List all available Studio themes.
      - text: Show me every Studio theme with its ID.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/themes/{themeId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Studio theme
      effect: read
      questions:
      - How do I look up the logos and colors of one specific Studio theme?
      - What does a single theme's configuration contain when fetched by ID?
      instructions:
      - text: Get Studio theme {themeId}.
        slots:
          themeId: path.themeId
      - text: Show the details of theme {themeId}.
        slots:
          themeId: path.themeId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/themes/{themeId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Studio theme
      effect: destructive
      questions:
      - Can I remove a Studio theme I no longer need?
      - How do I delete a theme by its identifier?
      instructions:
      - text: Delete Studio theme {themeId}.
        slots:
          themeId: path.themeId
      - text: Remove theme {themeId} permanently.
        slots:
          themeId: path.themeId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/themes/{themeId}/logos'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a theme's logos
      effect: write
      questions:
      - How do I swap the primary, login and mark logos on a Studio theme?
      - Can I set a separate white logo and device logo for a theme?
      instructions:
      - text: Set the primary logo of theme {themeId} to {primary}.
        slots:
          themeId: path.themeId
          primary: requestBody.primary
      - text: Update the login logo on theme {themeId} to {login} and the white version to {loginWhite}.
        slots:
          themeId: path.themeId
          login: requestBody.login
          loginWhite: requestBody.loginWhite
      - text: Change the device logo of theme {themeId} to {deviceLogo}.
        slots:
          themeId: path.themeId
          deviceLogo: requestBody.deviceLogo
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/themes/{themeId}/colors'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a theme's colors
      effect: write
      questions:
      - How do I change the primary color of a Studio theme?
      - Can a theme's primary color fade into a gradient end color?
      instructions:
      - text: Set the primary color of theme {themeId} to {primaryColor}.
        slots:
          themeId: path.themeId
          primaryColor: requestBody.primaryColor
      - text: Give theme {themeId} a gradient ending at {primaryColorGradientEnd}.
        slots:
          themeId: path.themeId
          primaryColorGradientEnd: requestBody.primaryColorGradientEnd
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/themes/{themeId}/favicon'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a theme's favicon
      effect: write
      questions:
      - How do I upload a new browser favicon for a Studio theme?
      - Which image does a theme use as its tab icon, and can I replace it?
      instructions:
      - text: Upload {image} as the favicon for theme {themeId}.
        slots:
          themeId: path.themeId
          image: requestBody.image
      - text: Replace the tab icon of Studio theme {themeId} with {image}.
        slots:
          themeId: path.themeId
          image: requestBody.image
      method: generated
      generated: '2026-10-01'