Skip to main content
Create a new 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.
NameThe name of the asset.
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 new asset. You can add new type using Update Asset action.

​
Advanced Parameters

ParameterDescription
Asset NumberAn asset number of a device to filter the results by.
Back Image IDThe ID of the back image file to add to 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 to filter the results by.
DepthThe depth to set to the asset. Defaults to Half, insert full to override.
Device IDThe ID of the device to add to 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.
Image File IDThe ID of the image file to add to the asset.
Image File NameThe name of the image file - use instead of Image File ID.
In ServiceSelect whether the asset is in service.
LocationThe location of the asset.
Module HostThe name of the module host to add to the asset (must be unique).
Module Host IDThe ID of the module host to add to the asset.
New Object CategoryNew controlling access category. Use it to change category on a device if its already in use.
NotesThe notes to add to the created asset.
Numbering Start FromThe number to start from for patch panel ports. Defaults to 1.
Object CategoryControlling access category. 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 add to the asset (use instead of ID).
Patch Panel Model IDThe ID of the patch panel model to add to the asset.
Patch Panel Module ModelThe name of the patch panel module model to add to the asset (use instead of ID).
Patch Panel Module Model IDThe ID of the patch panel module model to add to the asset.
RackName of an existing rack to add the asset to.
Rack IDThe ID of the rack to add the asset to.
ReservedSelect whether the asset is reserved on the rack.
Serial NumberSerial number of a device to filter the results by.
SizeThe size to add to the asset. Required if adding asset to rack.
Slot NumberThe number of the slot on rack.
Start AtThe timestamp to add to the asset. Required if adding asset to rack.
Storage RoomThe name of the storage room.
Storage Room IDThe ID of the storage room of the asset.
TagsA comma-separated list of tags to filter results by (OR filter - return results that include at least one of the tags).
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

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