## DeleteEnvironment

`client.Environments.Delete(ctx, body) (*EnvironmentDeleteResponse, error)`

**post** `/gitpod.v1.EnvironmentService/DeleteEnvironment`

Permanently deletes an environment.

Running environments are automatically stopped before deletion. If force
is true, the environment is deleted immediately without graceful shutdown.

### Examples

- Delete with graceful shutdown:

  Deletes an environment after gracefully stopping it.

  ```yaml
  environmentId: "07e03a28-65a5-4d98-b532-8ea67b188048"
  force: false
  ```

- Force delete:

  Immediately deletes an environment without waiting for graceful shutdown.

  ```yaml
  environmentId: "07e03a28-65a5-4d98-b532-8ea67b188048"
  force: true
  ```

### Parameters

- `body EnvironmentDeleteParams`

  - `EnvironmentID param.Field[string]`

    environment_id specifies the environment that is going to delete.

    +required

  - `Force param.Field[bool]`

    force indicates whether the environment should be deleted forcefully
    When force deleting an Environment, the Environment is removed immediately and
    environment lifecycle is not respected.
    Force deleting can result in data loss on the environment.

### Returns

- `type EnvironmentDeleteResponse interface{…}`

### Example

```go
package main

import (
  "context"
  "fmt"

  "github.com/gitpod-io/gitpod-sdk-go"
  "github.com/gitpod-io/gitpod-sdk-go/option"
)

func main() {
  client := gitpod.NewClient(
    option.WithBearerToken("My Bearer Token"),
  )
  environment, err := client.Environments.Delete(context.TODO(), gitpod.EnvironmentDeleteParams{
    EnvironmentID: gitpod.F("07e03a28-65a5-4d98-b532-8ea67b188048"),
  })
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", environment)
}
```

#### Response

```json
{}
```