Create / Update Asset

Creating and updating an asset from the API can be done by posting your asset object to Supportbench.

The only difference between asset creations and updates is including an asset id within the asset object.

When creating or updating an asset, the below fields are available to you.

Name

Required

Limit

Default

Availability

Summary

id_prefix

no

5 characters

"A"

New

The prefix of the asset. You can assign new asset prefix's within the API administration section.

id_source

no

25 characters

New

The source id of the asset. You can assign custom ID's from existing systems or assign your own id.

id

no - when creating
yes - when updating

30 characters

Update

The full asset id including the prefix.

parent_id

no

30 characters

New / Update

The parent asset id to assign to this asset.

name

yes

50 characters

New / Update

The asset name.

version

no

10 characters

New / Update

The asset version.

description

no

250 characters

New / Update

The description of the asset.

active_on

no

DateTime

New / Update

The date the asset was or will be active on in UTC.

expires_on

no

DateTime

New / Update

The date the asset was or will be expired on in UTC.

active

no

Boolean

New / Update

Is the company active or not.

fields

no

See field object

New / Update

A field array of custom fields to insert or update. Please see the field object below.

Fields Object

Name

Required

Limit

Default

Summary

id

yes

Integer

The field id of the field you wish to update. The field id must map to a valid field in the asset.

value

yes

Dropdown list - Integer
Checkbox - Boolean
Text box - Unlimited

The value of the custom field. The value is dependent on the field type.

Language
Credentials