post https://api.supportbench.com/asset/contact/link
Creating and updating an asset link from the API can be done by posting your asset link object to Supportbench.
The only difference between asset creations and updates is including an asset link id within the asset link object.
When creating or updating an asset, the below fields are available to you.
| Name | Required | Limit | Default | Availability | Summary |
|---|---|---|---|---|---|
| id | no - when creating yes - when updating | Integer | Update | This is the id of the linked asset. You can use this id to update an existing link to the contact. Leave this blank to create a new link. | |
| contact_id | yes - when creating | 30 characters | - | New / Update | The contact id that you would like to link the asset to. |
| asset_id | yes - when creating | 30 characters | - | Update | The full asset id including the prefix. |
| support_level_id | no | integer | - | New / Update | The support level id that this asset will have. |
| active_from | no | DateTime | - | New / Update | The date the asset was or will be active on in UTC. |
| active_to | no | DateTime | - | New / Update | The date the asset was or will be expired on in UTC. |
| 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. |