# UploadedFile

Location: [gRPC API](https://developer.m-files.com/APIs/gRPC-API/index.md) > [Reference](https://developer.m-files.com/APIs/gRPC-API/Reference/index.md) > [Messages](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/index.md)

HTML version: https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.UploadedFile/

Information about an uploaded file.

- **Full name:** `MFiles.UploadedFile`
- **Proto file:** [`mfiles/structs.proto`](https://developer.m-files.com/APIs/gRPC-API/downloads/proto/mfiles/structs.proto)

<a id="fields"></a>

## Fields

| Field | Type | Number | Description |
|---|---|---|---|
| <a id="f-upload_id"></a>`upload_id` | `int32` | 1 | The upload session ID from UploadTempFile, committed with UploadTempFileCommit. Zero if `file_ref` is set. |
| <a id="f-title"></a>`title` | `string` | 2 | The title of the file. |
| <a id="f-extension"></a>`extension` | `string` | 3 | File extension, not including the dot (e.g. "doc"). |
| <a id="f-size"></a>`size` | `int64` | 4 | The logical size of the file in bytes. |
| <a id="f-file_ref"></a>`file_ref` | `string` | 5 | The `file_ref` of a stateless upload (FileUploadWhole or FileUploadEnd). Empty if `upload_id` is set. Exactly one of `upload_id` and `file_ref` must be set. |

<a id="used-in-fields"></a>

## Used in fields

- [`AutomaticMetadataRequest.uploaded_files`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.AutomaticMetadataRequest/index.md#f-uploaded_files): Files of stateless uploads (fileRef, title and extension) used like the upload session IDs. Only uploaded files with a file_ref are accepted.
- [`ObjFileSourceUnion.UploadedFilesData.uploaded_file_array`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.ObjFileSourceUnion/index.md#t-UploadedFilesData-uploaded_file_array)