Skip to main content
Both calls are free and need a session that is still running. Uploads and downloads are removed when the session closes, so fetch what you need first.

Upload

POST /v1/browser/{session_id}/uploads puts a file in the session under name. Send the bytes as base64, or a url for Stophy to fetch.
The answer has name and size. A url must open the file without signing in, and Stophy waits up to 30 seconds. Without name, the last part of the address is used. To fill a file field, run Execute code that calls setInputFiles('notes.txt') on the file locator. A running session lists its uploads when you read it. A file is at most 20 MB, and a session takes at most 100 MB of uploads.

Download

GET /v1/browser/{session_id}/downloads lists the files, sorted by name.
The link needs no API key, so a browser or download tool can use it. It stops working after 15 minutes. Read the list again for a new one.

Errors

All return 400 invalidRequest unless noted.
  • A file over 20 MB.
  • Both base64 and url, or neither, or base64 with no name.
  • A url that does not answer with a success status. The message gives the status it got.
  • A session that has ended: 410 notFound on upload, and 409 invalidRequest on the download list.