put
https://{example.com}/beyondtrust/api/public/v3/assets/
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.
Request body
AssetName,DnsName,DomainNameandIPAddressare all required, andIPAddressmust be a valid IP address. Omitting any of them fails with 400AssetNamehas no fallback on update. The padded-IP default described on that property applies when creating an Asset, not when updating oneWorkgroupIDis required, and it is applied - supplying a different Workgroup moves the Asset to it. It must be a Workgroup you have access to, otherwise the request fails with 404Descriptionis only applied from version 3.1. On version 3.0 it is ignored without error
API Versions
- Version 3.1 - Adds Description
- Version 3.0 - Base properties
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…