API Evangelist conversational phrasing for Lucid REST Folders API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Lucid REST Folders API
  version: 1.0.0
extends: openapi/lucid-folders-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: 9
- target: $.paths['/v1/folders/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a folder's details
      effect: read
      questions:
      - What information can I get about a single Lucid folder?
      - Can I check a folder's name and parent by its ID?
      instructions:
      - text: Get folder {id}.
        slots:
          id: path.id
      - text: Show the details of folder {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/folders/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Rename or move a folder
      effect: write
      questions:
      - How do I rename a folder?
      - What permissions do I need to move a folder to a new parent?
      instructions:
      - text: Rename folder {id} to {name}.
        slots:
          id: path.id
          name: requestBody.name
      - text: Move folder {id} under parent {parent}.
        slots:
          id: path.id
          parent: requestBody.parent
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/folders'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a new folder
      effect: write
      questions:
      - Can I create a folder or team folder from code?
      - How do I make a new folder inside an existing one?
      instructions:
      - text: Create a {type} called {name}.
        slots:
          type: requestBody.type
          name: requestBody.name
      - text: Create {type} {name} inside folder {parent}.
        slots:
          type: requestBody.type
          name: requestBody.name
          parent: requestBody.parent
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/folders/{id}/trash'].post
  update:
    x-apievangelist-phrasing:
      intent: Move a folder and its contents to the trash
      effect: destructive
      questions:
      - Does trashing a folder also trash everything in it?
      - Can I send a whole folder to the trash?
      instructions:
      - text: Trash folder {id}.
        slots:
          id: path.id
      - text: Move folder {id} and its contents to the trash.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/folders/{id}/restore'].post
  update:
    x-apievangelist-phrasing:
      intent: Restore a trashed folder
      effect: write
      questions:
      - Can I bring back a folder I trashed?
      - Where do a restored folder's contents end up?
      instructions:
      - text: Restore folder {id} from the trash.
        slots:
          id: path.id
      - text: Undo the trashing of folder {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/folders/search'].post
  update:
    x-apievangelist-phrasing:
      intent: Search folders I can access
      effect: read
      questions:
      - How do I find folders by keyword?
      - Can an admin search every folder on the account?
      instructions:
      - text: Search folders for {keywords} as {Lucid-Request-As}.
        slots:
          keywords: requestBody.keywords
          Lucid-Request-As: header.Lucid-Request-As
      - text: Find {type} folders owned by {ownedByUsers}, requesting as {Lucid-Request-As}.
        slots:
          type: requestBody.type
          ownedByUsers: requestBody.ownedByUsers
          Lucid-Request-As: header.Lucid-Request-As
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/folders/{id}/contents'].get
  update:
    x-apievangelist-phrasing:
      intent: List what is inside a folder
      effect: read
      questions:
      - What documents and subfolders are inside a given folder?
      - Can I list a folder's contents page by page?
      instructions:
      - text: List the contents of folder {id}.
        slots:
          id: path.id
      - text: Show the documents and subfolders in folder {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/folders/root/contents'].get
  update:
    x-apievangelist-phrasing:
      intent: List the contents of my root folder
      effect: read
      questions:
      - What's at the top level of my Lucid documents?
      - Which items sit in my root folder?
      instructions:
      - text: List my root folder contents.
      - text: Show what's at the top level of my documents.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/folders/app/contents'].get
  update:
    x-apievangelist-phrasing:
      intent: List my app's project folder contents
      effect: read
      questions:
      - What has my OAuth app saved in its own app folder?
      - How is the app project folder chosen for the listing?
      instructions:
      - text: List the contents of this app's project folder.
      - text: Show the documents my integration stored in its app folder.
      method: generated
      generated: '2026-10-01'