---
title: "Get Expert Computer"
method: GET
path: "/api/experts/{expert_id}/computer"
tags: ["v2", "experts", "experts", "private"]
---

# Get Expert Computer

`GET /api/experts/{expert_id}/computer`

The expert's own computer: its box as E2B lists it, and whether its
screen is on. E2B knows nothing about the screen; that flag is ours,
kept beside the box id, because asking the box would wake it.

Listing never wakes a paused box, so the Computer tab can refresh freely.

## Path parameters

- `expert_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` — Expert not found
- `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/experts/:expert_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)
