API Reference

Create a new file

post
https://api.vcita.biz/v3/assets/files

Create a new file for the specified business. The API returns immediately with status='pending'. File processing (virus scan, S3 upload, thumbnail generation) happens asynchronously in the background.

If a duplicate file is detected via SHA-256 content hash, the existing file is returned immediately with status='uploaded'.

Rate limit: 10 uploads per user per 10 minutes. Maximum file size: 100MB.

Available for Staff and Client tokens.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
file
required

The file binary content to upload. Maximum size: 100MB.

string
length ≤ 255

Optional filename override. If not provided, the original filename from the uploaded file is used. Maximum length: 255 characters (e.g., "document.pdf", "photo.jpg").

metadata
object

Optional JSON object containing arbitrary key-value pairs for additional file metadata (e.g., {"source": "chat", "conversation_id": "conv_123"}).

Responses

Updated about 3 hours ago

Did this page help you?
Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 3 hours ago

Did this page help you?