---
title: "Update File Reference Entity"
slug: "update-file-reference-entity"
tags: ["file reference entity", "file storage"]
updated: 2025-12-01T21:39:54Z
published: 2025-12-01T21:39:54Z
canonical: "documentation.decisions.com/update-file-reference-entity"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.decisions.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update File Reference Entity

| Step Details |
| --- |
| **Introduced in Version** | 9.18 |
| **Last Modified in Version** | -- |
| **Location** | Process |

The **Update File Reference Entity** step enables Users to update a file for an existing **FileReferenceEntity**. Once a **FileReferenceEntity** is created, the associated file remains in FileStorage, even if the FileReferenceEntity has been deleted. This step enables the file to be updated (overwritten) whenever a User uploads a new version, ensuring that the latest file is always linked to the corresponding FileReferenceEntity and preventing unused files from cluttering storage.

#### Considerations

Users should refer to the following articles for more information on FileReferenceEntities and File Storage:

- [File Reference Entity](https://documentation.decisions.com/docs/file-reference-entity)
- [File Storage Structure](https://documentation.decisions.com/docs/file-storage)

---

## Properties

#### Inputs

| Property | Description | Data Type |
| --- | --- | --- |
| File Reference Entity Id | Allows Users to specify the File Reference Entity Id. | String |
| File to Update | Allows Users to specify the File that will be updated. | List of Byte |

#### Outputs

| Property | Description | Data Type |
| --- | --- | --- |
| File Reference Entity | This step outputs an updated File Reference Entity. | FileReferenceEntity |

---

## ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2025-12-01_14h54_01.png)

---

## Example Inputs and Outputs

```none
Inputs: 
FileToUpdate
FileReferenceEntityId
Outputs:
data: {
FileReferenceEntity: {
IsExternal
ExternalURL 
DocumentTypeID
FileReferenceId
ReferenceId
Size
EntityName
FileDateTime
FileReference: {
Id
FileName
Size
FileDateTime
}
Hidden
AdministratorViewOnly
EntityFolderID
HistoryFolderID
AllTagsData
EntityDescription
State
CreatedOnDate
ModifiedDate
CreatedBy
ModifiedBy
Archived
ArchivedBy
ArchivedDate
Deleted
DeletedBy
DeletedOn
```

#### ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2025-12-01_10h43_22.png)

---

## Step Changes

| Description | Version | Date | Developer Task |
| --- | --- | --- | --- |
| Added new step: Update FileReference Entity. | [9.18](https://documentation.decisions.com/v99/docs/en/2ebf7a4c-e925-4e8f-9fd4-ff94a14910cc?isPreview=true&versionNumber=1) | December 2025 | DT-046168 |