Skip to main content
Update an asset.
External DocumentationTo learn more, visit the Device 42 documentation.

​
Basic Parameters

ParameterDescription
Back Connection TypeSelect the type of the back connection for the asset.
Device IDThe ID of the device to update on the asset.
Device IDsA comma-separated list of existing device IDs to attach to the asset.
Device NameThe name of the device.

Note: required in cases that switchport ID is not used.
NameThe name of the asset to update.
Service LevelThe service level of the asset.

Note: In Service, Spare, Not in Service are pre-defined options, you can also use custom ones.
TypeThe type of the asset.

​
Advanced Parameters

ParameterDescription
Asset NumberThe number of the asset.
Back Image IDThe ID of the back image file to update for the asset.
Back Image NameThe name of the back image file - use instead of Image File ID.
BuildingThe building name for the asset.
CustomerThe name of the customer of the asset.
DepthThe depth to set to the asset. Defaults to Half, insert full to override.
Image File IDThe ID of the image file to update for the asset.
Image File NameThe name of the image file - use instead of Image File ID.
In ServiceSet status of service for the asset.
LocationThe location of the asset.
Module HostThe name of the module host to update on the asset (must be unique).
Module Host IDThe ID of the module host to update on the asset.
New Object CategoryNew controlling access category. Use it to change category on a device if its already in use.
NotesThe notes to update on the asset.
Numbering Start FromThe number to start from for patch panel ports. Defaults to 1.
Object CategoryThe controlling access category of the asset. Can be in use in cases that multitenancy is on. For example: Prod_East.
OrientationThe orientation of the asset - set to Back if back facing, otherwise ignored.
Patch Panel ModelThe name of the patch panel model to update on the asset (use instead of ID).
Patch Panel Model IDThe ID of the patch panel model to update on the asset.
Patch Panel Module ModelThe name of the patch panel module model to update on the asset (use instead of ID).
Patch Panel Module Model IDThe ID of the patch panel module model to update on the asset.
RackName of existing rack to update the asset to.
Rack IDThe ID of the rack to update the asset to.
ReservedSelect whether the asset is reserved on the rack.
Serial NumberThe serial number of the asset.
SizeThe size to update on the asset. Required if updating asset in rack.
Slot NumberThe number of the slot on rack.
Start AtThe timestamp to update on the asset. Required if updating asset in rack.
Storage RoomThe name of the storage room.
Storage Room IDThe ID of the storage room of the asset.
TagsThe tags to update on the asset.
Tags RemoveA comma-seperated list of tags to remove.
Tap Module HostThe name of the tap module host.
Tap Module Host IDThe ID of the tap module host.
Tap Module ModelThe name of the tap module model.
Tap Module Model IDThe ID of the tap module model.
VendorThe name of the vendor of the asset.
WhereThe location in the rack.
Width RatioThe width ratio to set to the asset. Defaults to 1.
X PosThe position within the U slot in increments of 252. Valid range is 0-2520.

​
Example Output

{
	"msg": [
		[
			"asset added/edited.",
			54,
			"test_api",
			true,
			true
		]
	],
	"code": 0
}

​
Workflow Library Example

Update Asset with Device 42 and Send Results Via Email
Workflow LibraryPreview this Workflow on desktop
⌘I