# ExternalLocation

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.ExternalLocation/

Struct for an external location specification.

- **Full name:** `MFiles.ExternalLocation`
- **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-id"></a>`id` | `int32` | 1 | External location ID. |
| <a id="f-description"></a>`description` | `string` | 2 | Description. |
| <a id="f-object_acl"></a>`object_acl` | [`AccessControlList`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.AccessControlList/index.md) | 3 | ACL for new documents. |
| <a id="f-object_type"></a>`object_type` | `int32` | 4 | Object type. |
| <a id="f-object_properties"></a>`object_properties` | repeated [`DefaultProperty`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.DefaultProperty/index.md) | 5 | The properties. |
| <a id="f-options"></a>`options` | [`EXTLOCFLAGS`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.EXTLOCFLAGS/index.md) | 6 | Flags. |
| <a id="f-update_interval"></a>`update_interval` | `uint32` | 7 | The delay between automatic monitoring rounds in seconds. |
| <a id="f-type"></a>`type` | [`ExtLocType`](https://developer.m-files.com/APIs/gRPC-API/Reference/Enums/MFiles.ExtLocType/index.md) | 8 | The type of the source. Values: `EXT_LOC_TYPE_NONE` (0), `EXT_LOC_TYPE_FILE_SOURCE` (1), `EXT_LOC_TYPE_MAIL_SOURCE` (2). |
| <a id="f-data"></a>`data` | [`ExtLocUnion`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.ExtLocUnion/index.md) | 9 | The type-specific data as a union. |
| <a id="f-aliases"></a>`aliases` | `string` | 10 | Semicolon-separated list of semantic aliases. |

<a id="used-by-methods"></a>

## Used by methods

- [IRPCExternalLocationsAdmin.AddExternalLocation](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCExternalLocationsAdmin/AddExternalLocation/index.md): Creates an external location.
- [IRPCExternalLocationsAdmin.GetExternalLocations](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCExternalLocationsAdmin/GetExternalLocations/index.md): Gets all external locations of the vault.
- [IRPCExternalLocationsAdmin.ImportFilesFromLinkedLocation](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCExternalLocationsAdmin/ImportFilesFromLinkedLocation/index.md): Converts a file source that links files into one that imports them, and starts importing.
- [IRPCExternalLocationsAdmin.ModifyExternalLocation](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCExternalLocationsAdmin/ModifyExternalLocation/index.md): Saves a changed external location.

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

## Used in fields

- [`AddExternalLocationRequest.json_ext_loc`](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCExternalLocationsAdmin/AddExternalLocation/index.md#request): The new location. `id` is ignored and assigned by the server.
- [`ModifyExternalLocationRequest.json_ext_loc`](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCExternalLocationsAdmin/ModifyExternalLocation/index.md#request): The complete new location; `id` identifies it.
- [`GetExternalLocationsResponse.json_ext_loc_array`](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCExternalLocationsAdmin/GetExternalLocations/index.md#response): One [ExternalLocation](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.ExternalLocation/index.md) per location.
- [`ImportFilesFromLinkedLocationResponse.json_ext_loc`](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCExternalLocationsAdmin/ImportFilesFromLinkedLocation/index.md#response): The location as saved, with linking and automatic monitoring off.