Skip to main content
POST
Add files to a folder

Authorizations

Authorization
string
header
required

varg API key (varg_...). Get one at app.varg.ai or run bunx vargai login. App sessions may alternatively send a Supabase JWT.

Path Parameters

id
string
required

Folder id (uuid) or slug.

Body

application/json
file_ids
string[]
required
Required array length: 1 - 100 elements
Example:

Response

Result per file id

Partial success. Each requested file id lands in exactly one bucket.

linked
string[]
required

Files newly added to the folder.

already_linked
string[]
required

Files that were already in the folder.

not_found
string[]
required

Ids that do not exist or are not owned by the caller.