# IRPCTest.TestConnectionToVault

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) > [Connection and health checks](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCTest/index.md)

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

Badges: `Vault API / standard` `write` `session` `idempotent`

Checks that the session is a valid vault session, and does nothing else.

- **Service:** [Connection and health checks](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCTest/index.md) `MFiles.IRPCTest`
- **gRPC method:** `/MFiles.IRPCTest/TestConnectionToVault`
- **HTTP (mf-http-grpc):** `POST /grpc/v1/test-connection-to-vault`
- **Request:** [`TestConnectionToVaultRequest`](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCTest/TestConnectionToVault/index.md#request)
- **Response:** [`TestConnectionToVaultResponse`](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCTest/TestConnectionToVault/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:** yes
- **Returns metadata structure version:** no
- **Streaming:** none (unary)

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

## Remarks

Send the session in `mfiles-session-id-bin`. The call succeeds with an empty response while the
session is valid. A missing, unknown or logged-out session fails with `UNAUTHENTICATED`.
A server-level session (opened with the all-zero vault GUID) fails with `E_MFILES_LOGIN_REQUIRED`
("Login required.").

This is the cheapest way to find out whether a session is still usable before a batch of work, and
to measure the round-trip time of authenticated vault calls. It does not reset the session's idle
timer: keep the session open with [KeepAlive](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCLogin/KeepAlive/index.md).

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

## Request: TestConnectionToVaultRequest

No fields.

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

## Response: TestConnectionToVaultResponse

No fields.

<a id="related"></a>

## Related methods

- [IRPCLogin.KeepAlive](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCLogin/KeepAlive/index.md): Tells the server that the session is still in use, so that it does not expire.