---
editLink: false
lastUpdated: false
---

[@salesforce/b2c-tooling-sdk](../../../modules.md) / [operations/mrt](../index.md) / waitForEnvironmentScapi

# Function: waitForEnvironmentScapi()

> **waitForEnvironmentScapi**(`conn`, `options`): `Promise`\<\{ `environment`: [`MrtEnvironmentView`](../interfaces/MrtEnvironmentView.md); `raw`: `unknown`; \}\>

Defined in: [packages/b2c-tooling-sdk/src/operations/mrt/env.ts:1257](https://github.com/SalesforceCommerceCloud/b2c-developer-tooling/blob/8fc17d8708d025c83fb0c44ca73198a200605153/packages/b2c-tooling-sdk/src/operations/mrt/env.ts#L1257)

Polls a SCAPI environment by ID until it reaches a terminal build status
(`ready` or `build_failed`) or the timeout elapses. Backs `mrt env clone
--wait` on the SCAPI backend, mirroring [waitForDeploymentScapi](waitForDeploymentScapi.md): a
by-ID poll shares the environments read scope, so it costs no extra scope.

## Parameters

### conn

[`ScapiMrtConnection`](../interfaces/ScapiMrtConnection.md)

### options

[`WaitForEnvironmentScapiOptions`](../interfaces/WaitForEnvironmentScapiOptions.md)

## Returns

`Promise`\<\{ `environment`: [`MrtEnvironmentView`](../interfaces/MrtEnvironmentView.md); `raw`: `unknown`; \}\>

## Throws

if the timeout is reached or the environment build fails.