API Evangelist conversational phrasing for Anthropic Files API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Anthropic Files API
  version: 1.0.0
extends: openapi/anthropic-files-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: 10
- target: $.paths['/v1/files'].get
  update:
    x-apievangelist-phrasing:
      intent: List uploaded files on the plain endpoint
      effect: read
      questions:
      - Which files have I uploaded, listed without the beta query flag?
      - Can I look up several specific files by their IDs in one list call?
      instructions:
      - text: On the plain endpoint, list files {ids}.
        slots:
          ids: query.ids[]
      - text: List {limit} of my uploaded files per page without the beta flag.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/files'].post
  update:
    x-apievangelist-phrasing:
      intent: Upload a file that expires
      effect: write
      questions:
      - How do I upload a file so I can reference it in later requests?
      - Can I set an uploaded file to expire after a number of seconds?
      instructions:
      - text: Upload {file} and expire it after {expires_in_seconds} seconds.
        slots:
          file: requestBody.file
          expires_in_seconds: requestBody.expires_in_seconds
      - text: On the plain endpoint, upload file {file}.
        slots:
          file: requestBody.file
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/files/{file_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a file's metadata on the plain endpoint
      effect: read
      questions:
      - What's the name, size and type of a file I uploaded?
      - Can I read a file's metadata without adding the beta query flag?
      instructions:
      - text: Get metadata for file {file_id} on the plain endpoint.
        slots:
          file_id: path.file_id
      - text: Without the beta parameter, describe uploaded file {file_id}.
        slots:
          file_id: path.file_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/files/{file_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a file on the plain endpoint
      effect: destructive
      questions:
      - How do I delete a file I uploaded, without the beta query flag?
      - Is deleting an uploaded file from /v1/files permanent?
      instructions:
      - text: Delete file {file_id} using the plain endpoint.
        slots:
          file_id: path.file_id
      - text: Without the beta parameter, erase uploaded file {file_id}.
        slots:
          file_id: path.file_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/files/{file_id}/content'].get
  update:
    x-apievangelist-phrasing:
      intent: Download a file's content on the plain endpoint
      effect: read
      questions:
      - How do I download the actual contents of a stored file?
      - Can I fetch file bytes from /content without the beta query flag?
      instructions:
      - text: Download the contents of file {file_id} on the plain endpoint.
        slots:
          file_id: path.file_id
      - text: Without the beta parameter, save file {file_id} locally.
        slots:
          file_id: path.file_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/files/{file_id}/content?beta=true'].get
  update:
    x-apievangelist-phrasing:
      intent: Download a file's content via the beta flag
      effect: read
      questions:
      - Can I download a file an agent produced through the beta files endpoint?
      - What's the beta-flag way to get a file's raw bytes?
      instructions:
      - text: Download beta file {file_id} content.
        slots:
          file_id: path.file_id
      - text: With the beta flag, pull the bytes of file {file_id}.
        slots:
          file_id: path.file_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/files/{file_id}?beta=true'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a file's metadata via the beta flag
      effect: read
      questions:
      - How do I read a file's metadata through the beta files endpoint?
      - Does the beta flag return the same file details as the plain call?
      instructions:
      - text: Get beta file metadata for {file_id}.
        slots:
          file_id: path.file_id
      - text: With the beta flag, show the details of file {file_id}.
        slots:
          file_id: path.file_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/files/{file_id}?beta=true'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a file via the beta flag
      effect: destructive
      questions:
      - Can I delete an uploaded file through the beta files endpoint?
      - What's the beta-flag call to remove a stored file?
      instructions:
      - text: Delete beta file {file_id}.
        slots:
          file_id: path.file_id
      - text: With the beta flag, remove file {file_id} for good.
        slots:
          file_id: path.file_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/files?beta=true'].get
  update:
    x-apievangelist-phrasing:
      intent: List files by scope via the beta flag
      effect: read
      questions:
      - Can I list only the files that belong to a particular scope, such as one session?
      - How do I page through files with before and after IDs using the beta flag?
      instructions:
      - text: List files in scope {scope_id}.
        slots:
          scope_id: query.scope_id
      - text: With the beta flag, list files uploaded after {after_id}.
        slots:
          after_id: query.after_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/files?beta=true'].post
  update:
    x-apievangelist-phrasing:
      intent: Upload a file via the beta flag
      effect: write
      questions:
      - How do I upload a file with the beta files endpoint?
      - Which beta-flag call stores a new file for later use in messages?
      instructions:
      - text: Upload beta file {file}.
        slots:
          file: requestBody.file
      - text: With the beta flag, store {file} for use in later requests.
        slots:
          file: requestBody.file
      method: generated
      generated: '2026-09-26'