freshservice-assets

Freshservice Assets — manage IT assets, asset types, components, and relationships

Server path: /freshservice-assets | Type: Application | PCID required: Yes

Tools

Tool	Description
freshservice_assets_create_asset	Create an Asset
freshservice_assets_create_asset_component	Create a Component
freshservice_assets_create_asset_type	Create an Asset Type
freshservice_assets_delete_asset	Delete an Asset (trash)
freshservice_assets_delete_asset_type	Delete an Asset Type
freshservice_assets_get_asset	View an Asset
freshservice_assets_get_asset_type	View an Asset Type
freshservice_assets_list_asset_components	List Asset Components
freshservice_assets_list_asset_contracts	List Asset Associated Contracts
freshservice_assets_list_asset_relationships	List Asset Relationships
freshservice_assets_list_asset_requests	List Asset Associated Requests
freshservice_assets_list_asset_type_fields	List Fields of an Asset Type
freshservice_assets_list_asset_types	List All Asset Types
freshservice_assets_list_assets	List All Assets
freshservice_assets_restore_asset	Restore a Trashed Asset
freshservice_assets_update_asset	Update an Asset
freshservice_assets_update_asset_type	Update an Asset Type

---

freshservice_assets_create_asset

Create an Asset

Parameters:

Parameter	Type	Required	Default	Description
agent_id	integer	No	—	Managed By agent ID
asset_tag	string	No	—	Asset tag
asset_type_id	integer	Yes	—	Asset type ID
assigned_on	string	No	—	Assignment date
custom_fields	object	No	—	Custom fields
department_id	integer	No	—	Department ID
description	string	No	—	The description value
group_id	integer	No	—	Managed By group ID
impact	string	No	—	low, medium, high
location_id	integer	No	—	Location ID
name	string	Yes	—	Asset name
type_fields	object	No	—	Type-specific fields
usage_type	string	No	—	permanent, loaner
user_id	integer	No	—	Used By user ID

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "agent_id": {
      "type": "integer",
      "description": "Managed By agent ID"
    },
    "asset_tag": {
      "type": "string",
      "description": "Asset tag"
    },
    "asset_type_id": {
      "type": "integer",
      "description": "Asset type ID"
    },
    "assigned_on": {
      "type": "string",
      "description": "Assignment date"
    },
    "custom_fields": {
      "type": "object",
      "description": "Custom fields"
    },
    "department_id": {
      "type": "integer",
      "description": "Department ID"
    },
    "description": {
      "type": "string",
      "description": "The description value"
    },
    "group_id": {
      "type": "integer",
      "description": "Managed By group ID"
    },
    "impact": {
      "type": "string",
      "description": "low, medium, high"
    },
    "location_id": {
      "type": "integer",
      "description": "Location ID"
    },
    "name": {
      "type": "string",
      "description": "Asset name"
    },
    "type_fields": {
      "type": "object",
      "description": "Type-specific fields"
    },
    "usage_type": {
      "type": "string",
      "description": "permanent, loaner"
    },
    "user_id": {
      "type": "integer",
      "description": "Used By user ID"
    }
  },
  "required": [
    "PCID",
    "asset_type_id",
    "name"
  ]
}

---

freshservice_assets_create_asset_component

Create a Component

Parameters:

Parameter	Type	Required	Default	Description
asset_display_id	integer	Yes	—	Asset display ID
component_data	object	No	—	Component data
component_type	string	No	—	Component type

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "asset_display_id": {
      "type": "integer",
      "description": "Asset display ID"
    },
    "component_data": {
      "type": "object",
      "description": "Component data"
    },
    "component_type": {
      "type": "string",
      "description": "Component type"
    }
  },
  "required": [
    "PCID",
    "asset_display_id"
  ]
}

---

freshservice_assets_create_asset_type

Create an Asset Type

Parameters:

Parameter	Type	Required	Default	Description
description	string	No	—	The description value
name	string	Yes	—	The name value
parent_asset_type_id	integer	No	—	Parent asset type ID

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "description": {
      "type": "string",
      "description": "The description value"
    },
    "name": {
      "type": "string",
      "description": "The name value"
    },
    "parent_asset_type_id": {
      "type": "integer",
      "description": "Parent asset type ID"
    }
  },
  "required": [
    "PCID",
    "name"
  ]
}

---

freshservice_assets_delete_asset

Delete an Asset (trash)

Parameters:

Parameter	Type	Required	Default	Description
asset_display_id	integer	Yes	—	Asset display ID

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "asset_display_id": {
      "type": "integer",
      "description": "Asset display ID"
    }
  },
  "required": [
    "PCID",
    "asset_display_id"
  ]
}

---

freshservice_assets_delete_asset_type

Delete an Asset Type

Parameters:

Parameter	Type	Required	Default	Description
asset_type_id	integer	Yes	—	Asset Type ID

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "asset_type_id": {
      "type": "integer",
      "description": "Asset Type ID"
    }
  },
  "required": [
    "PCID",
    "asset_type_id"
  ]
}

---

freshservice_assets_get_asset

View an Asset

Parameters:

Parameter	Type	Required	Default	Description
asset_display_id	integer	Yes	—	Asset display ID
include	string	No	—	Include: type_fields

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "asset_display_id": {
      "type": "integer",
      "description": "Asset display ID"
    },
    "include": {
      "type": "string",
      "description": "Include: type_fields"
    }
  },
  "required": [
    "PCID",
    "asset_display_id"
  ]
}

---

freshservice_assets_get_asset_type

View an Asset Type

Parameters:

Parameter	Type	Required	Default	Description
asset_type_id	integer	Yes	—	Asset Type ID

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "asset_type_id": {
      "type": "integer",
      "description": "Asset Type ID"
    }
  },
  "required": [
    "PCID",
    "asset_type_id"
  ]
}

---

freshservice_assets_list_asset_components

List Asset Components

Parameters:

Parameter	Type	Required	Default	Description
asset_display_id	integer	Yes	—	Asset display ID
page	integer	No	—	Page number
per_page	integer	No	—	Items per page (max 100)

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "asset_display_id": {
      "type": "integer",
      "description": "Asset display ID"
    },
    "page": {
      "type": "integer",
      "description": "Page number"
    },
    "per_page": {
      "type": "integer",
      "description": "Items per page (max 100)"
    }
  },
  "required": [
    "PCID",
    "asset_display_id"
  ]
}

---

freshservice_assets_list_asset_contracts

List Asset Associated Contracts

Parameters:

Parameter	Type	Required	Default	Description
asset_display_id	integer	Yes	—	Asset display ID

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "asset_display_id": {
      "type": "integer",
      "description": "Asset display ID"
    }
  },
  "required": [
    "PCID",
    "asset_display_id"
  ]
}

---

freshservice_assets_list_asset_relationships

List Asset Relationships

Parameters:

Parameter	Type	Required	Default	Description
asset_display_id	integer	Yes	—	Asset display ID

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "asset_display_id": {
      "type": "integer",
      "description": "Asset display ID"
    }
  },
  "required": [
    "PCID",
    "asset_display_id"
  ]
}

---

freshservice_assets_list_asset_requests

List Asset Associated Requests

Parameters:

Parameter	Type	Required	Default	Description
asset_display_id	integer	Yes	—	Asset display ID

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "asset_display_id": {
      "type": "integer",
      "description": "Asset display ID"
    }
  },
  "required": [
    "PCID",
    "asset_display_id"
  ]
}

---

freshservice_assets_list_asset_type_fields

List Fields of an Asset Type

Parameters:

Parameter	Type	Required	Default	Description
asset_type_id	integer	Yes	—	Asset Type ID

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "asset_type_id": {
      "type": "integer",
      "description": "Asset Type ID"
    }
  },
  "required": [
    "PCID",
    "asset_type_id"
  ]
}

---

freshservice_assets_list_asset_types

List All Asset Types

Parameters:

Parameter	Type	Required	Default	Description
page	integer	No	—	Page number
per_page	integer	No	—	Items per page (max 100)

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "page": {
      "type": "integer",
      "description": "Page number"
    },
    "per_page": {
      "type": "integer",
      "description": "Items per page (max 100)"
    }
  },
  "required": [
    "PCID"
  ]
}

---

freshservice_assets_list_assets

List All Assets

Parameters:

Parameter	Type	Required	Default	Description
page	integer	No	—	Page number
per_page	integer	No	—	Items per page (max 100)
include	string	No	—	Include additional info: type_fields
query	string	No	—	Filter query, e.g. asset_type_id:1 — do NOT include surrounding quotes, they are added automatically

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "page": {
      "type": "integer",
      "description": "Page number"
    },
    "per_page": {
      "type": "integer",
      "description": "Items per page (max 100)"
    },
    "include": {
      "type": "string",
      "description": "Include additional info: type_fields"
    },
    "query": {
      "type": "string",
      "description": "Filter query, e.g. asset_type_id:1 — do NOT include surrounding quotes, they are added automatically"
    }
  },
  "required": [
    "PCID"
  ]
}

---

freshservice_assets_restore_asset

Restore a Trashed Asset

Parameters:

Parameter	Type	Required	Default	Description
asset_display_id	integer	Yes	—	Asset display ID

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "asset_display_id": {
      "type": "integer",
      "description": "Asset display ID"
    }
  },
  "required": [
    "PCID",
    "asset_display_id"
  ]
}

---

freshservice_assets_update_asset

Update an Asset

Parameters:

Parameter	Type	Required	Default	Description
asset_display_id	integer	Yes	—	Asset display ID
agent_id	integer	No	—	Managed By agent
asset_tag	string	No	—	Asset tag
asset_type_id	integer	No	—	Asset type ID
custom_fields	object	No	—	Custom fields
department_id	integer	No	—	Department
description	string	No	—	The description value
group_id	integer	No	—	Managed By group
impact	string	No	—	The impact value
location_id	integer	No	—	Location
name	string	No	—	The name value
type_fields	object	No	—	Type-specific fields
usage_type	string	No	—	Usage type
user_id	integer	No	—	Used By user

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "asset_display_id": {
      "type": "integer",
      "description": "Asset display ID"
    },
    "agent_id": {
      "type": "integer",
      "description": "Managed By agent"
    },
    "asset_tag": {
      "type": "string",
      "description": "Asset tag"
    },
    "asset_type_id": {
      "type": "integer",
      "description": "Asset type ID"
    },
    "custom_fields": {
      "type": "object",
      "description": "Custom fields"
    },
    "department_id": {
      "type": "integer",
      "description": "Department"
    },
    "description": {
      "type": "string",
      "description": "The description value"
    },
    "group_id": {
      "type": "integer",
      "description": "Managed By group"
    },
    "impact": {
      "type": "string",
      "description": "The impact value"
    },
    "location_id": {
      "type": "integer",
      "description": "Location"
    },
    "name": {
      "type": "string",
      "description": "The name value"
    },
    "type_fields": {
      "type": "object",
      "description": "Type-specific fields"
    },
    "usage_type": {
      "type": "string",
      "description": "Usage type"
    },
    "user_id": {
      "type": "integer",
      "description": "Used By user"
    }
  },
  "required": [
    "PCID",
    "asset_display_id"
  ]
}

---

freshservice_assets_update_asset_type

Update an Asset Type

Parameters:

Parameter	Type	Required	Default	Description
asset_type_id	integer	Yes	—	Asset Type ID
description	string	No	—	The description value
name	string	No	—	The name value

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "asset_type_id": {
      "type": "integer",
      "description": "Asset Type ID"
    },
    "description": {
      "type": "string",
      "description": "The description value"
    },
    "name": {
      "type": "string",
      "description": "The name value"
    }
  },
  "required": [
    "PCID",
    "asset_type_id"
  ]
}