Extend file retention

Extend how long a retained upload stays in storage.

← All Files endpoints · Capability overview

POST/v1/files/extend-file

https://api.vee3.io/v1/files/extend-file

0 tokens

Extend how long a retained upload stays in storage.

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.extend_file

Parameters2 fields

file_namestringRequired

Relative file name or path to extend. Use files.list_uploaded_files and choose a file that includes retained_until.

max length 255

additional_retention_daysintegerRequired

Days to add to the file's retention schedule.

min 1, max 90

Response5 fields

file_namestring

Extended file name.

retained_untilstring

ISO 8601 timestamp when the file is now scheduled to be removed.

additional_retention_daysinteger

Days added in this request.

token_costinteger

Tokens billed for this extension.

size_bytesinteger

File size in bytes used for billing.

HTTP errors: unauthorized, payment_required, validation_error, insufficient_tokens, uploaded_file_not_found

Example request

Python

import requests

url = "https://api.vee3.io/v1/files/extend-file"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
}
payload = {
    "file_name": "reports/q1-summary.pdf",
    "additional_retention_days": 7
}

response = requests.post(url, headers=headers, json=payload)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Retention extended with token cost.

extended.json

{
  "file_name": "reports/q1-summary.pdf",
  "retained_until": "2026-07-05T14:00:00Z",
  "additional_retention_days": 7,
  "token_cost": 4,
  "size_bytes": 1048576
}