List uploaded files

List files currently stored in the authenticated account's upload bucket prefix.

← All Meta tools endpoints · Capability overview

GET/v1/meta-tools/uploaded-files

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

0 tokens

List files currently stored in the authenticated account's upload bucket prefix.

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

meta-tools.list_uploaded_files

Parameters0 fields

Response6 fields

filesarrayitems

5 fields

Files currently stored for the authenticated account, newest first.

upload_idstring

Upload session identifier when Vee3 can match this bucket object to a prior meta-tools.upload_file reservation.

file_namestring

File name stored in the user's upload bucket prefix.

content_typestring

MIME type stored on the bucket object.

size_bytesinteger

Object size in bytes.

uploaded_atstring

ISO 8601 timestamp when the object was created in storage.

HTTP errors: unauthorized, payment_required

Example request

Python

import requests

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

}

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

Example responses1 example

200Two objects currently stored in the account upload prefix.

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"
    },
    {
      "file_name": "legacy-asset.png",
      "content_type": "image/png",
      "size_bytes": 2048,
      "uploaded_at": "2026-06-20T09:15:00Z"
    }
  ]
}