Update asset

put

https://example.com/beyondtrust/api/public/v3/assets/{id}

Updates an existing asset by ID.

Required Permission(s)

Asset Management (Full control)

Notes

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.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

int32

required

The unique identifier of the asset to update

Query Params

version

string

Defaults to 3.0

API version for asset model compatibility

Body Params

Updated asset configuration including modified properties

AssetName

string | null

Asset name. If not given, a padded IP address is used

AssetType

string | null

Asset type

DnsName

string | null

Asset DNS name

DomainName

string | null

Asset domain name

IPAddress

string | null

Asset IP address

OperatingSystem

string | null

Asset operating system

This property is ignored in Search requests

Description

string | null

Asset description. Only updated if version in the URL is 3.1 or greater

This property is ignored in Search requests

Headers

content-type

string

enum

Defaults to application/json

Generated from available request content types

Allowed:

Responses

200Request successful. Asset in response body

400Invalid asset configuration

401Not authenticated

403Insufficient permissions - requires Asset Management access

404Asset not found

409Asset name conflict within workgroup