---
title: "AttachTerminalSession"
method: GET
path: "/v1/terminal-sessions/{id}/attach/"
tags: ["terminal-session"]
---

# AttachTerminalSession

`GET /v1/terminal-sessions/{id}/attach/`

## Request

- Base URL: `https://localhost:1618/api`
- URL: `https://localhost:1618/api/v1/terminal-sessions/{id}/attach/`
- Auth: API key in header `Authorization`

Upgrade to WebSocket and attach to a terminal session. Binary frames carry terminal bytes in both directions. Text frames carry JSON control messages. The client sends {"type":"resize","cols":N,"rows":N}. The server sends {"type":"ready"}, {"type":"exit"} or {"type":"error"}.

## Path parameters

- `id` string, required

## Other responses

- `101`: SwitchingProtocols

## Changes

- **2026-10-12** `1902a56749d0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/goinfinite/apis/osapi/changes/v1/terminal-sessions/:id/attach/get.md)

---

[API](https://skmtc.dev/goinfinite/apis/osapi.md) - [All operations](https://skmtc.dev/goinfinite/apis/osapi/llms.txt) - [OpenAPI document](https://skmtc.dev/goinfinite/apis/osapi/revisions/3147503ce764?raw)