List uploaded files

List files currently uploaded for the authenticated Vee3 account.

← All Files endpoints · Capability overview

GET/v1/files/uploaded-files

https://api.vee3.io/v1/files/uploaded-files

0 tokens

List files currently uploaded for the authenticated Vee3 account.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

files.list_uploaded_files

Parameters1 field

folderstringOptional

Optional folder path (for example media/clips). When set, only files under that folder (including nested subfolders) are returned. Do not use '..' or absolute paths.

max length 200

Response7 fields

filesarrayitems

6 fields

Files currently stored for the authenticated account, newest first.

upload_idstring

Upload session identifier when Vee3 can match this file to a prior files.upload_file reservation.

file_namestring

Stored file name, including folders when used (for example media/clips/launch-video.mp4).

content_typestring

MIME type of the file.

size_bytesinteger

File size in bytes.

uploaded_atstring

ISO 8601 timestamp when the file was uploaded.

retained_untilstring

ISO 8601 timestamp when the file is scheduled to be removed. Present when Vee3 matched the file to a completed upload session.

HTTP errors: unauthorized, payment_required, validation_error

Example request

Python

import requests

url = "https://api.vee3.io/v1/files/uploaded-files"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "folder": "media/clips"
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Two uploaded files.

two_bucket_objects.json

{
  "files": [
    {
      "upload_id": "3edecf04-99d5-4d89-86b3-8dcdfc6452f5",
      "file_name": "launch-video.mp4",
      "content_type": "video/mp4",
      "size_bytes": 52428800,
      "uploaded_at": "2026-06-21T14:05:00Z",
      "retained_until": "2026-06-28T14:05:00Z"
    },
    {
      "file_name": "legacy-asset.png",
      "content_type": "image/png",
      "size_bytes": 2048,
      "uploaded_at": "2026-06-20T09:15:00Z"
    }
  ]
}