manage_assets
Create, retrieve, list, update, and delete Snipe-IT assets with filtering, search, and custom field support for complete asset inventory management.
Instructions
Manage Snipe-IT assets with CRUD operations.
This tool handles all basic asset operations:
create: Create a new asset (requires asset_data with at least status_id and model_id)
get: Retrieve a single asset by ID, asset_tag, or serial number (uses dedicated bytag/byserial endpoints for reliable barcode scanning workflows)
list: List assets with optional pagination, filtering by status/model/company/location/category/manufacturer/assigned_to
update: Update an existing asset (requires asset_id and asset_data/extra_fields)
delete: Delete an asset (requires asset_id)
Use extra_fields for fields not in AssetData: asset_eol_date, custom fields (snipeit*), etc. For both create and update, extra_fields are validated against the model's fieldset before sending. Invalid field names will be rejected with a list of available fields.
Note: list action returns full asset objects. With high limits this can produce large responses. Use pagination (limit/offset) to control response size.
Sortable fields for list: id, name, asset_tag, serial, model, model_number, last_checkout, category, manufacturer, notes, expected_checkin, order_number, companyName, location, image, status_label, assigned_to, created_at, purchase_date, purchase_cost
Returns: dict: Result of the operation including success status and data
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | Field to sort by (for list action). Valid fields: id, name, asset_tag, serial, model, model_number, last_checkout, category, manufacturer, notes, expected_checkin, order_number, companyName, location, image, status_label, assigned_to, created_at, purchase_date, purchase_cost | |
| limit | No | Number of results to return per page (for list action). Default 20 because each asset payload is large (~5KB with custom fields). | |
| order | No | Sort order (for list action) | |
| action | Yes | The action to perform on assets | |
| offset | No | Number of results to skip (for list action) | |
| search | No | Search query (for list action) | |
| serial | No | Serial number (alternative to asset_id for get) | |
| asset_id | No | Asset ID (required for get, update, delete) | |
| model_id | No | Filter by model ID (for list action) | |
| asset_tag | No | Asset tag (alternative to asset_id for get) | |
| status_id | No | Filter by status label ID (for list action) | |
| asset_data | No | Asset data for standard fields (required for create, optional for update) | |
| company_id | No | Filter by company ID (for list action) | |
| assigned_to | No | Filter by assigned user/asset/location ID (for list action) | |
| category_id | No | Filter by category ID (for list action) | |
| location_id | No | Filter by location ID (for list action) | |
| extra_fields | No | Additional fields not in AssetData: asset_eol_date, custom fields (_snipeit_*), etc. For update, fields are validated against the asset's model fieldset. | |
| manufacturer_id | No | Filter by manufacturer ID (for list action) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||