---
title: "Collect monitors relations (replaced by POST /v1/role/{roleId}/monitors/query)"
method: GET
path: "/v1/role/{roleId}/monitors"
tags: ["Monitors"]
deprecated: true
---

# Collect monitors relations (replaced by POST /v1/role/{roleId}/monitors/query)

`GET /v1/role/{roleId}/monitors`

> **Deprecated.**

Get the monitors relations which start from roles of which the user is a member and which are in the specified list of role ids. The POST /v1/role/{roleId}/monitors/query is a preferable alternative which can better handle complex filters.

## Path parameters

- `roleId` union, required
  - integer
  - integer[]
  - '*'

## Query parameters

- `id` integer[]
- `deviceId` integer[]

## Response `200`

The monitors relations which start from roles of which the user is a member and which match all the specified filters

- object
  - `monitors` Def32[]
    - `id` integer, required — Id of the monitors relation
    - `roleId` integer, required — Id of the role which monitors a device via the monitors relation
    - `deviceId` integer, required — Id of the device which is monitored via the monitors relation
    - `monitorManagement` boolean, required — Indicates whether the role has the right to create new monitors relations to the monitored device. If true, the role may read and edit any device property.
    - `reads` string[], required — A list of device properties which may be read by the role monitoring the device
    - `edits` string[], required — A list of device properties which may be both read and edited by the role monitoring the device

## Other responses

- `400` — Invalidly formatted query parameters
- `401` — Authentication required or token invalid

---

[API](https://skmtc.dev/eniris/apis/eniris-metadata-telemetry-query-api.md) · [All operations](https://skmtc.dev/eniris/apis/eniris-metadata-telemetry-query-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/eniris/eniris-metadata-telemetry-query-api/revisions/fe3723575e19/schema)