Skip to main content

List Files

List all files uploaded to your OpenAI file storage with optional filtering by purpose.

Common Properties​

  • Name - The custom name of the node.
  • Color - The custom color of the node.
  • Delay Before (sec) - Waits in seconds before executing the node.
  • Delay After (sec) - Waits in seconds after executing node.
  • Continue On Error - Automation will continue regardless of any error. Default: false.
warning

This node requires your own OpenAI API key. It does NOT work with Robomotion AI Credits.

Inputs​

  • Connection Id - Connection identifier from Connect node (must use own API key).

Options​

  • Purpose Filter - Filter files by purpose:
    • All - Show all files (default)
    • Assistants - Only assistant files
    • Fine-tune - Only fine-tuning files
    • Batch - Only batch operation files
    • Vision - Only vision files

Outputs​

  • Files - Array of files with metadata (id, filename, bytes, created_at, purpose, etc.).

How It Works​

Retrieves the list of files from your OpenAI account:

  1. Validates connection uses own API key
  2. Optionally filters by purpose
  3. Retrieves file list from OpenAI
  4. Returns array of file objects

Usage Example​

Input:
- Purpose Filter: assistants

Output:
- Files: {
    data: [
      {
        id: "file-abc123",
        object: "file",
        bytes: 245632,
        created_at: 1234567890,
        filename: "knowledge_base.pdf",
        purpose: "assistants"
      },
      ...
    ]
  }

Use Cases​

  • File Management: View all uploaded files
  • Cleanup: Identify old files to delete
  • Audit: Track file usage and storage
  • Validation: Verify files were uploaded successfully

Tips​

  • Use Purpose Filter to focus on specific file types
  • Store file IDs from the list for later operations
  • Regularly clean up unused files to manage storage

Common Errors​

"List Files is not supported with Robomotion AI Credits"

  • Use your own OpenAI API key instead