PUT Assets/{id}

Purpose

Updates an existing asset by ID.

Call GET Assets/{id} (or equivalent) first to get the current state of the asset before calling PUT Assets/{id} to update it with new values.

Required Permissions

Asset Management (Read/Write).

URL Parameters

id: ID of the asset.

Request Body

Content-Type: application/json

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

Request Body Details

• WorkgroupID: (required) ID of the Workgroup to which the asset belongs.
• AssetName: (required) Asset name.
• DnsName: (required) Asset DNS name.
• DomainName: (required) Asset domain name.
• IPAddress: (required) Asset IP address.
• MacAddress: (required) Asset MAC address. An empty value is accepted and clears any existing value.
• AssetType: (required) Asset type. An empty value is accepted and clears any existing value.
• OperatingSystem: (required) Asset operating system. An empty value is accepted and clears any existing value.

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

200 - Request successful. Asset in response body.

For more information, please see Common Response Codes.