---
title: "Point a device at another device's shared playlist"
method: POST
path: "/api/devices/{device_id}/mirror"
tags: ["Devices"]
---

# Point a device at another device's shared playlist

`POST /api/devices/{device_id}/mirror`

## Request

- Base URL: `https://trmnl.com`
- URL: `https://trmnl.com/api/devices/{device_id}/mirror`
- Auth: HTTP bearer

Mirroring copies the master device's sharable playlist onto this device. The master must have visibility set to sharable.

## Path parameters

- `device_id` integer, required

## Request body

- object
  - `master_friendly_id` string, required: friendly_id of the sharable device to mirror

## Response `200`

Mirroring the master

## Other responses

- `400`: master_friendly_id is missing
- `401`: Unauthorized
- `404`: Device belongs to another user
- `422`: The friendly ID is not one this device can mirror

---

[API](https://skmtc.dev/trmnl/apis/trmnl-api.md) · [All operations](https://skmtc.dev/trmnl/apis/trmnl-api/llms.txt) · [OpenAPI document](https://skmtc.dev/trmnl/apis/trmnl-api/revisions/66179e6d663b?raw)