---
title: "Terminates a running environment"
method: DELETE
path: "/running/{owner}/environments/{environment}"
tags: ["running"]
---

# Terminates a running environment

`DELETE /running/{owner}/environments/{environment}`

## Path parameters

- `owner` string, required
- `environment` string, required

## Query parameters

- `force` boolean

## Response `202`

Runtime environment was terminated

- DispatchInfo
  - `launchedCapsuleReference` OwnedResourceReference
    - `owner` string
    - `name` string
    - `version` string
  - `launchingUser` string
  - `dispatchId` string
  - `state` 'UNKNOWN' | 'PENDING' | 'RUNNING' | 'TERMINATING' | 'MISSING' | 'TERMINATED' | 'COMPLETED' | 'FAILED'
  - `events` Event[]
    - `level` 'TRACE' | 'DEBUG' | 'INFO' | 'WARNING' | 'ERROR'
    - `timestamp` string
    - `reporter` string
    - `message` string
    - `extraInfo` object
    - `additionalProperties` object
  - `lastUpdated` string
  - `payloadStates` object
  - `additionalProperties` object

## Other responses

- `301` — The given environment has been terminated and can now be looked up elsewhere
- `403` — User does not have permission to terminate environments with the given owner
- `404` — The given environment does not exist or has already been terminated
- `500` — Could not terminate running environment

---

[API](https://skmtc.dev/determined-ai/apis/launcher-api.md) · [All operations](https://skmtc.dev/determined-ai/apis/launcher-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/determined-ai/launcher-api/revisions/33885ccfb9ac/schema)