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.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

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

isNew

boolean

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

isRunning

boolean

Defaults to true

deprecated

Deprecated. Use isNew instead (inverted semantics).

Responses

400

Bad Request

403

Forbidden

409

Duplicate asset number

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

201Resource created