---
title: "Terminate an instance"
method: POST
path: "/instance-operations/terminate"
---

# Terminate an instance

`POST /instance-operations/terminate`

Terminates a given instance.

## Request body

- object
  - `instance_ids` InstanceId[], required — The unique identifiers (IDs) of the instances to terminate

## Response `200`

OK

- object
  - `data` object, required
    - `terminated_instances` Instance[], required — List of instances that were terminated. Note: this list might not contain all instances requested to be terminated.
      - `id` string, required — Unique identifier (ID) of an instance
      - `name` string, nullable — User-provided name for the instance
      - `ip` string, nullable — IPv4 address of the instance
      - `status` 'active' | 'booting' | 'unhealthy' | 'terminated', required — The current status of the instance
      - `ssh_key_names` SshKeyName[], required — Names of the SSH keys allowed to access the instance
      - `file_system_names` FileSystemName[], required — Names of the file systems, if any, attached to the instance
      - `region` Region
        - `name` string, required — Short name of a region
        - `description` string, required — Long name of a region
      - `instance_type` InstanceType — Hardware configuration and pricing of an instance type
        - `name` string, required — Name of an instance type
        - `description` string, required — Long name of the instance type
        - `price_cents_per_hour` integer, required — Price of the instance type, in US cents per hour
        - `specs` object, required
          - `vcpus` integer, required — Number of virtual CPUs
          - `memory_gib` integer, required — Amount of RAM, in gibibytes (GiB)
          - `storage_gib` integer, required — Amount of storage, in gibibytes (GiB).
      - `hostname` string, nullable — Hostname assigned to this instance, which resolves to the instance's IP.
      - `jupyter_token` string, nullable — Secret token used to log into the jupyter lab server hosted on the instance.
      - `jupyter_url` string, nullable — URL that opens a jupyter lab notebook on the instance.

## Other responses

- `400` — Request parameters were invalid.
- `401` — Unauthorized.
- `403` — Forbidden.
- `404` — Object does not exist.
- `500` — Something unexpected occurred.

---

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