Overview

FieldFix provides an API to query and manage your heavy equipment fleet. It lets you list machines, fetch details, review expenses and service history, log maintenance, and update hours, helping you optimize maintenance and costs. AI diagnostics support helps leak detection and predictive insights for uptime.

How This Skill Works

Authenticate with your API key exposed via the FIELDFIX_API_KEY environment variable. Use the FieldFix Agent API or the provided CLI commands to perform read operations (list machines, get machine details, expenses, service history, and alerts) and write operations (log service, log expense, update hours). Endpoints include /machines, /machines/{id}, /machines/{id}/expenses, /machines/{id}/service, /alerts, and /machines/{id}/hours, with sample scripts shown in the Skill documentation.

When to Use It

• When you need a complete list of all machines in your FieldFix fleet.
• When you want details about a specific machine (specs, history, expenses).
• When budgeting or auditing costs by reviewing expenses and service history.
• When logging maintenance or expenses directly from the field.
• When updating hour meters and monitoring fleet alerts.

Quick Start

1. Step 1: Get your API key from FieldFix Settings.
2. Step 2: Set the environment variable: export FIELDFIX_API_KEY=ff_sk_live_your_key_here
3. Step 3: Try a quick prompt or run a sample command like: node scripts/fieldfix.js machines

Best Practices

• Securely store and rotate your API key; use environment variables like FIELDFIX_API_KEY.
• Fetch data with read endpoints before performing write actions to avoid duplicates.
• Validate machine IDs and contexts before logging service or expenses.
• Include clear, consistent descriptions and amounts when logging services or expenses.
• Regularly review hours, expenses, and alerts to prevent unplanned downtime.

Example Use Cases

• What machines do I have in FieldFix?
• When is my CAT 299 due for service?
• How much have I spent on fuel this month?
• Log an oil change on the excavator for $120
• What's the total cost per hour for my skid steer?

Frequently Asked Questions