# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Xquik Lists API
  version: 1.0.0
extends: openapi/xquik-api-lists-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: 3
- target: $.paths['/api/v1/x/lists/{id}/followers'].get
  update:
    x-apievangelist-phrasing:
      intent: List followers of an X List
      effect: read
      questions:
      - Who follows a particular X List?
      - Can I filter a List's followers by account age?
      instructions:
      - text: List the followers of X List {id}.
        slots:
          id: path.id
      - text: Show followers of list {id} with at least {minFollowers} followers of their own.
        slots:
          id: path.id
          minFollowers: query.minFollowers
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/x/lists/{id}/members'].get
  update:
    x-apievangelist-phrasing:
      intent: List members of an X List
      effect: read
      questions:
      - Which accounts are members of an X List?
      - Can I find verified accounts among a List's members?
      instructions:
      - text: List the members of X List {id}.
        slots:
          id: path.id
      - text: Find members of list {id} whose location includes {locationContains}.
        slots:
          id: path.id
          locationContains: query.locationContains
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/x/lists/{id}/tweets'].get
  update:
    x-apievangelist-phrasing:
      intent: Read tweets from an X List
      effect: read
      questions:
      - What are the latest tweets from accounts on an X List?
      - Can I include replies when reading a List's timeline?
      instructions:
      - text: Show tweets from X List {id}.
        slots:
          id: path.id
      - text: Get tweets from list {id} posted between {sinceTime} and {untilTime}.
        slots:
          id: path.id
          sinceTime: query.sinceTime
          untilTime: query.untilTime
      method: generated
      generated: '2026-09-26'