> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Create Asset
Create a new asset.
External Documentation
To learn more, visit the [Device 42 documentation](https://api.device42.com/#!/Assets/postAssets).
## Basic Parameters
| Parameter | Description |
| -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| Back Connection Type | Select the type of the back connection for the asset. |
| Name | The name of the asset. |
| Service Level | The service level of the asset.
**Note:** `In Service`, `Spare`, `Not in Service` are pre-defined options, you can also use custom ones. |
| Type | The type of the new asset. You can add new type using `Update Asset` action. |
## Advanced Parameters
| Parameter | Description |
| --------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| Asset Number | An asset number of a device to filter the results by. |
| Back Image ID | The ID of the back image file to add to the asset. |
| Back Image Name | The name of the back image file - use instead of `Image File ID`. |
| Building | The building name for the asset. |
| Customer | The name of the customer to filter the results by. |
| Depth | The depth to set to the asset. Defaults to `Half`, insert full to override. |
| Device ID | The ID of the device to add to the asset. |
| Device IDs | A comma-separated list of existing device IDs to attach to the asset. |
| Device Name | The name of the device.
**Note:** required in cases that `switchport ID` is not used. |
| Image File ID | The ID of the image file to add to the asset. |
| Image File Name | The name of the image file - use instead of `Image File ID`. |
| In Service | Select whether the asset is in service. |
| Location | The location of the asset. |
| Module Host | The name of the module host to add to the asset (must be unique). |
| Module Host ID | The ID of the module host to add to the asset. |
| New Object Category | New controlling access category. Use it to change category on a device if its already in use. |
| Notes | The notes to add to the created asset. |
| Numbering Start From | The number to start from for patch panel ports. Defaults to `1`. |
| Object Category | Controlling access category. Can be in use in cases that `multitenancy` is on. **For example:** `Prod_East`. |
| Orientation | The orientation of the asset - set to `Back` if back facing, otherwise ignored. |
| Patch Panel Model | The name of the patch panel model to add to the asset (use instead of ID). |
| Patch Panel Model ID | The ID of the patch panel model to add to the asset. |
| Patch Panel Module Model | The name of the patch panel module model to add to the asset (use instead of ID). |
| Patch Panel Module Model ID | The ID of the patch panel module model to add to the asset. |
| Rack | Name of an existing rack to add the asset to. |
| Rack ID | The ID of the rack to add the asset to. |
| Reserved | Select whether the asset is reserved on the rack. |
| Serial Number | Serial number of a device to filter the results by. |
| Size | The size to add to the asset. Required if adding asset to rack. |
| Slot Number | The number of the slot on rack. |
| Start At | The timestamp to add to the asset. Required if adding asset to rack. |
| Storage Room | The name of the storage room. |
| Storage Room ID | The ID of the storage room of the asset. |
| Tags | A comma-separated list of tags to filter results by (OR filter - return results that include at least one of the tags). |
| Tags Remove | A comma-separated list of tags to remove. |
| Tap Module Host | The name of the tap module host. |
| Tap Module Host ID | The ID of the tap module host. |
| Tap Module Model | The name of the tap module model. |
| Tap Module Model ID | The ID of the tap module model. |
| Vendor | The name of the vendor of the asset. |
| Where | The location in the rack. |
| Width Ratio | The width ratio to set to the asset. Defaults to `1`. |
| X Pos | The position within the U slot in increments of 252. Valid range is `0`-`2520`. |
## Example Output
```json theme={"dark"}
{
"msg": [
[
"asset added/edited.",
54,
"test_api",
true,
true
]
],
"code": 0
}
```
## Workflow Library Example
[Create Asset with Device 42 and Send Results Via Email](https://library.blinkops.com/workflows/create-asset-with-device-42-and-send-results-via-email)
Preview this Workflow on desktop