# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Trello Plugins API
  version: 1.0.0
extends: openapi/trello-plugins-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: 8
- target: $.paths['/plugins/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Power-Up
      effect: read
      questions:
      - How do I look up my Power-Up's details by its id?
      - What information is stored about a Power-Up plugin?
      instructions:
      - text: Show Power-Up {id}.
        slots:
          id: path.id
      - text: Fetch the plugin record for Power-Up {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/plugins/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a Power-Up
      effect: write
      questions:
      - How do I update my Power-Up's information?
      - Can I change a Power-Up's details after publishing it?
      instructions:
      - text: Update Power-Up {id}.
        slots:
          id: path.id
      - text: Save changes to my Power-Up {id} information.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/plugins/{id}/listings'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a marketplace listing for a Power-Up
      effect: write
      questions:
      - How do I publish a marketplace listing for my Power-Up?
      - What text goes into a Power-Up listing's overview and description?
      instructions:
      - text: Create a marketplace listing for Power-Up {id} named {name}.
        slots:
          id: path.id
          name: requestBody.name
      - text: Publish listing {name} for plugin {id} with overview {overview}.
        slots:
          name: requestBody.name
          id: path.id
          overview: requestBody.overview
      method: generated
      generated: '2026-09-26'
- target: $.paths['/plugins/{id}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Power-Up (trailing-slash endpoint)
      effect: read
      questions:
      - Is there a trailing-slash plugins path variant for fetching a plugin?
      - Which endpoint returns a plugin when called with a trailing slash?
      instructions:
      - text: Get plugin {id} via the trailing-slash endpoint.
        slots:
          id: path.id
      - text: Call /plugins/{id}/ to read that plugin.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/plugins/{id}/'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a Power-Up (trailing-slash endpoint)
      effect: write
      questions:
      - Is there a trailing-slash plugins path variant for updating a plugin?
      - Which update call takes the plugin path with a trailing slash?
      instructions:
      - text: Update plugin {id} via the trailing-slash endpoint.
        slots:
          id: path.id
      - text: Send a PUT to /plugins/{id}/ with my changes.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/plugins/{idPlugin}/listings'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a localized listing for a Power-Up
      effect: write
      questions:
      - How do I add a listing for my Power-Up in another language?
      - Can I create a separate listing per locale?
      instructions:
      - text: Add a {locale} listing for Power-Up {idPlugin}.
        slots:
          locale: requestBody.locale
          idPlugin: path.idPlugin
      - text: Create a listing in locale {locale} for {idPlugin} with description {description}.
        slots:
          locale: requestBody.locale
          idPlugin: path.idPlugin
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/plugins/{id}/compliance/memberPrivacy'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a Power-Up's member privacy compliance
      effect: read
      questions:
      - Which members has my Power-Up been asked to erase personal data for?
      - How do I check member privacy compliance for a Power-Up?
      instructions:
      - text: Get member privacy compliance data for Power-Up {id}.
        slots:
          id: path.id
      - text: Check privacy obligations pending for plugin {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/plugins/{idPlugin}/listings/{idListing}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a Power-Up's listing
      effect: write
      questions:
      - How do I edit an existing marketplace listing for my Power-Up?
      - Can I change a listing's overview after it's published?
      instructions:
      - text: Update listing {idListing} of Power-Up {idPlugin} with overview {overview}.
        slots:
          idListing: path.idListing
          idPlugin: path.idPlugin
          overview: requestBody.overview
      - text: Rename listing {idListing} on plugin {idPlugin} to {name}.
        slots:
          idListing: path.idListing
          idPlugin: path.idPlugin
          name: requestBody.name
      method: generated
      generated: '2026-09-26'