Loops · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Loops OpenAPI Spec Themes API

5 actions 5 updates phrasing extends openapi/loops-themes-api-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for Loops's API. It is a proposal applied on top of the contract, not a document Loops publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 5

$.info
$.paths['/v1/themes/{themeId}'].get
$.paths['/v1/themes/{themeId}'].post
$.paths['/v1/themes'].get
$.paths['/v1/themes'].post

OpenAPI Overlay

Raw ↑ 
# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Loops OpenAPI Spec Themes API
  version: 1.0.0
extends: openapi/loops-themes-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: 4
- target: $.paths['/v1/themes/{themeId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an email theme
      effect: read
      questions:
      - How do I see the styles in a particular email theme?
      - What fonts and colors does a given theme set?
      instructions:
      - text: Show theme {themeId}.
        slots:
          themeId: path.themeId
      - text: Get the styles of email theme {themeId}.
        slots:
          themeId: path.themeId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/themes/{themeId}'].post
  update:
    x-apievangelist-phrasing:
      intent: Update an email theme
      effect: write
      questions:
      - If I change a theme's styles, which emails are affected?
      - Are manual style overrides on an email kept when the theme changes?
      instructions:
      - text: Update the styles of theme {themeId} to {styles}.
        slots:
          themeId: path.themeId
          styles: requestBody.styles
      - text: Rename theme {themeId} to {name}.
        slots:
          themeId: path.themeId
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/themes'].get
  update:
    x-apievangelist-phrasing:
      intent: List email themes
      effect: read
      questions:
      - Which email themes has my team created?
      - Can I list themes newest first?
      instructions:
      - text: List my email themes.
      - text: Show themes from cursor {cursor}.
        slots:
          cursor: query.cursor
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/themes'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an email theme
      effect: write
      questions:
      - How do I create a new theme to style my emails?
      - Can I set styles when creating a theme?
      instructions:
      - text: Create a theme called {name}.
        slots:
          name: requestBody.name
      - text: Create email theme {name} with styles {styles}.
        slots:
          name: requestBody.name
          styles: requestBody.styles
      method: generated
      generated: '2026-09-26'