API Evangelist conversational phrasing for Clickup Attachments API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Clickup Attachments API
  version: 1.0.0
extends: openapi/clickup-attachments-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['/v2/task/{task_id}/attachment'].post
  update:
    x-apievangelist-phrasing:
      intent: Upload a file to a task (v2)
      effect: write
      questions:
      - How do I attach a local file to a ClickUp task?
      - Can I attach a file that lives in cloud storage through the v2 upload?
      instructions:
      - text: Upload file {attachment} to task {task_id} as a v2 attachment.
        slots:
          attachment: requestBody.attachment
          task_id: path.task_id
      - text: Attach {attachment} to custom task {task_id} in Workspace {team_id}.
        slots:
          attachment: requestBody.attachment
          task_id: path.task_id
          team_id: query.team_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v3/workspaces/{workspace_id}/{entity_type}/{entity_id}/attachments'].get
  update:
    x-apievangelist-phrasing:
      intent: List attachments on a task or file field
      effect: read
      questions:
      - What files are attached to a task or a File Custom Field?
      - Is the v3 attachments list paginated with a cursor?
      instructions:
      - text: List attachments on {entity_type} {entity_id} in Workspace {workspace_id}.
        slots:
          entity_type: path.entity_type
          entity_id: path.entity_id
          workspace_id: path.workspace_id
      - text: Get the next {limit} attachments for {entity_type} {entity_id} in {workspace_id} after cursor {cursor}.
        slots:
          limit: query.limit
          entity_type: path.entity_type
          entity_id: path.entity_id
          workspace_id: path.workspace_id
          cursor: query.cursor
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v3/workspaces/{workspace_id}/{entity_type}/{entity_id}/attachments'].post
  update:
    x-apievangelist-phrasing:
      intent: Upload an attachment to a task or file field (v3)
      effect: write
      questions:
      - Can I upload a file into a File-type Custom Field with the v3 API?
      - What step follows uploading to a custom_fields entity?
      instructions:
      - text: Upload {filename} to {entity_type} {entity_id} in Workspace {workspace_id} with v3.
        slots:
          filename: requestBody.filename
          entity_type: path.entity_type
          entity_id: path.entity_id
          workspace_id: path.workspace_id
      - text: Put a v3 attachment on {entity_type} {entity_id} in {workspace_id}.
        slots:
          entity_type: path.entity_type
          entity_id: path.entity_id
          workspace_id: path.workspace_id
      method: generated
      generated: '2026-09-26'