API Evangelist conversational phrasing for WSO2 API Manager - Admin Org Themes API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for WSO2 API Manager - Admin Org Themes API
  version: 1.0.0
extends: openapi/wso2-org-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: 5
- target: $.paths['/org-themes'].get
  update:
    x-apievangelist-phrasing:
      intent: List organization themes and publish status
      effect: read
      questions:
      - Which developer portal themes has my organization uploaded?
      - Can I see only the published org themes?
      instructions:
      - text: List our org themes.
      - text: Show org themes filtered by published status {publish}.
        slots:
          publish: query.publish
      method: generated
      generated: '2026-10-01'
- target: $.paths['/org-themes'].post
  update:
    x-apievangelist-phrasing:
      intent: Import an organization theme zip
      effect: write
      questions:
      - How do I upload a custom theme for our developer portal?
      - Can I import a drafted org theme as a zip file?
      instructions:
      - text: Import the org theme zip {file}.
        slots:
          file: requestBody.file
      - text: Upload {file} as a new organization theme.
        slots:
          file: requestBody.file
      method: generated
      generated: '2026-10-01'
- target: $.paths['/org-themes/{id}/content'].get
  update:
    x-apievangelist-phrasing:
      intent: Download an org theme as a zip
      effect: read
      questions:
      - How do I download the files of an existing org theme?
      - Can I get an org theme back as a zip to edit it?
      instructions:
      - text: Download org theme {id} as a zip.
        slots:
          id: path.id
      - text: Export the contents of theme {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/org-themes/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an organization theme
      effect: destructive
      questions:
      - How do I remove an old org theme?
      - Can I permanently delete a developer portal theme?
      instructions:
      - text: Delete org theme {id}.
        slots:
          id: path.id
      - text: Remove the theme {id} from our organization.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/org-themes/{id}/status'].post
  update:
    x-apievangelist-phrasing:
      intent: Publish or unpublish an org theme
      effect: write
      questions:
      - How do I make an uploaded theme live on the developer portal?
      - Can I unpublish an org theme without deleting it?
      instructions:
      - text: Set org theme {id} status to {action}.
        slots:
          id: path.id
          action: requestBody.action
      - text: Publish theme {id} to the developer portal.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'