---
title: "Issue a short-lived desktop stream ticket for the environment machine"
method: POST
path: "/api/v1/agent-environments/{environmentId}/desktop"
tags: ["Agent environments"]
---

# Issue a short-lived desktop stream ticket for the environment machine

`POST /api/v1/agent-environments/{environmentId}/desktop`

## Path parameters

- `environmentId` string, required

## Request body

- object
  - `mode` 'vnc' | 'webrtc'

## Response `200`

Successful response. Stable response schemas are documented in workflow guides when available.

- unknown

## Other responses

- `400` — Invalid request.
- `401` — Missing or invalid authentication.
- `500` — Unexpected server error.

## Changes

- **2026-09-20** `1c5ee54bc66b` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/layernorm/apis/overlay-web-api/changes/api/v1/agent-environments/:environmentId/desktop/post.md)

---

[API](https://skmtc.dev/layernorm/apis/overlay-web-api.md) · [All operations](https://skmtc.dev/layernorm/apis/overlay-web-api/llms.txt) · [OpenAPI document](https://skmtc.dev/layernorm/apis/overlay-web-api/revisions/723150bfdd74?raw)