List Assets
hudu_list_assetsList assets across Hudu companies, filtering by search, company, or asset layout. Retrieve documented IT items and their custom fields for read-only use.
Instructions
List assets in Hudu. An asset is any documented thing that belongs to a company — a server, a workstation, a firewall, a licence, a contact. The asset layout it was created from decides which custom fields it carries.
This is the only route that reads assets across every company, and it is read-only: creating, updating, archiving and deleting an asset all happen under /companies/{company_id}/assets. Keep the company_id of any record you might write to — hudu_get_asset, hudu_create_asset, hudu_update_asset, hudu_archive_asset and hudu_delete_asset all require it, and it cannot be recovered from the asset id alone. If you narrow the response with fields, keep "company_id" in the list.
Custom field values come back under fields as {id, label, value, position} objects rather than as top-level keys. search is the right first filter for a hostname or a fragment of a name; id is how you turn a bare asset id into the company id needed to write to it.
Returns an object with items plus pagination facts. Note that the Hudu API returns no total count for any collection, so page_was_full is the only honest signal that more records exist — read pagination_note before concluding a list is complete.
Operation class: Read.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Return the single asset with this id. Useful when you hold an asset id and need its `company_id` before you can write to it. | |
| name | No | Match against the asset name. | |
| page | No | 1-based page number. Hudu has no cursor or offset — only pages. | |
| slug | No | URL slug, if you already know it. | |
| fields | No | Return only these top-level fields on each record. Use it to keep large lists small — e.g. ["id","name","company_id"]. Unknown field names are ignored. | |
| search | No | Broad text search across asset fields. The best first filter for a name. | |
| archived | No | true returns archived assets instead of active ones. | |
| page_size | No | Records per page (1-100, default 25). Hudu publishes no maximum, so this client clamps at 100; larger values are rejected here rather than silently altered by the server. | |
| company_id | No | Return only assets owned by this company. | |
| updated_at | No | ISO-8601 range as "start,end". Either side may be omitted — "2026-01-01T00:00:00Z," means everything changed since that moment. | |
| primary_serial | No | Match against the serial number. | |
| asset_layout_id | No | Return only assets built on this asset layout, e.g. only servers. | |
| response_format | No | Output shape. 'json' (default) is compact and machine-readable; 'markdown' is easier for a person to read but larger. | json |