Folders

Add files to a folder

Changed on

Adds up to 100 files to the folder. A file can be in several folders. Partial success: the response sorts every requested id into linked, already_linked or not_found (unknown or not owned by the caller), so one bad id does not lose the rest.

post/workspaces/{id}/files

Request

  • Base URL: https://api.varg.ai/v2
  • URL: https://api.varg.ai/v2/workspaces/{id}/files
  • Auth: HTTP bearer

Path parameters

idstring required

Folder id (uuid) or slug.

Request body

file_idsstring[] required

Example request

{
  "file_ids": [
    "file_abc123",
    "file_def456"
  ]
}

Response

Result per file id

linkedstring[] required

Files newly added to the folder.

already_linkedstring[] required

Files that were already in the folder.

not_foundstring[] required

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

Changes