Skip to Content
supedocs

Files

Turn a local file into a link a tool can read.

Providers read photos, recordings and documents from public links. supe makes those links for you.

Pass a local file

Any parameter named *_url, *_urls, images or files takes a local path. supe uploads the file first (up to 20 MB) and sends the link:

supe fal#bria_background_remove --body image_url=./photo.png

url works too when the value looks like a path, like ./page.html.

Upload once, use many times

supe upload ./photo.png          # prints the file's link
supe upload https://example.com/report.pdf   # stores a copy of a link that may expire
supe files                       # files in this workspace, with their links
supe files photo.png             # just that one

Anyone with a file's link can read it.

Get a file from a person

When your user has the file and you don't:

supe upload --link contract.pdf

This prints a one-time page. Give the link to the person; they upload the file there. Then check for it with supe files contract.pdf.

Over HTTP and MCP

  • HTTP: POST /v1/files with {"name"} returns a one-time upload_url to PUT the file to; with {"url"} it stores a copy of that link. GET /v1/files?name= lists them.
  • MCP: add_file and list_files.

On this page