# IRPCNamedValueStorage.RemoveNamedValues

Location: [gRPC API](https://developer.m-files.com/APIs/gRPC-API/index.md) > [Vault API](https://developer.m-files.com/APIs/gRPC-API/vault/index.md) > [Named value storage](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCNamedValueStorage/index.md)

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

Badges: `Vault API / standard` `write` `session` `returns metadata structure version`

Removes named values from one namespace by key.

- **Service:** [Named value storage](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCNamedValueStorage/index.md) `MFiles.IRPCNamedValueStorage`
- **gRPC method:** `/MFiles.IRPCNamedValueStorage/RemoveNamedValues`
- **HTTP (mf-http-grpc):** `POST /grpc/v1/remove-named-values`
- **Request:** [`RemoveNamedValuesRequest`](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCNamedValueStorage/RemoveNamedValues/index.md#request)
- **Response:** [`RemoveNamedValuesResponse`](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCNamedValueStorage/RemoveNamedValues/index.md#response)
- **Book and level:** Vault API, standard
- **Kind:** write
- **Session:** Required: the session ID from LogIn in the mfiles-session-id-bin metadata.
- **Idempotent:** no
- **Returns metadata structure version:** yes (in the mfiles-metadata-version-bin trailer)
- **Streaming:** none (unary)

<a id="remarks"></a>

## Remarks

- Requires a vault session; the write rights depend on `storage_type` (see the service
  overview).
- Keys that do not exist are ignored; the call succeeds.
- With `NAMED_VALUE_TYPE_USER_SPECIFIC_VALUE` only the calling user's own values are removed.

<a id="request"></a>

## Request: RemoveNamedValuesRequest

> Nested message fields are expanded to depth 3; follow a type link for deeper levels and for the type's own page.

| Field | Type | Description |
|---|---|---|
| `storage_type` | [`NamedValueType`](https://developer.m-files.com/APIs/gRPC-API/Reference/Enums/MFiles.NamedValueType/index.md) | The storage type of the values. Values: `NAMED_VALUE_TYPE_UNINITIALIZED` (0), `NAMED_VALUE_TYPE_PROPERTY_AUTOMATIC_NUMBERING` (1), `NAMED_VALUE_TYPE_VAULT_SHARED_VARIABLE` (2), `NAMED_VALUE_TYPE_METADATA_CONFIGURATION_VALUE` (3), `NAMED_VALUE_TYPE_USER_CONFIGURATION_VALUE` (4), `NAMED_VALUE_TYPE_REGISTRY_VALUE` (5), `NAMED_VALUE_TYPE_FOLDER_CONFIGURATION_VALUE` (6), `NAMED_VALUE_TYPE_ADMIN_CONFIGURATION_VALUE` (7), `NAMED_VALUE_TYPE_SYSTEM_CONFIGURATION_VALUE` (8), `NAMED_VALUE_TYPE_USER_SPECIFIC_VALUE` (9). |
| `namespace_name` | `string` | The namespace of the values. |
| `keys[]` | repeated `string` | The keys of the values to remove. |

<a id="response"></a>

## Response: RemoveNamedValuesResponse

No fields.