---
title: "Deletes an IDEEngine."
method: DELETE
path: "/v1/{name_7}"
tags: ["IDEEngineService"]
---

# Deletes an IDEEngine.

`DELETE /v1/{name_7}`

## Request

- Base URL: `https://docs.h2o.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.h2o.ai/v1/{name_7}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/h2o/apis/ai-h2o-engine-sandbox-v1-filesystem-proto/docs/v1/:name_7/delete.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `name_7` string, required

## Response `200`

A successful response.

- V1DeleteIDEEngineResponse: Response message for IDEEngineService.DeleteIDEEngine.
  - `ideEngine` V1IDEEngine: A browser IDE (code-server) running in a workspace. The image and the resources are fixed by the server in this version.
    - `name` string: Output only. The resource name of the IDEEngine. Format: `workspaces/*/ideEngines/*`.
    - `displayName` string: Optional. Human-readable name.
    - `state` 'STATE_UNSPECIFIED' | 'STATE_STARTING' | 'STATE_RUNNING' | 'STATE_PAUSING' | 'STATE_PAUSED' | 'STATE_FAILED' | 'STATE_DELETING' | 'STATE_TERMINATED': The state of the IDEEngine. - STATE_UNSPECIFIED: IDEEngine state is unspecified or unknown. - STATE_STARTING: IDEEngine is starting. - STATE_RUNNING: IDEEngine is running and can be used. - STATE_PAUSING: IDEEngine is pausing. - STATE_PAUSED: IDEEngine is paused. - STATE_FAILED: IDEEngine has failed. - STATE_DELETING: IDEEngine is being deleted. - STATE_TERMINATED: IDEEngine is terminated.
    - `reconciling` boolean: Output only. Indicates whether changes to the resource are in progress.
    - `uid` string: Output only. Globally unique identifier of the resource.
    - `creator` string: Output only. Name of entity that created the IDEEngine.
    - `createTime` string, date-time: Output only. Time when the IDEEngine was created.

## Other responses

- `default`: An unexpected error response.

---

[API](https://skmtc.dev/h2o/apis/ai-h2o-engine-sandbox-v1-filesystem-proto.md) - [All operations](https://skmtc.dev/h2o/apis/ai-h2o-engine-sandbox-v1-filesystem-proto/llms.txt) - [OpenAPI document](https://skmtc.dev/h2o/apis/ai-h2o-engine-sandbox-v1-filesystem-proto/revisions/297cfadc1d39?raw)