GET
/
v1
/
tenant
/
asset-groups
List asset groups in a tenant
curl --request GET \
  --url https://{region}.api.plerion.com/v1/tenant/asset-groups \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "tenantId": "2422764d-dc5a-44eb-a0da-576baa2cfc22",
      "organizationId": "a4d83a9b-906f-4dc8-883b-fb43b7c1beb6",
      "assetGroupId": "3e508e7a-65b8-4787-9c7e-2b42c2b45565",
      "riskScore": null,
      "createdAt": "2025-01-07T13:37:23.388Z",
      "name": "Asset group name",
      "totalAssets": 7,
      "updatedAt": "2025-01-07T13:37:46.308Z",
      "status": "completed"
    }
  ],
  "meta": {
    "cursor": "k3d83a9b-k3dk-5lkd-2ldk-9kd77c1beb6",
    "total": 42
  }
}

Authorizations

​
Authorization
string
header
required

Bearer API Key. For example, "Bearer {Tenant API Key}"

Headers

​
Authorization
string
required

Bearer API Key. For example, "Bearer {Tenant API Key}"

​
Content-Type
string

application/json

Query Parameters

​
name
string

Filter asset groups by name

Example:

"k3d83a9b-k3dk-5lkd-2ldk-9kd77c1beb6"

​
cursor
string

Get the next batch of asset groups. Used for pagination

Example:

"k3d83a9b-k3dk-5lkd-2ldk-9kd77c1beb6"

​
perPage
number

Specify the batch size of the list. Used for pagination

Required range: x <= 1000
Example:

10

​
includeTotal
boolean

Include the total count of available asset groups

Example:

true

Response

200
application/json

Asset Groups list

The response is of type object.