# NamedValue

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

Struct for a named value stored in a vault.

- **Full name:** `MFiles.NamedValue`
- **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-key"></a>`key` | `string` | 1 | The name of the value. |
| <a id="f-value"></a>`value` | [`TypedValue`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.TypedValue/index.md) | 2 | The value as a serialized bytearray. |

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

## Used by methods

- [IRPCNamedValueStorage.GetNamedValues](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCNamedValueStorage/GetNamedValues/index.md): Gets all named values of one storage type and namespace.
- [IRPCNamedValueStorage.SetNamedValues](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCNamedValueStorage/SetNamedValues/index.md): Creates or replaces the given named values in one namespace, optionally only if the current values are as expected.
- [IRPCObjectOperations.GetFileDownloadUrl](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCObjectOperations/GetFileDownloadUrl/index.md): Not available over native gRPC: the server answers "Not implemented.". Used by the M-Files HTTP gateway.
- [IRPCSharedLinksPublic.DownloadSharedFile_Begin](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCSharedLinksPublic/DownloadSharedFile_Begin/index.md): Starts downloading the file of a shared link, without logging in, and returns a download ID, the file size and its MD5 checksum.
- [IRPCSharedLinksPublic.GetSharedLinkInfo](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCSharedLinksPublic/GetSharedLinkInfo/index.md): Gets the name, extension and size of the file that a shared link points to, without logging in.
- [IRPCSharedLinksPublic.UploadSharedFile](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCSharedLinksPublic/UploadSharedFile/index.md): Uploads a block of new content for a file opened for editing in Office for the web. Used by M-Files clients; applications rarely call it.
- [IRPCVaultExtensionMethods.ExecuteAnonymousExtensionMethod](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCVaultExtensionMethods/ExecuteAnonymousExtensionMethod/index.md): Passes an anonymous HTTP request, such as a webhook call, to a vault application. Used by the M-Files web server.

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

## Used in fields

- [`AuthDataClientUnion.PluginData.auth_data`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.AuthDataClientUnion/index.md#t-PluginData-auth_data): The plug-in's input as named values, for example the token from the identity provider. Non-empty values are encrypted when `data_format` says so.
- [`AuthDataServerUnion.PluginData.auth_data`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.AuthDataServerUnion/index.md#t-PluginData-auth_data): The plug-in's output as named values, to process before the next call.
- [`ExtensionAuthenticationResponse.data`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.ExtensionAuthenticationResponse/index.md#f-data): The credentials as named text values, as the authentication method expects them. For a user name and password, M-Files clients send `username` and `password`; for tokens, `Token` and `RefreshToken`.
- [`NamedValueArray.value`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.NamedValueArray/index.md#f-value): An array of the NamedValue structures.
- [`NamedValueNamespace.values`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.NamedValueNamespace/index.md#f-values): Named value array related to the namespace.
- [`GetNamedValuesResponse.values`](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCNamedValueStorage/GetNamedValues/index.md#response): The values of the namespace, sorted by key.
- [`SetNamedValuesRequest.values`](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCNamedValueStorage/SetNamedValues/index.md#request): The values to create or replace. Keys are at most 100 characters.
- [`SetNamedValuesRequest.required_existing_value`](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCNamedValueStorage/SetNamedValues/index.md#request): Optional. Values that must be current before the write, typically the values you read with [GetNamedValues](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCNamedValueStorage/GetNamedValues/index.md).
- [`GetFileDownloadUrlRequest.additional_data`](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCObjectOperations/GetFileDownloadUrl/index.md#request): An optional key-value pairs for additional data from the caller. Can be empty.
- [`DownloadSharedFile_BeginRequest.additional_data`](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCSharedLinksPublic/DownloadSharedFile_Begin/index.md#request): Optional named values; see [GetSharedLinkInfo](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCSharedLinksPublic/GetSharedLinkInfo/index.md).
- [`GetSharedLinkInfoRequest.additional_data`](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCSharedLinksPublic/GetSharedLinkInfo/index.md#request): Optional named values: `RECIPIENT_EMAIL`, `RECIPIENT_ACCESSCODE` and `ACCESS_SESSION` for links shared with named visitors, and `CLIENT_IP` for the event log.
- [`UploadSharedFileRequest.additional_data`](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCSharedLinksPublic/UploadSharedFile/index.md#request): Optional named values. Can be empty.
- [`ExecuteAnonymousExtensionMethodRequest.http_headers`](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCVaultExtensionMethods/ExecuteAnonymousExtensionMethod/index.md#request): The headers of the HTTP request.
- [`ExecuteAnonymousExtensionMethodResponse.response_http_headers`](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCVaultExtensionMethods/ExecuteAnonymousExtensionMethod/index.md#response): The headers to return in the HTTP response.