Все примеры ниже подразумевают заголовок X-API-Key из статьи API: обзор и авторизация. Права и роль указаны у каждого метода.
Список устройств
Возвращает устройства организации. Без параметров приходят устройства, привязанные к владельцу ключа; чтобы получить все устройства организации, добавьте scope=tenant - для этого ключ должен быть выпущен под роль «Техник» или «Администратор».
Запрос
GET /api/v1/devices
Право: чтение устройств.
Параметры
| Параметр | Тип | Описание |
|---|---|---|
scope | self или tenant | self - свои устройства (по умолчанию), tenant - все устройства организации |
Ответ
[
{
"id": "9f1c8e42-5b7a-4c3e-9d16-2f8a1b7c4e05",
"tenantId": "3a5d1e90-77bc-42fd-9a1c-6b2e8d4f0a13",
"userId": "c41b7f28-9e05-4a6d-8b13-7f2c5a9e1d64",
"activeUserId": null,
"pcdeskId": "987654321",
"name": "Ноутбук бухгалтерии",
"osPlatform": "windows",
"osVersion": "Windows 10 Pro - 19045",
"status": "ONLINE",
"lastSeenAt": "2026-08-27T09:14:22.418Z",
"enrolledAt": "2026-07-02T11:03:57.902Z",
"createdAt": "2026-07-02T11:03:57.902Z",
"updatedAt": "2026-08-27T09:14:22.418Z"
}
]
Секрет привязки устройства и его машинный идентификатор в ответ не попадают никогда.
Пример
curl -H "X-API-Key: ВАШ_КЛЮЧ" \
"https://pcdesk.ru/api/v1/devices?scope=tenant"
Регистрация устройства
Создаёт устройство или обновляет уже существующее с тем же идентификатором. Обычно регистрацию выполняет сам клиент PCDesk при первом запуске, метод нужен для сценариев автоматической инвентаризации.
Запрос
POST /api/v1/devices/register
Право: изменение устройств. Ответ: 201.
Тело
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
pcdeskId | строка | да | PCDesk ID устройства: от 6 до 15 цифр либо свой ID (буква, затем от 5 до 15 символов из букв, цифр, _ и -) |
machineUuid | строка | да | Постоянный идентификатор машины, от 8 до 128 символов |
name | строка | да | Понятное имя устройства для списка |
Пример
curl -X POST -H "X-API-Key: ВАШ_КЛЮЧ" \
-H "Content-Type: application/json" \
-d '{"pcdeskId":"987654321","machineUuid":"a1b2c3d4e5f6","name":"Ноутбук бухгалтерии"}' \
https://pcdesk.ru/api/v1/devices/register
Отметка активности
Обновляет время последнего обращения устройства - то, по которому в списке считается признак «в сети».
Запрос
PATCH /api/v1/devices/{id}/seen
Право: изменение устройств. В пути - внутренний идентификатор устройства из поля id, не PCDesk ID.
Переименование
Запрос
PATCH /api/v1/devices/{id}
Право: изменение устройств. Роль: техник или администратор.
Тело
{ "name": "Касса 3" }
Переименование попадает в журнал аудита вместе с тем, кто его выполнил.
Блокировка и разблокировка
Заблокированное устройство перестаёт принимать входящие подключения. Это самый быстрый способ отрезать доступ к машине уволенного сотрудника, не трогая учётные записи.
Запрос
POST /api/v1/devices/{id}/block
POST /api/v1/devices/{id}/unblock
Право: изменение устройств. Роль: техник или администратор.
Пример
curl -X POST -H "X-API-Key: ВАШ_КЛЮЧ" \
https://pcdesk.ru/api/v1/devices/9f1c8e42-5b7a-4c3e-9d16-2f8a1b7c4e05/block
Удаление
Снимает устройство с учёта в организации.
Запрос
DELETE /api/v1/devices/{id}
Право: изменение устройств. Роль: техник или администратор. Ответ: 204 без тела.
История подключений устройства при этом остаётся в журнале сессий - удаление устройства не стирает записи о том, что с ним делали.
Действующая политика устройства
Показывает, какие разрешения фактически применяются к устройству после наложения политик групп. Метод диагностический: им удобно проверять, почему на машине не работает передача файлов или буфер обмена.
Запрос
GET /api/v1/devices/{id}/effective-policy
Право: чтение устройств. Роль: техник или администратор.