API Evangelist conversational phrasing for Mailchimp Marketing File Manager API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Mailchimp Marketing File Manager API
  version: 1.0.0
extends: openapi/mailchimp-file-manager-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: 11
- target: $.paths['/file-manager/files'].get
  update:
    x-apievangelist-phrasing:
      intent: List all files in the File Manager
      effect: read
      questions:
      - What images and files have I uploaded to the Mailchimp File Manager?
      - Can I list only the image files, sorted by when they were added?
      - Which files did a particular teammate upload?
      instructions:
      - text: List every file in my File Manager across all folders.
      - text: List File Manager files of type {type} created since {since_created_at}.
        slots:
          type: query.type
          since_created_at: query.since_created_at
      - text: Show account-wide files uploaded by {created_by}.
        slots:
          created_by: query.created_by
      method: generated
      generated: '2026-10-01'
- target: $.paths['/file-manager/files'].post
  update:
    x-apievangelist-phrasing:
      intent: Upload an image or file
      effect: write
      questions:
      - How do I upload an image to use in my email campaigns?
      - Can I put a new file straight into a specific File Manager folder?
      instructions:
      - text: Upload file {name} with contents {file_data}.
        slots:
          name: requestBody.name
          file_data: requestBody.file_data
      - text: Upload {name} from base64 data {file_data} into folder {folder_id}.
        slots:
          name: requestBody.name
          file_data: requestBody.file_data
          folder_id: requestBody.folder_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/file-manager/files/{file_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get details of one stored file
      effect: read
      questions:
      - What's the URL and size of a specific file in my File Manager?
      - Can I look up one uploaded image by its id?
      instructions:
      - text: Get File Manager file {file_id}.
        slots:
          file_id: path.file_id
      - text: Show the URL and dimensions of file {file_id}.
        slots:
          file_id: path.file_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/file-manager/files/{file_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a stored file
      effect: destructive
      questions:
      - How do I delete an image from the File Manager?
      - Can I remove a file I uploaded by mistake?
      instructions:
      - text: Delete file {file_id} from the File Manager.
        slots:
          file_id: path.file_id
      - text: Remove uploaded file {file_id}.
        slots:
          file_id: path.file_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/file-manager/files/{file_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Rename a file or move it between folders
      effect: write
      questions:
      - How do I rename an uploaded file?
      - Can I move a file into a different folder, or out of any folder?
      instructions:
      - text: Rename file {file_id} to {name}.
        slots:
          file_id: path.file_id
          name: requestBody.name
      - text: Move file {file_id} into folder {folder_id}.
        slots:
          file_id: path.file_id
          folder_id: requestBody.folder_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/file-manager/folders'].get
  update:
    x-apievangelist-phrasing:
      intent: List File Manager folders
      effect: read
      questions:
      - What folders exist in my File Manager?
      - Can I see folders created after a certain date?
      instructions:
      - text: List my File Manager folders.
      - text: List folders created by {created_by}.
        slots:
          created_by: query.created_by
      method: generated
      generated: '2026-10-01'
- target: $.paths['/file-manager/folders'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a File Manager folder
      effect: write
      questions:
      - How do I create a new folder to organize my images?
      - Can I add a folder to the File Manager through the API?
      instructions:
      - text: Create a File Manager folder named {name}.
        slots:
          name: requestBody.name
      - text: Add a new folder called {name} for my campaign assets.
        slots:
          name: requestBody.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/file-manager/folders/{folder_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get details of one File Manager folder
      effect: read
      questions:
      - How many files are in a particular folder?
      - Can I look up one folder's name and creator by its id?
      instructions:
      - text: Get File Manager folder {folder_id}.
        slots:
          folder_id: path.folder_id
      - text: Show the file count and name of folder {folder_id}.
        slots:
          folder_id: path.folder_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/file-manager/folders/{folder_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a File Manager folder
      effect: destructive
      questions:
      - How do I delete a folder from the File Manager?
      - Can I get rid of a folder I no longer use?
      instructions:
      - text: Delete folder {folder_id}.
        slots:
          folder_id: path.folder_id
      - text: Remove File Manager folder {folder_id}.
        slots:
          folder_id: path.folder_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/file-manager/folders/{folder_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Rename a File Manager folder
      effect: write
      questions:
      - How do I rename a folder in the File Manager?
      - Can I change a folder's name after creating it?
      instructions:
      - text: Rename folder {folder_id} to {name}.
        slots:
          folder_id: path.folder_id
          name: requestBody.name
      - text: Change the name of File Manager folder {folder_id} to {name}.
        slots:
          folder_id: path.folder_id
          name: requestBody.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/file-manager/folders/{folder_id}/files'].get
  update:
    x-apievangelist-phrasing:
      intent: List the files inside one folder
      effect: read
      questions:
      - Which images are stored in a specific folder?
      - Can I list just the files in one folder, filtered by type?
      instructions:
      - text: List the files in folder {folder_id}.
        slots:
          folder_id: path.folder_id
      - text: List {type} files in folder {folder_id}.
        slots:
          type: query.type
          folder_id: path.folder_id
      method: generated
      generated: '2026-10-01'