---
title: "Start a device recording"
method: POST
path: "/devices/{deviceId}/recordings"
tags: ["Tools/Recordings"]
---

# Start a device recording

`POST /devices/{deviceId}/recordings`

## Path parameters

- `deviceId` string, required

## Request body

- StartInputBody
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `name` string
  - `retentionDays` integer
  - `types` string[], nullable

## Response `201`

Created

- RecordingInfo
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `actions` integer, required
  - `deviceId` string, required
  - `display` DisplayInfo, required
    - `height` integer, required
    - `rotation` integer, required
    - `width` integer, required
  - `endedAt` string, date-time
  - `error` string
  - `expiresAt` string, date-time, required
  - `id` string, required
  - `name` string, required
  - `startedAt` string, date-time, required
  - `status` string, required
  - `types` string[], nullable, required
  - `video` VideoInfo
    - `durationMs` integer, required
    - `format` string, required
    - `limitReason` string
    - `limited` boolean
    - `sizeBytes` integer, required

## Other responses

- `400` — Bad Request
- `409` — Conflict
- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

[API](https://skmtc.dev/droidrun/apis/droidrun-cloud.md) · [All operations](https://skmtc.dev/droidrun/apis/droidrun-cloud/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/droidrun/droidrun-cloud/revisions/a1453ac769d4/schema)