# start_recording

Record the screens of one or more devices into .mp4 files on this Mac, one per device, on one clock. Returns the recording id and the folder the files go to (the installed Silan uses ~/Movies/Silan Recordings/<id>). Hides what screenshots hide; a frame it cannot check in time repeats the last checked frame, or is black when the device locked or showed something hidden in between. Stops by itself after max_seconds (default 600, at most 1800), at 500 MB, or when you let go of a device you held.

Record the screens of one or more devices into .mp4 files on this Mac, one per device, on one clock. Returns the recording id and the folder the files go to (the installed Silan uses ~/Movies/Silan Recordings/<id>). Hides what screenshots hide; a frame it cannot check in time repeats the last checked frame, or is black when the device locked or showed something hidden in between. Stops by itself after max_seconds (default 600, at most 1800), at 500 MB, or when you let go of a device you held.

| | |
|---|---|
| REST operation | [`startRecording`](/reference/rest/recordings/#startrecording) (`POST /v1/recordings`) |
| Needs a device | no |
| Read only | no |
| Profiles | `testing`, `full` |

## Parameters

| Name | Required | Type | Goes to | What it is |
|---|---|---|---|---|
| `device_ids` | yes | array of string | body `deviceIds` |  |
| `max_seconds` | no | integer | body `maxSeconds` |  |

## Example call

```text
start_recording({ device_ids: … })
```