POST Workgroups/{workgroupName}/Assets

Purpose

Creates a new asset in the Workgroup referenced by name.

Required Permissions

Asset Management (Read/Write).

URL Parameters

workgroupName: Name of the Workgroup.

Request Body

Content-Type: application/json

{
    IPAddress: string,
    AssetName: string,
    DnsName: string,
    DomainName: string,
    MacAddress: string,
    AssetType: string,
    OperatingSystem: string
}

Request Body Details

• IPAddress: (required) Asset IP address. Max string length is 45.
• AssetName: (optional) Asset name. If not given, a padded IP address is used. Max string length is 128.
• DnsName: (optional) Asset DNS name. Max string length is 255.
• DomainName: (optional) Asset domain name. Max string length is 64.
• MacAddress: (optional) Asset MAC address. Max string length is 128.
• AssetType: (optional) Asset type. Max string length is 64.
• OperatingSystem: (optional) Asset operating system. Max string length is 255.

Response Body

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 Codes

201 - Request successful. Asset in response body.

For more information, please see Common Response Codes.