Skip to main content

signaloid-cli files stat

Get file metadata without downloading.

Note: This command is an alias for signaloid-cli files get. Both command names work interchangeably.

Synopsis​

signaloid-cli files stat --path <path>
signaloid-cli files get --path <path>

Description​

Retrieve detailed metadata for a specific file without downloading its contents. This is useful for checking file size, type, and modification dates before performing operations.

Options​

OptionRequiredDescription
--path <path>YesFile path

Examples​

Get File Metadata​

signaloid-cli files stat --path datasets/data.csv

Output​

{
  "content_type": "text/csv",
  "etag": "\"3c41b0823f05cf86da0d560b0e033c03\"",
  "last_modified": 1736769600000,
  "size": 2048
}

Notes​

  • Returns file metadata: size, content type, etag, and last modification time
  • Does not download file contents, making it efficient for large files
  • Use this command to verify file existence before download operations
  • The command works on files only. For a directory, it reports that the file was not found and exits with code 4. Use signaloid-cli files ls for directories

Troubleshooting​

"File not found" Error​

If you receive a "File not found" error:

  1. Verify the path exists: 
    signaloid-cli files ls --path datasets/
  2. Check for typos in the file path
  3. Ensure proper path format (no leading slash)

See Also​

Last updated on