Skip to main content
PUT
Swap (replace) the on-disk asset for an existing Upload

Path Parameters

fileId
string
required

The Upload _id to swap the asset for

Pattern: ^[0-9a-fA-F]{24}$

Body

file
file

The replacement asset (max 500 MB)

updateOriginalName
boolean
default:false

When true, rewrite the displayed originalname to the uploaded file's name. The on-disk filename and file_url always stay stable.

Response

Asset swapped successfully. Embeddings are preserved.

success
boolean
Example:

true

message
string
data
object

Updated Upload document