---
title: "The desktop recordings in a sandbox, newest first."
method: GET
path: "/v1/sandboxes/{id}/desktop/recordings"
tags: ["desktop"]
---

# The desktop recordings in a sandbox, newest first.

`GET /v1/sandboxes/{id}/desktop/recordings`

## Request

- Base URL: `https://api.withruntime.com`
- URL: `https://api.withruntime.com/v1/sandboxes/{id}/desktop/recordings`
- Auth: HTTP bearer

## Path parameters

- `id` string, required: Resource identifier (UUID).

## Response `200`

Success

- object
  - `data` object[], required
    - `id` string, required
    - `state` 'starting' | 'installing' | 'recording' | 'finished' | 'failed', required
    - `path` string, required: The MP4 file in the sandbox.
    - `bytes` integer, required
    - `seconds` number
    - `reason` string, nullable: Why it ended: stopped, max-seconds, max-bytes, disk-low (the disk reached its 256 MiB reserve), desktop-gone, error.
    - `processId` string, nullable
    - `startedAt` integer, nullable

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/withruntime/apis/runtime-cloud-api.md) · [All operations](https://skmtc.dev/withruntime/apis/runtime-cloud-api/llms.txt) · [OpenAPI document](https://skmtc.dev/withruntime/apis/runtime-cloud-api/revisions/6f4012286988?raw)