Method: users.environments.start

Starts an existing environment, allowing clients to connect to it. The returned operation will contain an instance of StartEnvironmentMetadata in its metadata field. Users can wait for the environment to start by polling this operation via operations.get. Once the environment has finished starting and is ready to accept connections, the operation will contain a StartEnvironmentResponse in its response field.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



Name of the resource that should be started, for example users/me/environments/default or users/

Request body

The request body contains data with the following structure:

JSON representation
  "accessToken": string,
  "publicKeys": [
      object (PublicKey)


The initial access token passed to the environment. If this is present and valid, the environment will be pre-authenticated with gcloud so that the user can run gcloud commands in Cloud Shell without having to log in. This code can be updated later by calling environments.authorize.


object (PublicKey)

Public keys that should be added to the environment before it is started.

Response body

If successful, the response body contains an instance of Operation.

Authorization Scopes

Requires the following OAuth scope:


For more information, see the Authentication Overview.