Files

Replace file bytes (keep id, comments, share links)

Changed on

Same file id, same comments + share tokens + deep-link URL; new blobKey + new sha256 under the hood. The new bytes must be in the same MIME category as the previous version (image → image, video → video, etc.); cross-category swaps reject 400.

post/api/workspaces/{slug}/files/{fileId}/versions

Request

  • Base URL
    https://trydock.ai
  • Auth
    HTTP bearer

Path parameters

slugstring required
fileIdstring required

Request body multipart/form-data

filestring binary

Response

Updated file row

idstring required
namestring required
parentFolderIdstring nullable required
sizeinteger required

Bytes.

mimeTypestring required
thumbUrlstring nullable required

Server-generated 256-px webp URL. Null for non-raster files.

starredboolean
starredAtstring date-time nullable
descriptionstring nullable
tagsstring[]
exifobject nullable
createdAtstring date-time required
updatedAtstring date-time required

Example response

{
  "id": "cmpfile_…",
  "name": "hero.png",
  "mimeType": "image/png"
}

Changes