---
title: "PUT /workspaces/docker-cloud-instances/terminate"
method: PUT
path: "/workspaces/docker-cloud-instances/terminate"
tags: ["Workspaces - Providers - Cloud Instances"]
---

# PUT /workspaces/docker-cloud-instances/terminate

`PUT /workspaces/docker-cloud-instances/terminate`

## Request body

- DockerCloudInstance
  - `id` string
  - `name` string
  - `providerId` string
  - `regionName` string
  - `zone` DockerProviderZone
    - `name` string
  - `machineInstance` DockerMachineInstance
    - `name` string
    - `memAvailable` number, double
  - `instanceId` string
  - `created` string, date-time
  - `lastModified` string, date-time
  - `errorCount` integer
  - `batchId` string
  - `state` 'RUNNING' | 'TERMINATING', nullable

## Response `200`

OK

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `429` — Too Many Requests

## Changes

- **2026-09-03** `0dd39158a6ad` — 1 info
  - api operation id `D` removed and replaced with `c`
- **2026-09-02** `f1e5fc0d1899` — 1 info
  - api operation id `I` removed and replaced with `D`
- **2026-08-27** `5c632fc8774c` — 1 info
  - api operation id `b` removed and replaced with `I`
- **2026-08-26** `02a15fc32858` — 1 info
  - api operation id `w` removed and replaced with `b`
- **2026-07-27** `4b624af2cb6e` — 2 info
  - api operation id `v` removed and replaced with `w`
  - the request property `state` became nullable

[Change history](https://skmtc.dev/octoperf/apis/octoperf-api/changes/workspaces/docker-cloud-instances/terminate/put.md)

---

[API](https://skmtc.dev/octoperf/apis/octoperf-api.md) · [All operations](https://skmtc.dev/octoperf/apis/octoperf-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/octoperf/octoperf-api/revisions/0dd39158a6ad/schema)
