Skip to main content
POST
/
api
/
v1
/
file-vault
/
upload
Upload Files
curl --request POST \
  --url https://api.example.com/api/v1/file-vault/upload \
  --header 'Content-Type: application/json' \
  --data '
{
  "files": [
    null
  ],
  "folder_id": 123
}
'

Documentation Index

Fetch the complete documentation index at: https://docs.titletrackr.com/llms.txt

Use this file to discover all available pages before exploring further.

Upload one or more documents into the File Vault. Send the request as multipart/form-data.

​
Request

​
files
file[]
required
One or more files. Use repeated files[] parts for multiple uploads.
​
folder_id
integer
Target folder id. Omit to upload to the workspace root. Must be a folder in your workspace.

​
Example

curl -X POST https://api.titletrackr.com/api/v1/file-vault/upload \
  -H "Authorization: Bearer ttr_live_xxx" \
  -F "files[]=@deed.pdf" \
  -F "files[]=@survey.pdf" \
  -F "folder_id=42"

​
Partial failures

Files are validated individually. If some succeed and others fail (e.g. a PDF over the page limit), the response is still 201 with the successful files in files and per-file reasons in errors: 
{
  "success": true,
  "message": "Some files uploaded successfully, but 1 file(s) failed validation",
  "files": [ /* ... */ ],
  "errors": [
    { "filename": "huge.pdf", "error": "PDF exceeds 500 page limit" }
  ]
}