---
title: "Close a standalone shell terminal and destroy its PTY"
method: DELETE
path: "/api/v1/shell-terminals/{handleId}"
tags: ["shellTerminals"]
---

# Close a standalone shell terminal and destroy its PTY

`DELETE /api/v1/shell-terminals/{handleId}`

## Path parameters

- `handleId` string, required — Shell terminal runtime handle identifier.

## Response `204`

No Content

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `500` — Internal Server Error
- `501` — Not Implemented

## Changes

- **2026-07-22** `3520e924d706` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon/changes/api/v1/shell-terminals/:handleId/delete.md)

---

[API](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon.md) · [All operations](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/composiohq/agent-orchestrator-http-daemon/revisions/12e46c4f4b8e/schema)