Skip to main content
GET
/
device-groups
List device groups
curl --request GET \
  --url https://api.beta.ontoto.com/device-groups \
  --header 'x-api-key: <api-key>'
{
  "grouped": [
    {
      "uuid": "d4e5f6a7-b8c9-40d1-e2f3-a4b5c6d7e8f9",
      "name": "Dam monitoring",
      "description": "Primary instruments",
      "sharedBy": null
    }
  ],
  "ungrouped": []
}

Documentation Index

Fetch the complete documentation index at: https://docs.beta.ontoto.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-api-key
string
header
required

Query Parameters

​
uuids
string[]

Filter by specific device group UUIDs

​
includeSensors
boolean

When true, include sensors on each device. Only applies when includeDevices=true.

​
includeDevices
boolean

When true, each group includes member devices in a devices array.

​
includeUngrouped
boolean

When true, include devices not assigned to any group in ungrouped. Only applies when includeDevices=true.

Response

Successful response

Response body for querying device groups.

​
grouped
object[]
required
​
ungrouped
object[]
required