Update Asset
freshservice.update_asset
ActionBusiness appsconnection required
Calls the Freshservice API with the connection's credentials.
Change the attributes of an existing Freshservice asset.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- API key
- Providers
- Freshservice
- Secret shape
- the API key, or {"api_key": "…"}
- Config it needs
- domain, workspace_id
- Resolved by
- config.connection_id, else node.connection_id
Configuration
14 fields, 1 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
display_id The asset's display id — the number Freshservice shows on the asset and uses in its URL. | string | Yes | — | — | 11 |
name Display name of the asset. | string | No | — | — | MacBook Pro 16 - jdoe |
description Description of the asset. | string | No | — | — | — |
asset_tag Asset tag to assign; it must be unique in the account. | string | No | — | — | — |
impact Impact of the asset. | string | No | — | one of "low", "medium", "high" | — |
usage_type Usage type of the asset. | string | No | — | one of "permanent", "loaner" | — |
user_id Numeric id of the user the asset is used by. | string | No | — | — | — |
agent_id Numeric id of the agent the asset is managed by. | string | No | — | — | — |
group_id Numeric id of the agent group the asset is managed by. | string | No | — | — | — |
department_id Numeric id of the department the record belongs to. | string | No | — | — | — |
location_id Numeric id of the location the asset sits at. | string | No | — | — | — |
assigned_on When the asset was assigned, as a timestamp. | string | No | — | iso8601 format | — |
type_fields Asset-type-specific values as a JSON object; each key carries the asset type id as a suffix, such as serial_number_25. | object | No | — | — | — |
attributes Any other documented attribute for this record, as a JSON object merged into the request. | object | No | — | — | — |
- At least one of name, description, asset_tag, impact, usage_type, user_id, agent_id, group_id, department_id, location_id, assigned_on, type_fields, attributes must be set.
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"display_id": "11",
"name": "MacBook Pro 16 - jdoe"
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
id Internal id of the asset. | number | — |
display_id Display id — the number every asset endpoint addresses. | number | — |
name Display name of the asset. | string | — |
description Description of the asset. | string | — |
asset_type_id Id of the asset type this asset belongs to. | number | — |
asset_tag Asset tag assigned to the asset. | string | — |
impact Impact of the asset: low, medium or high. | string | — |
usage_type Usage type of the asset: permanent or loaner. | string | — |
user_id User id the asset is used by. | number | — |
agent_id Agent id the asset is managed by. | number | — |
group_id Agent group the asset is managed by. | number | — |
department_id Department the asset belongs to. | number | — |
location_id Location the asset sits at. | number | — |
assigned_on When the asset was assigned. | string | — |
type_fields Asset-type-specific values, when they were requested. | object | — |
created_at When the asset was created. | string | — |
updated_at When the asset was last updated. | string | — |
{
"agent_id": 0,
"asset_tag": "",
"asset_type_id": 0,
"assigned_on": "",
"created_at": "",
"department_id": 0,
"description": "",
"display_id": 0,
"group_id": 0,
"id": 0,
"impact": "",
"location_id": 0,
"name": "",
"type_fields": {},
"updated_at": "",
"usage_type": "",
"user_id": 0
}See Update Asset run in a workflow.
In a technical demo we add the Freshservice connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.