API Evangelist conversational phrasing for Appwrite Avatars API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Appwrite Avatars API
  version: 1.0.0
extends: openapi/appwrite-avatars-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: 9
- target: $.paths['/avatars/browsers/{code}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a browser icon image
      effect: read
      questions:
      - How can I show a Chrome or Firefox icon next to each of a user's sessions?
      - Can I resize the browser logo image and set its quality?
      instructions:
      - text: Get the browser icon for code {code}.
        slots:
          code: path.code
      - text: Render the {code} browser icon at {width}x{height} pixels.
        slots:
          code: path.code
          width: query.width
          height: query.height
      method: generated
      generated: '2026-09-26'
- target: $.paths['/avatars/credit-cards/{code}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a credit card brand icon
      effect: read
      questions:
      - Can I display the Visa or Mastercard logo for a saved card in my checkout UI?
      - What sizes can the card network icon be returned in?
      instructions:
      - text: Get the credit card icon for {code}.
        slots:
          code: path.code
      - text: Fetch the {code} card brand logo at {width} pixels wide with quality {quality}.
        slots:
          code: path.code
          width: query.width
          quality: query.quality
      method: generated
      generated: '2026-09-26'
- target: $.paths['/avatars/favicon'].get
  update:
    x-apievangelist-phrasing:
      intent: Fetch a website's favicon
      effect: read
      questions:
      - How do I grab the favicon of any website to show beside a link?
      - Will the favicon lookup follow redirects on the site URL?
      instructions:
      - text: Fetch the favicon for {url}.
        slots:
          url: query.url
      - text: Get the tab icon of the site at {url}.
        slots:
          url: query.url
      method: generated
      generated: '2026-09-26'
- target: $.paths['/avatars/flags/{code}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a country flag icon
      effect: read
      questions:
      - Can I show a country's flag from its two-letter code?
      - What options exist to resize a flag image for a locale picker?
      instructions:
      - text: Get the flag for country code {code}.
        slots:
          code: path.code
      - text: Render the {code} flag at {width}x{height}.
        slots:
          code: path.code
          width: query.width
          height: query.height
      method: generated
      generated: '2026-09-26'
- target: $.paths['/avatars/image'].get
  update:
    x-apievangelist-phrasing:
      intent: Fetch and crop a remote image
      effect: read
      questions:
      - How can I crop a remote image from a URL to a thumbnail size for my app?
      - Is there a way to proxy an external image through Appwrite so it loads over HTTPS?
      instructions:
      - text: Fetch the image at {url} and crop it to {width}x{height}.
        slots:
          url: query.url
          width: query.width
          height: query.height
      - text: Proxy the remote picture {url} through the avatars service.
        slots:
          url: query.url
      method: generated
      generated: '2026-09-26'
- target: $.paths['/avatars/initials'].get
  update:
    x-apievangelist-phrasing:
      intent: Generate an initials avatar
      effect: read
      questions:
      - How do I show a placeholder avatar with a user's initials?
      - Can I pick the background color of the generated initials image?
      instructions:
      - text: Generate an initials avatar for {name}.
        slots:
          name: query.name
      - text: Make an initials image for {name} with background {background}.
        slots:
          name: query.name
          background: query.background
      - text: Show the logged-in user's initials avatar.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/avatars/photo'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the best available profile photo
      effect: read
      questions:
      - Which sources are tried, in order, when looking up a user's profile photo?
      - Can I get a Gravatar-style photo using just an email hash?
      - How do I limit the profile photo lookup to a content rating?
      instructions:
      - text: Get the best profile photo for user {userId}.
        slots:
          userId: query.userId
      - text: Look up a profile photo by email hash {emailHash} at {width} pixels.
        slots:
          emailHash: query.emailHash
          width: query.width
      - text: Return a photo for {name} in {output} format.
        slots:
          name: query.name
          output: query.output
      method: generated
      generated: '2026-09-26'
- target: $.paths['/avatars/qr'].get
  update:
    x-apievangelist-phrasing:
      intent: Generate a QR code image
      effect: read
      questions:
      - How can I turn a piece of text or a link into a QR code image?
      - Can I set the size and margin of the QR code and force it to download?
      instructions:
      - text: Make a QR code for {text}.
        slots:
          text: query.text
      - text: Generate a {size}px QR code encoding {text} with margin {margin}.
        slots:
          size: query.size
          text: query.text
          margin: query.margin
      method: generated
      generated: '2026-09-26'
- target: $.paths['/avatars/screenshots'].get
  update:
    x-apievangelist-phrasing:
      intent: Capture a screenshot of a webpage
      effect: read
      questions:
      - How do I take a screenshot of a web page from its URL?
      - Can the screenshot capture the full page in dark mode on a mobile-sized viewport?
      - Is it possible to wait a few seconds before the page is captured?
      instructions:
      - text: Screenshot the page at {url}.
        slots:
          url: query.url
      - text: Capture {url} with a {viewportWidth}x{viewportHeight} viewport in {theme} theme.
        slots:
          url: query.url
          viewportWidth: query.viewportWidth
          viewportHeight: query.viewportHeight
          theme: query.theme
      - text: Take a full-page capture of {url} set to {fullpage} after sleeping {sleep} seconds.
        slots:
          url: query.url
          fullpage: query.fullpage
          sleep: query.sleep
      method: generated
      generated: '2026-09-26'