# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Confluence Cloud REST Themes API
  version: 1.0.0
extends: openapi/confluence-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['/wiki/rest/api/settings/theme'].get
  update:
    x-apievangelist-phrasing:
      intent: List the installed themes
      effect: read
      questions:
      - What themes are installed on my Confluence site?
      - Does the theme list include the default theme?
      instructions:
      - text: List all installed themes.
      - text: Show {limit} themes starting at {start}.
        slots:
          limit: query.limit
          start: query.start
      method: generated
      generated: '2026-10-01'
- target: $.paths['/wiki/rest/api/settings/theme/selected'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the site-wide theme
      effect: read
      questions:
      - Which theme is set globally for the whole site?
      - What look and feel do spaces inherit by default?
      instructions:
      - text: Show the globally selected theme.
      - text: Tell me which theme the site uses by default.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/wiki/rest/api/settings/theme/{themeKey}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a theme by key
      effect: read
      questions:
      - What's the name, description and icon of a particular theme?
      - How do I look up a theme's details from its key?
      instructions:
      - text: Get theme {themeKey}.
        slots:
          themeKey: path.themeKey
      - text: Describe the theme with key {themeKey}.
        slots:
          themeKey: path.themeKey
      method: generated
      generated: '2026-10-01'
- target: $.paths['/wiki/rest/api/space/{spaceKey}/theme'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the theme set on a space
      effect: read
      questions:
      - Which theme is a space using?
      - Is a space inheriting the global look and feel or has its own theme?
      instructions:
      - text: Show the theme for space {spaceKey}.
        slots:
          spaceKey: path.spaceKey
      - text: Check whether space {spaceKey} has its own theme.
        slots:
          spaceKey: path.spaceKey
      method: generated
      generated: '2026-10-01'
- target: $.paths['/wiki/rest/api/space/{spaceKey}/theme'].put
  update:
    x-apievangelist-phrasing:
      intent: Apply a theme to a space
      effect: write
      questions:
      - How do I change the theme of a single space?
      - What permission do I need to set a space's theme?
      instructions:
      - text: Set space {spaceKey} to use theme {themeKey}.
        slots:
          spaceKey: path.spaceKey
          themeKey: requestBody.themeKey
      - text: Apply theme {themeKey} to space {spaceKey}.
        slots:
          themeKey: requestBody.themeKey
          spaceKey: path.spaceKey
      method: generated
      generated: '2026-10-01'
- target: $.paths['/wiki/rest/api/space/{spaceKey}/theme'].delete
  update:
    x-apievangelist-phrasing:
      intent: Reset a space to the global theme
      effect: destructive
      questions:
      - How do I make a space go back to the site's default look and feel?
      - Can I remove a custom theme from a space?
      instructions:
      - text: Reset the theme of space {spaceKey}.
        slots:
          spaceKey: path.spaceKey
      - text: Make space {spaceKey} inherit the global theme again.
        slots:
          spaceKey: path.spaceKey
      method: generated
      generated: '2026-10-01'