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

# SmartAsset

> Connect SmartAsset equipment tracking to your agents

## Connect SmartAsset

An Aster organization admin can connect one SmartAsset account in **Control Hub > Integrations > SmartAsset**. The connection is shared across the organization.

1. In SmartAsset, open **Admin > API Keys** and create a key. Read only is enough.
2. Paste the key into Aster and save. Aster reads one piece of equipment before saving.
3. Enable `smartasset_query` on your agent.

## Available tool

`smartasset_query` reads one endpoint per call. Lists are paged inside the call up to `max_rows` (default 2,000), and large results are attached as a file.

| Endpoint | Returns |
| - | - |
| `Equipment` | Equipment roster: type, make/model, VIN, hour meters, productive hours |
| `equipment-productivity` | Productive, unproductive and total hours per machine per day (`date`, or `start` + `end`) |
| `equipment-location`, `equipment-location/{id}/detail` | Current location; one machine's specs, stats and service counts |
| `equipment-breadcrumbs`, `equipment-breadcrumbs/{id}/gps` | GPS-tracked equipment and breadcrumb trails for a day |
| `Equipment/{id}/service-logs`, `Equipment/{id}/mechanic-hours` | Service history and mechanic labor |
| `Trucks`, `Trucks/{id}/on-board` | Trucks and the equipment last seen on board |
| `Crews`, `Employees`, `Branches`, `Jobs`, `Routes`, `WorkOrders`, `Tasks`, `Materials`, `Locations` | Reference records |
| `timesheet-entries`, `timesheet-list` | Timesheets (`from`, `to`) |

Dates are `yyyy-MM-dd`. The SmartAsset API does not filter or sort lists for API keys, so agents fetch a list and filter the result.

## Example prompts

* "Which mowers had the most productive hours last week?"
* "Show daily hours for every blower this month."
* "What equipment is on Truck 23 right now?"

## Coverage and troubleshooting

This version is read-only. It does not add or update employees, jobs, equipment or work orders, and does not download timesheet photos or PDF worksheets.

* **401:** the key was revoked or mistyped. Create a new one and reconnect.
* **429:** SmartAsset allows 120 calls a minute. Wait and retry.

The key stays server-side and is redacted in connection responses.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.