Workspace files

Some tools take a URL, not bytes: transcription, image-to-video, document extraction. Every workspace gets a private file system with 1 GB included, driven through the files provider like any other tool. The API only signs URLs; bytes move directly between you and storage.

Upload

# 1. ask for a signed upload URL
POST /v1/run {"provider":"files","endpoint":"/put","input":{"path":"audio/call.mp3"}}
→ { "output": { "upload_url": "https://…", "curl": "curl -X PUT --upload-file ./file \"https://…\"" } }

# 2. upload the bytes (no auth header needed, URL is pre-signed for 1 hour)
curl -X PUT --upload-file ./call.mp3 "<upload_url>"

Use it in another tool

POST /v1/run {"provider":"files","endpoint":"/cat","input":{"path":"audio/call.mp3","expires":3600}}
→ { "output": { "url": "https://…signed…" } }

POST /v1/run {"provider":"deepgram","endpoint":"/transcribe-url","input":{"url":"<that url>","summarize":true}}

Verbs

Endpoint	Does
`/put`	Signed upload URL for a path (upsert).
`/cat`	Signed download URL, 1 hour default, 7 days max.
`/ls`	List a folder with size and modified time.
`/mv`	Move or rename.
`/rm`	Delete.

Each verb costs $0.001. Files over 50 MB and workspaces over 1 GB need an enterprise plan.