post https://api.supportbench.com/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. |