> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 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`](#freshservice_assets_create_asset)                         | Create an Asset                 |
| [`freshservice_assets_create_asset_component`](#freshservice_assets_create_asset_component)     | Create a Component              |
| [`freshservice_assets_create_asset_type`](#freshservice_assets_create_asset_type)               | Create an Asset Type            |
| [`freshservice_assets_delete_asset`](#freshservice_assets_delete_asset)                         | Delete an Asset (trash)         |
| [`freshservice_assets_delete_asset_type`](#freshservice_assets_delete_asset_type)               | Delete an Asset Type            |
| [`freshservice_assets_get_asset`](#freshservice_assets_get_asset)                               | View an Asset                   |
| [`freshservice_assets_get_asset_type`](#freshservice_assets_get_asset_type)                     | View an Asset Type              |
| [`freshservice_assets_list_asset_components`](#freshservice_assets_list_asset_components)       | List Asset Components           |
| [`freshservice_assets_list_asset_contracts`](#freshservice_assets_list_asset_contracts)         | List Asset Associated Contracts |
| [`freshservice_assets_list_asset_relationships`](#freshservice_assets_list_asset_relationships) | List Asset Relationships        |
| [`freshservice_assets_list_asset_requests`](#freshservice_assets_list_asset_requests)           | List Asset Associated Requests  |
| [`freshservice_assets_list_asset_type_fields`](#freshservice_assets_list_asset_type_fields)     | List Fields of an Asset Type    |
| [`freshservice_assets_list_asset_types`](#freshservice_assets_list_asset_types)                 | List All Asset Types            |
| [`freshservice_assets_list_assets`](#freshservice_assets_list_assets)                           | List All Assets                 |
| [`freshservice_assets_restore_asset`](#freshservice_assets_restore_asset)                       | Restore a Trashed Asset         |
| [`freshservice_assets_update_asset`](#freshservice_assets_update_asset)                         | Update an Asset                 |
| [`freshservice_assets_update_asset_type`](#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       |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "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"
    ]
  }
  ```
</Expandable>

***

## 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   |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "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"
    ]
  }
  ```
</Expandable>

***

## 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  |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "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"
    ]
  }
  ```
</Expandable>

***

## freshservice\_assets\_delete\_asset

Delete an Asset (trash)

**Parameters:**

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

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "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"
    ]
  }
  ```
</Expandable>

***

## freshservice\_assets\_delete\_asset\_type

Delete an Asset Type

**Parameters:**

| Parameter       | Type    | Required | Default | Description   |
| --------------- | ------- | -------- | ------- | ------------- |
| `asset_type_id` | integer | Yes      | —       | Asset Type ID |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "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"
    ]
  }
  ```
</Expandable>

***

## 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 |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "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"
    ]
  }
  ```
</Expandable>

***

## freshservice\_assets\_get\_asset\_type

View an Asset Type

**Parameters:**

| Parameter       | Type    | Required | Default | Description   |
| --------------- | ------- | -------- | ------- | ------------- |
| `asset_type_id` | integer | Yes      | —       | Asset Type ID |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "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"
    ]
  }
  ```
</Expandable>

***

## 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) |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "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"
    ]
  }
  ```
</Expandable>

***

## freshservice\_assets\_list\_asset\_contracts

List Asset Associated Contracts

**Parameters:**

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

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "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"
    ]
  }
  ```
</Expandable>

***

## freshservice\_assets\_list\_asset\_relationships

List Asset Relationships

**Parameters:**

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

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "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"
    ]
  }
  ```
</Expandable>

***

## freshservice\_assets\_list\_asset\_requests

List Asset Associated Requests

**Parameters:**

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

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "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"
    ]
  }
  ```
</Expandable>

***

## 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 |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "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"
    ]
  }
  ```
</Expandable>

***

## 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) |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "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"
    ]
  }
  ```
</Expandable>

***

## 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 |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "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"
    ]
  }
  ```
</Expandable>

***

## freshservice\_assets\_restore\_asset

Restore a Trashed Asset

**Parameters:**

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

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "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"
    ]
  }
  ```
</Expandable>

***

## 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          |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "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"
    ]
  }
  ```
</Expandable>

***

## 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        |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "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"
    ]
  }
  ```
</Expandable>