Image
Dot. Manual
Image
Dot. Manual
Back to home

Dot.

Install Dot. AppDiagnostic Tool

Quote

Quote/0New
Pairing Quote/0How to TapShare with Family and FriendsHow to Charge
Content Mode
Loop ContentFixed Content
TimingNewApp Clip and Tap-to-InteractNew
Screen States and Troubleshooting
Update DeviceReset NetworkReset DeviceChangelogNew
Service and RepairCustomize Quote/0

Rand

Rand/0New
Getting StartedNew
FeaturesNew
Book of AnswersFortuneMBTI GuideWooden FishCoin FlipBluetooth RemoteNewPomodoroNewClockTimerNewDice RollNumber Under TenDisplay ModeNewNFC Cards
Wi-FiCustom WallpaperSettingsHow to Charge
Update DeviceReset DeviceChangelogNew
Service and RepairCustomize Rand/0

Read

Read PicoNew
Getting StartedNew
CrossMuxNewPico ReaderNewRickyOSNew
Demo SystemDIY Your System

Content & Services

Roadmap
Content Studio
Join Content StudioRSS
Shortcuts
Co CreateNew
SoftwareNew
Quote
Rand
ReadNew
HardwareNew
Quote
Rand
ReadNew
Open PlatformNew
What is an APIDot SkillNewGet API KeyGet Device Serial NumberGet Device ListGet Device StatusGet TimezonesNewDevice SettingsNewSwitch to Next ContentList Device ContentControl Text ContentNewControl Image ContentNewControl Canvas ContentNew

Explore More Possibilities

Request New ContentJoin Content StudioOur Repositories

Security

MSA-2025-08-001MSA-2025-09-001MSA-2025-09-002MSA-2025-10-001MSA-2025-10-002MSA-2025-10-003MSA-2026-04-001MSA-2026-10-001MSA-2026-10-002MSA-2026-10-003
Responsible Disclosure Policy

More

Service StatusService and RepairCustomize ProductsPrivacy PolicyUser AgreementContact UsAbout MindReset
Content & ServicesOpen PlatformNew
Image

List Device Content

Retrieve the current content list of a device via API.

RSS

Quick Guide

Prerequisites

  1. Make sure you have retrieved and saved your API key in the Dot. App;
  2. Make sure you own at least one device and have obtained its device serial number;

The API rate limit is 10 requests per second. With the API, you can control device behavior and responses more flexibly.

Placeholders wrapped in ‘{{variable}}’ indicate values you must replace. Fill them with your actual values and remove the ‘{{}}’ braces.

Request Examples

GET
/api/authV2/open/device/:deviceId/:taskType/list

Get your API key from Dot. App

Generated Code
1// Generating...

Response Example

[
	{
		"type": "TEXT_API",
		"key": "text_task_1",
		"refreshNow": true,
		"title": "Hello",
		"message": "World"
	},
	{
		"type": "IMAGE_API",
		"key": "image_task_1",
		"refreshNow": true,
		"border": 0,
		"ditherType": "DIFFUSION",
		"ditherKernel": "FLOYD_STEINBERG"
	},
	{
		"type": "CANVAS_API",
		"key": "canvas_task_1",
		"border": 0,
		"link": "https://dot.mindreset.tech"
	}
]

Troubleshooting

Endpoint

/api/authV2/open/device/:deviceId/:taskType/list

Method

GET

Path Parameters

Prop

Type

Device serial number
Choose the loop list or fixed list to retrieve.

Request Schema

This interface does not require a request body, only an API key in the request header.

  • deviceId: device serial number
  • taskType: required; loop (loop list) or fixed (fixed list)

To update API content, use the returned key as taskKey and send the same taskType at the write request top level. For example, update an item from /fixed/list with taskType: "fixed". Omitting taskType in a write selects the loop list; the fixed list is not searched automatically.

Response Schema

The response is an array of content items.

  • type: content type (TEXT_API / IMAGE_API / CANVAS_API / GENERAL)
  • key: content identifier (can be null)
  • Other fields: the content input payload (varies by content type)

Prop

Type

Items in the selected content list.

Array Items

Identifies text, image, canvas, or other content.
Task identifier used to target this item when updating API content.
Immediate-display preference for loop content; ignored for fixed content.
Heading saved for text content, when present.
Main text, when present.
Signature below the main text, when present.
Icon displayed with text content, when present.
Destination opened by an NFC tap, when present.
Image saved for display, when present.
White or black screen border, when present.
How grayscale is converted to black and white, when present.
Algorithm used for error diffusion, when present.

Status Codes

codeMeaningDescription
200SuccessSuccessfully retrieved content list
401UnauthorizedInvalid or expired API key
500Server ErrorInternal server error

Did this solve your problem?

Join our community

Switch to Next Content

Previous

Control Text ContentNew

Next

Contents

Quick GuidePrerequisitesRequest ExamplesResponse ExampleTroubleshootingEndpointMethodPath ParametersRequest SchemaResponse SchemaStatus Codes