Files

Files Bash makes, and files you hand it.

Send Authorization: Bearer vk_test_... on every call. Every route of Files.

GET/v1/files/{file_id}Details and a short-lived download link.

Your API key, or a session's token, scope runtime or all. On the card: files. Every call here is a checked sample.

Request1 field

Path

file_idstringrequiredThe file's id (file_...).

Type: string

Answers 20012 fields

idstringThe file (file_...): hand it to an ask as an attachment.

Example: file_2nq

object"file"Always file.

Type: "file"

user_idstring | nullYour id for its user; null on your company's own Bash.

Type: string | null

filenamestring | nullThe file's name; null when it has none.

Example: itinerary.pdf

mime_typestring | nullIts type, such as application/pdf; null when unknown.

Type: string | null

size_bytesinteger | nullIts size, in bytes; null when unknown.

Type: integer | null

source"upload" | "output"upload: a file you handed Bash. output: a file Bash made.

Type: "upload" | "output"

task_idstring | nullThe task it belongs to (task_...): the one that made it, or used it; null when none did.

Type: string | null

conversation_idstring | nullThe conversation of its task (conv_...); null for a file no task touched.

Type: string | null

created_atstringWhen it was made or uploaded, as an ISO 8601 time.

Type: string

download_urlstring (URL)A link to download it: good for 15 minutes, so read the file again for a fresh one.

Type: string (URL)

download_expires_atstringWhen the link stops working, as an ISO 8601 time.

Type: string

TypeScript

const file = await vestra.files.get('file_2kq');

Python

file = vestra.files.get("file_2kq")

CLI

vestra files get file_2kq

HTTP

# Upload a file. Send it for one user as multipart form data, with one part named file, up to 10 MB.curl "$VESTRA_BASE_URL/v1/files?user_id=traveller-42" \  -H "Authorization: Bearer $VESTRA_API_KEY" \  -F "file=@ticket.pdf" # Download what Bash made. List one conversation's files (its tasks' outputs), or one task's.curl "$VESTRA_BASE_URL/v1/files?conversation_id=conv_8f2k" \  -H "Authorization: Bearer $VESTRA_API_KEY" # Get one file. The response has a download link that works for a short while.curl "$VESTRA_BASE_URL/v1/files/file_2kq" \  -H "Authorization: Bearer $VESTRA_API_KEY"

MCP

{  "method": "tools/call",  "params": {    "name": "files",    "arguments": { "user": "traveller-42", "conversation": "conv_8f2k" }  }}