# IRPCIdentityOperations.RequestIdentityPoolTopUp

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) > [Identities](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCIdentityOperations/index.md)

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

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

Asks the vault to replenish the ID ranges that an M-Files cloud service holds for it. Used by
M-Files cloud services only.

- **Service:** [Identities](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCIdentityOperations/index.md) `MFiles.IRPCIdentityOperations`
- **gRPC method:** `/MFiles.IRPCIdentityOperations/RequestIdentityPoolTopUp`
- **HTTP (mf-http-grpc):** `POST /grpc/v1/request-identity-pool-top-up`
- **Request:** [`RequestIdentityPoolTopUpRequest`](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCIdentityOperations/RequestIdentityPoolTopUp/index.md#request)
- **Response:** [`RequestIdentityPoolTopUpResponse`](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCIdentityOperations/RequestIdentityPoolTopUp/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

- Returns at once; the vault does the work in the background. Repeated requests are combined,
  so the call is safe to retry.
- Requires a vault session with full control of the vault, and the session's account must be
  a technical login account of an M-Files cloud service. Other accounts, including vault
  administrators, get "Access denied.".
- Fails with "Not implemented." on servers and vaults where the feature is not available.

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

## Request: RequestIdentityPoolTopUpRequest

No fields.

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

## Response: RequestIdentityPoolTopUpResponse

No fields.