--navigator-file

CLI: --navigator-file
REST: navigator_file

ValueNAME=SOURCE

LicensePro

Offers a file to the navigator for upload fields, by name. The navigator sees the name, never the path or the file’s contents. Repeatable.

Source	Read
a path, such as `resume=./resume.pdf`	at startup, and again at each attach
`name=data:<mime>;base64,…`	when the request is built
`name=https://host/file`	at the first attach, once per session

A URL fetch carries no cookies or page session. A failed fetch or a file whose bytes change between attaches causes an error. A server takes only data and http(s) URLs in navigator_file, and refuses the flag at startup.

Example

Run locally

zshot -f leads-enhanced.csv -t download \
  --navigator-type "anthropic://YOUR_API_KEY@" \
  --navigator-credential email=success@zshot-app.com \
  --navigator-credential password=password \
  --navigator-file leads=https://zshot-cli.com/example_assets/zrm/leads.csv \
  --navigate "Log in, open the Lead Enhancer, upload the leads file, enhance it, and download the enhanced CSV" \
  https://zshot-cli.com/example_assets/zrm/

{
  "url": "https://zshot-cli.com/example_assets/zrm/",
  "output_type": "download",
  "navigate": "Log in, open the Lead Enhancer, upload the leads file, enhance it, and download the enhanced CSV",
  "navigator_file": { "leads": "https://zshot-cli.com/example_assets/zrm/leads.csv" },
  "navigator_type": ["anthropic://YOUR_API_KEY@"],
  "navigator_credential": { "email": "success@zshot-app.com", "password": "password" }
}

curl -X POST http://127.0.0.1:3000/ \
  -H "Content-Type: application/json" \
  -d '{"url":"https://zshot-cli.com/example_assets/zrm/","output_type":"download","navigate":"Log in, open the Lead Enhancer, upload the leads file, enhance it, and download the enhanced CSV","navigator_file":{"leads":"https://zshot-cli.com/example_assets/zrm/leads.csv"},"navigator_type":["anthropic://YOUR_API_KEY@"],"navigator_credential":{"email":"success@zshot-app.com","password":"password"}}' \
  -o leads-enhanced.csv