---
title: "Get Session Computer"
method: GET
path: "/api/chat/sessions/{session_id}/computer"
tags: ["v2", "chat", "chat"]
---

# Get Session Computer

`GET /api/chat/sessions/{session_id}/computer`

The computer behind this chat.

A plain chat has its own box; a chat that runs as a hired expert reports
the expert's persistent computer instead. Listing never wakes a paused box.

## Path parameters

- `session_id` string, required

## Response `200`

Successful Response

- ComputerInfo — The owner's computer: its one box, whether its screen is on, its volumes.
  - `owner_kind` 'session' | 'expert', required
  - `owner_id` string, required
  - `e2b_active` boolean, required
  - `box` SandboxSummary — The owner's box as E2B reports it, without waking it.
    - `sandbox_id` string, required
    - `state` 'running' | 'paused', required
    - `started_at` string, date-time, required
    - `cpu_count` integer, required
    - `memory_mb` integer, required
    - `template_id` string, required
    - `mounts_attached` boolean, required
  - `screen_on` boolean
  - `mounts` object
  - `workspace_path` string
  - `shared_path` string

## Other responses

- `401` — Authentication required
- `404` — Session not found or access denied
- `422` — Validation Error

## Changes

- **2026-09-16** `ac5f8c1a664a` — 2 warning, 2 info
  - removed the optional property `desktop` from the response with the `200` status
  - removed the optional property `shell` from the response with the `200` status
  - added the optional property `box` to the response with the `200` status
  - added the optional property `screen_on` to the response with the `200` status
- **2026-09-16** `31650764b5ef` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/changes/api/chat/sessions/:session_id/computer/get.md)

---

[API](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server.md) · [All operations](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/llms.txt) · [OpenAPI document](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/revisions/9a062c6d49b5?raw)