GET Workgroups/{workgroupName}/Assets

Purpose

Returns a list of assets by Workgroup name.

Required Permissions

Asset Management (Read).

URL Parameters

workgroupName: Name of the Workgroup.

Query Parameters (Optional)

  • limit: (default: 100000) Number of records to return.
  • offset: (default: 0) Number of records to skip before returning <limit> records (can only be used in conjunction with limit).

Request Body

None.

Response Body (when limit is not given)

Content-Type: application/json

[
    {
        WorkgroupID: int,
        AssetID: int,
        AssetName: string,
        DnsName: string,
        DomainName: string,
        IPAddress: string,
        MacAddress: string,
        AssetType: string,
        OperatingSystem: string,
        CreateDate: datetime,
        LastUpdateDate: datetime
    },
    …
]

Response Body (when limit is given)

Content-Type: application/json

{
    TotalCount : int,
    Data :
    [
        {
            WorkgroupID: int,
            AssetID: int,
            AssetName: string,
            DnsName: string,
            DomainName: string,
            IPAddress: string,
            MacAddress: string,
            AssetType: string,
            OperatingSystem: string,
            CreateDate: datetime,
            LastUpdateDate: datetime
        },
        …
    ]
}

Response Codes

200 - Request successful. Assets in response body.

For more information, please see Common Response Codes.