assets/Import

Import multiple assets

If the validate endpoint was called first, setting the ValidationIdentifier to match the one returned by validations will enable bypassing running the same validations when calling the endpoint so long as the following conditions are met:

  • The validation call was completed less than 1 hour before this endpoint called.
  • The list of asset types is unchanged
If either of the above conditions are not met, the full set of validators will rerun.
  1. 1New assets will be added and existing assets will be updated.
  2. 2 Asset cannot be mass deleted using this endpoint. To remove an asset, call the delete endpoint
  3. 3 All required asset attributes must be present and have a value compatible with the asset type's data type
  4. 4 All specified asset attributes must have a matching attribute template for the related asset type
  5. 5 The reference asset type must exist
  6. 5 Identifier must be unique, including deleted assets
  7. 5 If an id is specified, it must exist

Request Information

URI Parameters

None.

Body Parameters

ImportAssetsDto
NameDescriptionTypeAdditional information
assets

Collection of ImportAssetDto

Required

Max length: 1000

Min length: 1

validationIdentifier

Validation Identifier that was returned from a successful call to the validation endpoint

string

None.

Response Information

Standard Responses

Result containing list of id's and associated identifiers of imported assets

ResultOfAssetUpdateResponseDto[]

NameDescriptionTypeAdditional information
data

Collection of AssetUpdateResponseDto

None.

wasSuccessful

boolean

None.

errors

Collection of string

None.

Error Responses

HTTP Status CodeError MessageTypeAdditional Information
400 - BadRequest

ValidationErrorDto[]

None.