What Does the 'dir' Type Represent in File Handling and What Value needs to be Passed for it in syncDir Property?

[user-1]

This topic was automatically generated from Slack. You can find the original thread here.

Hi team, I require a small guidance.
While working on file handling, I noticed some properties like syncDir that use the type dir.
Reference (from GitHub):
pipedream/components/google_drive/actions/download-file/download-file.mjs at master · PipedreamHQ/pipedream · GitHub
I was curious about what this dir type actually represents and what value needs to be passed for it, since it’s not marked as optional.
I tried looking for documentation or examples but couldn’t find anything that clearly explains it — for instance:
Download File To Tmp with Helper Functions API on New Requests from HTTP / Webhook API - Pipedream
Any clarification or hint on this would be really helpful.

[user-1]

That dir prop is internal and used for the File Stash feature here: Working With Files - Pipedream

[user-1]

I need some guidance on analyzing file downloads in Pipedream.

1. I tried using Dropbox download to /tmp, but it doesn’t seem to work. Even though I have files in my Dropbox, the path shows empty. Demo link I used:
2. Dropbox Download to TMP Demo
3. I also tried Google Drive download. Although it’s not visible in the demo UI, I found the component in the GitHub repo:
4. Google Drive Download File
   ◦ I was able to fetch components and call it via API.
   ◦ SS3: Shows it works without a stash_id (I later uncommented and verified).
   ◦ SS4: When I pass a stash_id, it fails and shows it’s not available to run. Something seems off here.
   Could you suggest which action or approach would work best for analyzing file downloads reliably?
   google Drive download will work without stash perfectly as SS3 abut not be work if i pass stashId SS4

[user-1]

,

How about building a Pipedream workflow, in that workflow, you can download to tmp dir and has a code step to analyze that file in tmp dir.

Then you can execute that workflow (instead of execute the action individually)

[user-1]

You were right — Dropbox Download to /tmp works perfectly in a Pipedream workflow.

[ just need to pass the query, then it shown the options ]
i was wrong, sorry for inconvenience

[user-1]

Info update
seem like
In Pipedream, features like stashing files or using S3 storage via stash_id are limited to paid/Pro workspaces.

File Stores - Pipedream

which i was miss
hence i may got

[user-1]

Posted thread to Discourse: What Does the 'dir' Type Represent in File Handling and What Value Needs to be Passed for It?

[user-1]

I need clarification on when exactly the stash_id should be passed. Is there any indication or hint for this based on the component’s props?
My use case is to display the S3 URL of a file. I plan to use stash_id for this, but I understand it’s recommended to use it only when necessary, since it can increase processing time.
I also noticed that many actions involving file handling include a prop called SyncDir with the type "dir". Could someone have idea what this is used for? can i use for my case
Please let me know if I’m missing something.

[user-1]

Perfect — I’ll use that to detect if I should pass stash_id or skip it. Thanks, and sorry for the interruption!
Link: What is Expected Input for `dir` Type in `/run` Endpoint According to Given Schema? - #3 by user-1