---
title: "Start Session Desktop"
method: POST
path: "/api/chat/sessions/{session_id}/desktop"
tags: ["v2", "chat", "chat"]
---

# Start Session Desktop

`POST /api/chat/sessions/{session_id}/desktop`

Start or resume the desktop behind this chat and return its live stream.

Same box the ``start_desktop`` tool uses from inside a turn, so the side
panel and the model always look at one screen.

## Path parameters

- `session_id` string, required

## Response `200`

Successful Response

- DesktopStream
  - `kind` 'desktop_stream'
  - `url` string, required
  - `provider` 'e2b'
  - `sandbox_id` string, required
  - `requires_auth` boolean

## Other responses

- `401` — Authentication required
- `404` — Session not found or access denied
- `422` — Validation Error
- `502` — The desktop could not be started
- `503` — E2B is not configured

## Changes

- **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/desktop/post.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)