naftiko: 1.0.0-alpha2
info:
  label: Langflow Files
  description: 'Langflow Files. 18 operations. Lead operation: Delete File. Self-contained Naftiko capability covering one
    Langflow business surface.'
  tags:
  - Langflow
  - Files
  created: '2026-05-24'
  modified: '2026-05-24'
binds:
- namespace: env
  keys:
    LANGFLOW_API_KEY: LANGFLOW_API_KEY
    LANGFLOW_BASE_URL: LANGFLOW_BASE_URL
capability:
  consumes:
  - type: http
    namespace: files
    baseUri: '{{env.LANGFLOW_BASE_URL}}'
    description: Langflow Files business capability.
    resources:
    - name: api-v1-files-delete-flow-id-file-name
      path: /api/v1/files/delete/{flow_id}/{file_name}
      operations:
      - name: delete-file
        method: DELETE
        description: Delete File
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: file_name
          in: path
          type: string
          description: file_name parameter.
          required: true
        - name: flow_id
          in: path
          type: string
          description: flow_id parameter.
          required: true
    - name: api-v1-files-download-flow-id-file-name
      path: /api/v1/files/download/{flow_id}/{file_name}
      operations:
      - name: download-file
        method: GET
        description: Download File
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: file_name
          in: path
          type: string
          description: file_name parameter.
          required: true
        - name: flow_id
          in: path
          type: string
          description: flow_id parameter.
          required: true
    - name: api-v1-files-images-flow-id-file-name
      path: /api/v1/files/images/{flow_id}/{file_name}
      operations:
      - name: download-image
        method: GET
        description: Download Image
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: file_name
          in: path
          type: string
          description: file_name parameter.
          required: true
        - name: flow_id
          in: path
          type: string
          description: flow_id parameter.
          required: true
    - name: api-v1-files-list-flow-id
      path: /api/v1/files/list/{flow_id}
      operations:
      - name: list-files
        method: GET
        description: List Files
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: flow_id
          in: path
          type: string
          description: flow_id parameter.
          required: true
    - name: api-v1-files-profile-pictures-list
      path: /api/v1/files/profile_pictures/list
      operations:
      - name: list-profile-pictures
        method: GET
        description: List Profile Pictures
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: api-v1-files-profile-pictures-folder-name-file-name
      path: /api/v1/files/profile_pictures/{folder_name}/{file_name}
      operations:
      - name: download-profile-picture
        method: GET
        description: Download Profile Picture
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: folder_name
          in: path
          type: string
          description: folder_name parameter.
          required: true
        - name: file_name
          in: path
          type: string
          description: file_name parameter.
          required: true
    - name: api-v1-files-upload-flow-id
      path: /api/v1/files/upload/{flow_id}
      operations:
      - name: upload-file
        method: POST
        description: Upload File
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: flow_id
          in: path
          type: string
          description: flow_id parameter.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-v2-files
      path: /api/v2/files
      operations:
      - name: delete-all-files
        method: DELETE
        description: Delete All Files
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: list-files
        method: GET
        description: List Files
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: upload-user-file
        method: POST
        description: Upload User File
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: append
          in: query
          type: boolean
          description: append parameter.
          required: false
        - name: ephemeral
          in: query
          type: boolean
          description: ephemeral parameter.
          required: false
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-v2-files
      path: /api/v2/files/
      operations:
      - name: delete-all-files
        method: DELETE
        description: Delete All Files
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: list-files
        method: GET
        description: List Files
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: upload-user-file
        method: POST
        description: Upload User File
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: append
          in: query
          type: boolean
          description: append parameter.
          required: false
        - name: ephemeral
          in: query
          type: boolean
          description: ephemeral parameter.
          required: false
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-v2-files-batch
      path: /api/v2/files/batch/
      operations:
      - name: delete-files-batch
        method: DELETE
        description: Delete Files Batch
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: download-files-batch
        method: POST
        description: Download Files Batch
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-v2-files-file-id
      path: /api/v2/files/{file_id}
      operations:
      - name: delete-file
        method: DELETE
        description: Delete File
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: file_id
          in: path
          type: string
          description: file_id parameter.
          required: true
      - name: download-file
        method: GET
        description: Download File
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: file_id
          in: path
          type: string
          description: file_id parameter.
          required: true
        - name: return_content
          in: query
          type: boolean
          description: return_content parameter.
          required: false
      - name: edit-file-name
        method: PUT
        description: Edit File Name
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: file_id
          in: path
          type: string
          description: file_id parameter.
          required: true
        - name: name
          in: query
          type: string
          description: name parameter.
          required: true
    authentication:
      type: apikey
      key: x-api-key
      value: '{{env.LANGFLOW_API_KEY}}'
      placement: header
  exposes:
  - type: rest
    namespace: files-rest
    port: 8080
    description: REST adapter for Langflow Files.
    resources:
    - path: /v1/api/v1/files/delete/{flow_id}/{file_name}
      name: api-v1-files-delete-flow-id-file-name
      description: REST surface for /api/v1/files/delete/{flow_id}/{file_name}.
      operations:
      - method: DELETE
        name: delete-file
        description: Delete File
        call: files.delete-file
        with:
          file_name: rest.file_name
          flow_id: rest.flow_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/files/download/{flow_id}/{file_name}
      name: api-v1-files-download-flow-id-file-name
      description: REST surface for /api/v1/files/download/{flow_id}/{file_name}.
      operations:
      - method: GET
        name: download-file
        description: Download File
        call: files.download-file
        with:
          file_name: rest.file_name
          flow_id: rest.flow_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/files/images/{flow_id}/{file_name}
      name: api-v1-files-images-flow-id-file-name
      description: REST surface for /api/v1/files/images/{flow_id}/{file_name}.
      operations:
      - method: GET
        name: download-image
        description: Download Image
        call: files.download-image
        with:
          file_name: rest.file_name
          flow_id: rest.flow_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/files/list/{flow_id}
      name: api-v1-files-list-flow-id
      description: REST surface for /api/v1/files/list/{flow_id}.
      operations:
      - method: GET
        name: list-files
        description: List Files
        call: files.list-files
        with:
          flow_id: rest.flow_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/files/profile_pictures/list
      name: api-v1-files-profile-pictures-list
      description: REST surface for /api/v1/files/profile_pictures/list.
      operations:
      - method: GET
        name: list-profile-pictures
        description: List Profile Pictures
        call: files.list-profile-pictures
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/files/profile_pictures/{folder_name}/{file_name}
      name: api-v1-files-profile-pictures-folder-name-file-name
      description: REST surface for /api/v1/files/profile_pictures/{folder_name}/{file_name}.
      operations:
      - method: GET
        name: download-profile-picture
        description: Download Profile Picture
        call: files.download-profile-picture
        with:
          folder_name: rest.folder_name
          file_name: rest.file_name
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/files/upload/{flow_id}
      name: api-v1-files-upload-flow-id
      description: REST surface for /api/v1/files/upload/{flow_id}.
      operations:
      - method: POST
        name: upload-file
        description: Upload File
        call: files.upload-file
        with:
          flow_id: rest.flow_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v2/files
      name: api-v2-files
      description: REST surface for /api/v2/files.
      operations:
      - method: DELETE
        name: delete-all-files
        description: Delete All Files
        call: files.delete-all-files
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: list-files
        description: List Files
        call: files.list-files
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: upload-user-file
        description: Upload User File
        call: files.upload-user-file
        with:
          append: rest.append
          ephemeral: rest.ephemeral
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v2/files/
      name: api-v2-files
      description: REST surface for /api/v2/files/.
      operations:
      - method: DELETE
        name: delete-all-files
        description: Delete All Files
        call: files.delete-all-files
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: list-files
        description: List Files
        call: files.list-files
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: upload-user-file
        description: Upload User File
        call: files.upload-user-file
        with:
          append: rest.append
          ephemeral: rest.ephemeral
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v2/files/batch/
      name: api-v2-files-batch
      description: REST surface for /api/v2/files/batch/.
      operations:
      - method: DELETE
        name: delete-files-batch
        description: Delete Files Batch
        call: files.delete-files-batch
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: download-files-batch
        description: Download Files Batch
        call: files.download-files-batch
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v2/files/{file_id}
      name: api-v2-files-file-id
      description: REST surface for /api/v2/files/{file_id}.
      operations:
      - method: DELETE
        name: delete-file
        description: Delete File
        call: files.delete-file
        with:
          file_id: rest.file_id
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: download-file
        description: Download File
        call: files.download-file
        with:
          file_id: rest.file_id
          return_content: rest.return_content
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: edit-file-name
        description: Edit File Name
        call: files.edit-file-name
        with:
          file_id: rest.file_id
          name: rest.name
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: files-mcp
    port: 9090
    transport: http
    description: MCP adapter for Langflow Files. One tool per consumed operation.
    tools:
    - name: langflow-delete-file
      description: Delete File
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: files.delete-file
      with:
        file_name: tools.file_name
        flow_id: tools.flow_id
      outputParameters:
      - type: object
        mapping: $.
    - name: langflow-download-file
      description: Download File
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: files.download-file
      with:
        file_name: tools.file_name
        flow_id: tools.flow_id
      outputParameters:
      - type: object
        mapping: $.
    - name: langflow-download-image
      description: Download Image
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: files.download-image
      with:
        file_name: tools.file_name
        flow_id: tools.flow_id
      outputParameters:
      - type: object
        mapping: $.
    - name: langflow-list-files
      description: List Files
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: files.list-files
      with:
        flow_id: tools.flow_id
      outputParameters:
      - type: object
        mapping: $.
    - name: langflow-list-profile-pictures
      description: List Profile Pictures
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: files.list-profile-pictures
      outputParameters:
      - type: object
        mapping: $.
    - name: langflow-download-profile-picture
      description: Download Profile Picture
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: files.download-profile-picture
      with:
        folder_name: tools.folder_name
        file_name: tools.file_name
      outputParameters:
      - type: object
        mapping: $.
    - name: langflow-upload-file
      description: Upload File
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: files.upload-file
      with:
        flow_id: tools.flow_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: langflow-delete-all-files
      description: Delete All Files
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: files.delete-all-files
      outputParameters:
      - type: object
        mapping: $.
    - name: langflow-list-files
      description: List Files
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: files.list-files
      outputParameters:
      - type: object
        mapping: $.
    - name: langflow-upload-user-file
      description: Upload User File
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: files.upload-user-file
      with:
        append: tools.append
        ephemeral: tools.ephemeral
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: langflow-delete-all-files
      description: Delete All Files
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: files.delete-all-files
      outputParameters:
      - type: object
        mapping: $.
    - name: langflow-list-files
      description: List Files
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: files.list-files
      outputParameters:
      - type: object
        mapping: $.
    - name: langflow-upload-user-file
      description: Upload User File
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: files.upload-user-file
      with:
        append: tools.append
        ephemeral: tools.ephemeral
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: langflow-delete-files-batch
      description: Delete Files Batch
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: files.delete-files-batch
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: langflow-download-files-batch
      description: Download Files Batch
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: files.download-files-batch
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: langflow-delete-file
      description: Delete File
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: files.delete-file
      with:
        file_id: tools.file_id
      outputParameters:
      - type: object
        mapping: $.
    - name: langflow-download-file
      description: Download File
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: files.download-file
      with:
        file_id: tools.file_id
        return_content: tools.return_content
      outputParameters:
      - type: object
        mapping: $.
    - name: langflow-edit-file-name
      description: Edit File Name
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: files.edit-file-name
      with:
        file_id: tools.file_id
        name: tools.name
      outputParameters:
      - type: object
        mapping: $.