Skip to main content

Retrieve File Metadata

Retrieve metadata about a specific file in OpenAI file storage without downloading the file content.

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.
  • File ID - OpenAI file ID to retrieve information for.

Outputs​

  • File Object - File metadata (name, size, purpose, created date) - does not include file content.

How It Works​

Retrieves metadata for a specific file:

  1. Validates connection and file ID
  2. Requests file metadata from OpenAI
  3. Returns file information object

Usage Example​

Input:
- File ID: "file-abc123"

Output:
- File Object: {
    id: "file-abc123",
    object: "file",
    bytes: 245632,
    created_at: 1234567890,
    filename: "knowledge_base.pdf",
    purpose: "assistants"
  }

Use Cases​

  • File Verification: Check if a file exists before using it
  • Metadata Retrieval: Get file details without downloading
  • Size Checking: Verify file size before processing

Tips​

  • Use this instead of Download File when you only need metadata
  • Faster than downloading the full file

Common Errors​

"File ID cannot be empty"

  • Provide a valid file identifier from Upload File or List Files