---
title: "POST /v1/{+name}:start"
method: POST
path: "/v1/{+name}:start"
tags: ["users"]
---

# POST /v1/{+name}:start

`POST /v1/{+name}: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 GetOperation. Once the environment has finished starting and is ready to accept connections, the operation will contain a StartEnvironmentResponse in its response field.

## Path parameters

- `name` string, required

## Request body

- StartEnvironmentRequest — Request message for StartEnvironment.
  - `accessToken` string — 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 AuthorizeEnvironment.
  - `publicKeys` string[] — Public keys that should be added to the environment before it is started.

## Response `200`

Successful response

---

[API](https://skmtc.dev/google/apis/cloudshell.md) · [All operations](https://skmtc.dev/google/apis/cloudshell/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/cloudshell/revisions/4fa0d8d99f5e/schema)