Create a new Asset

post

https://api.remberg.de/v2/assets

Creates a new asset with the provided properties. Returns the ID of the newly created asset. Responds with 409 if an asset with the same number already exists.

Body Params

assetNumber

string

required

The asset's number

assetTypeId

string

The asset type internal ID that this asset belongs to (Provide either this or the assetTypeLabel)

assetTypeLabel

string

The asset type label that this asset belongs to (Provide either this or the assetTypeId)

name

string

The asset's display name (if not specified the assetTypeLabel is used as display name)

parentAssetId

string

The internal ID of this asset's parent (Provide either this or the parentAssetNumber)

parentAssetNumber

string

The asset number of this asset's parent (Provide either this or the parentAssetId)

relatedOrganizationIds

array of strings

The internal IDs of the organizations that will be related to the asset (Provide either this or the relatedOrganizationNumbers).

relatedOrganizationIds

relatedOrganizationNumbers

array of strings

The numbers of the organizations that will be related to the asset (Provide either this or the relatedOrganizationIds).

relatedOrganizationNumbers

assignedPersonId

string

The internal ID of the person that will be assigned to the asset

responsibleUserGroupId

string

The internal ID of the user group that will be responsible for the asset (Provide either this or the responsibleUserGroupName)

responsibleUserGroupName

string

The name of the user group that will be responsible for the asset (Provide either this or the responsibleUserGroupId)

relatedContactIds

array of strings

The internal IDs of the contacts that will be related to the asset. The value provided will replace existing relations.

relatedContactIds

location

object

The asset's location

userGroupIds

array of strings

The internal IDs of the user groups that will be related to the asset (Provide either this or the userGroupNames). The value provided will replace existing relations.

userGroupIds

userGroupNames

array of strings

The names of the user groups that will be related to the asset (Provide either this or the userGroupIds). The value provided will replace existing relations.

userGroupNames

customPropertyValues

array of objects

customPropertyValues

criticality

string

enum

The asset’s criticality (default is Non-Critical)

Allowed:

installationDate

string

The asset’s installation date

isRunning

boolean

Determines the initial status of the created asset. If true, the asset will be created with status "running", otherwise with status "new".

Responses

400

Bad Request

403

Forbidden

409

Duplicate asset number

201Resource created