Patch /files/v3/files/{file Id} Update Properties

Update file properties

PATCH/files/v3/files/{fileId}

Use it in a workflow

Add a step and choose the HubSpot connector.
Pick the Patch /files/v3/files/{file Id} Update Properties action (under Files).
Fill in the fields below, then reference the result from later steps as {{patchFilesV3FilesFileIdUpdateProperties.response.data}}.

Request

Path parameters

fileIdstringrequired

ID of file to update

Request body

Enter the body as JSON in the step's Body field.

accessstring

NONE: Do not run any duplicate validation. REJECT: Reject the upload if a duplicate is found. RETURN_EXISTING: If a duplicate file is found, do not upload a new file and return the found duplicate instead.

One ofHIDDEN_INDEXABLEHIDDEN_NOT_INDEXABLEHIDDEN_PRIVATEHIDDEN_SENSITIVEPRIVATEPUBLIC_INDEXABLEPUBLIC_NOT_INDEXABLESENSITIVE

clearExpiresboolean

expiresAtstring (date-time)

isUsableInContentboolean

Mark whether the file should be used in new content or not.

namestring

New name for the file.

parentFolderIdstring

FolderId where the file should be moved to. folderId and folderPath parameters cannot be set at the same time.

parentFolderPathstring

Folder path where the file should be moved to. folderId and folderPath parameters cannot be set at the same time.

json

{
  "access": "HIDDEN_INDEXABLE",
  "clearExpires": false,
  "expiresAt": "2025-01-01T00:00:00Z",
  "isUsableInContent": false,
  "name": "string",
  "parentFolderId": "string",
  "parentFolderPath": "string"
}

Response

Returns 200 with an object. Read it in later steps with {{patchFilesV3FilesFileIdUpdateProperties.response.data.<field>}}.

accessstring

File access. Can be PUBLIC_INDEXABLE, PUBLIC_NOT_INDEXABLE, PRIVATE.

One ofHIDDEN_INDEXABLEHIDDEN_NOT_INDEXABLEHIDDEN_PRIVATEHIDDEN_SENSITIVEPRIVATEPUBLIC_INDEXABLEPUBLIC_NOT_INDEXABLESENSITIVE

archivedboolean

If the file is deleted.

archivedAtstring (date-time)

Deletion time of the file object.

createdAtstring (date-time)

Creation time of the file object.

defaultHostingUrlstring

Default hosting URL of the file. This will use one of HubSpot's provided URLs to serve the file.

encodingstring

Encoding of the file.

expiresAtinteger (int64)

extensionstring

Extension of the file. ex: .jpg, .png, .gif, .pdf, etc.

fileMd5string

The MD5 hash of the file.

heightinteger (int32)

For image and video files, the height of the content.

idstring

File ID.

isUsableInContentboolean

Previously "archied". Indicates if the file should be used when creating new content like web pages.

namestring

Name of the file.

parentFolderIdstring

ID of the folder the file is in.

pathstring

Path of the file in the file manager.

sizeinteger (int64)

Size of the file in bytes.

sourceGroupstring

One ofCONTENTCONVERSATIONSFORMSUI_EXTENSIONSUNKNOWN

typestring

Type of the file. Can be IMG, DOCUMENT, AUDIO, MOVIE, or OTHER.

updatedAtstring (date-time)

Timestamp of the latest update to the file.

urlstring

URL of the given file. This URL can change depending on the domain settings of the account. Will use the select file hosting domain.

widthinteger (int32)

For image and video files, the width of the content.

json

{
  "access": "HIDDEN_INDEXABLE",
  "archived": false,
  "createdAt": "2025-01-01T00:00:00Z",
  "id": "string",
  "updatedAt": "2025-01-01T00:00:00Z",
  "archivedAt": "2025-01-01T00:00:00Z",
  "defaultHostingUrl": "string",
  "encoding": "string",
  "expiresAt": 0,
  "extension": "string",
  "fileMd5": "string",
  "height": 0
}

Need more? See the HubSpot guide for connection setup and behaviour shared by every action.

Was this page helpful?