v51

latestOpenAPI 3.0.0raw.githubusercontent.com2026-07-2118931.2 KB
Files

Update a file

Updates file properties of a single file

put/Files/{FileId}

Path parameters

FileIdstring uuid required
Example:4ff1e5cc-9835-40d5-bb18-09fdb118db9c

File id for single object

Headers

Idempotency-Keystring

This allows you to safely retry requests without the risk of duplicate processing. 128 character max.

Request body

Namestring

File Name

MimeTypestring

MimeType of the file (image/png, image/jpeg, application/pdf, etc..)

Sizeinteger

Numeric value in bytes

CreatedDateUtcstring

Created date in UTC

UpdatedDateUtcstring

Updated date in UTC

Idstring uuid

File object's UUID

FolderIdstring uuid

Folder relation object's UUID

Example request

{
  "Name": "File2.jpg",
  "MimeType": "image/jpeg",
  "Size": 3615,
  "CreatedDateUtc": "2020-12-03T19:04:58.6970000",
  "UpdatedDateUtc": "2020-12-03T19:04:58.6970000",
  "User": {
    "Id": "4ff1e5cc-9835-40d5-bb18-09fdb118db9c",
    "Name": "john.smith@mail.com",
    "FirstName": "John",
    "LastName": "Smith",
    "FullName": "Smith"
  },
  "Id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "FolderId": "0f8ccf21-7267-4268-9167-a1e2c40c84c8"
}

Response

A successful request

Namestring

File Name

MimeTypestring

MimeType of the file (image/png, image/jpeg, application/pdf, etc..)

Sizeinteger

Numeric value in bytes

CreatedDateUtcstring

Created date in UTC

UpdatedDateUtcstring

Updated date in UTC

Idstring uuid

File object's UUID

FolderIdstring uuid

Folder relation object's UUID

Example response

{
  "Name": "File2.jpg",
  "MimeType": "image/jpeg",
  "Size": 3615,
  "CreatedDateUtc": "2020-12-03T19:04:58.6970000",
  "UpdatedDateUtc": "2020-12-03T19:04:58.6970000",
  "User": {
    "Id": "4ff1e5cc-9835-40d5-bb18-09fdb118db9c",
    "Name": "john.smith@mail.com",
    "FirstName": "John",
    "LastName": "Smith",
    "FullName": "Smith"
  },
  "Id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "FolderId": "0f8ccf21-7267-4268-9167-a1e2c40c84c8"
}