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

# DimoMaint Integration

> Connect HelloLeo to your DimoMaint maintenance management system

Connect HelloLeo to your DimoMaint instance to manage assets, work orders, parts, and maintenance operations.

## Setup

1. Go to **Project Settings** → **Project Integrations**
2. Select **DimoMaint** from the list
3. Enter your credentials:
   * **API Key** - Your DimoMaint API key (X-API-Key header)
   * **Tenant** - Your DimoMaint tenant identifier
4. Test the connection using the "Connection Test" button
5. Start using DimoMaint in your prompts

## How It Works

HelloLeo uses the DimoMaint API through the Integration Proxy. Your API key and tenant are encrypted and stored securely on the backend. API calls are made directly from your frontend through the proxy, avoiding CORS issues.

## API Endpoints

The integration uses DimoMaint's REST API. Endpoints follow the format:

* `/connector/{Resource}/{Action}` - Access DimoMaint resources
* Examples:
  * `/connector/Asset/Filter` - Filter assets
  * `/connector/WorkOrder/Get` - Get work orders
  * `/connector/Part/Filter` - Filter parts

## Common Operations

### Filter Resources

* **POST** `/connector/{Resource}/Filter` - Filter resources with pagination
  * Supports pagination: `currentPage`, `pageSize`
  * Example resources: `Asset`, `WorkOrder`, `Part`

### Get Resource

* **GET** `/connector/{Resource}/Get` - Get a specific resource
  * Query parameters: `code`, `interfaceKey`

### Create/Update Resources

* **POST** `/connector/{Resource}/{Action}` - Create or update resources

## Authentication

The integration uses API key authentication via the `X-Api-Key` header. Your tenant identifier is included in the URL path.

## Example Usage

### Display Assets

```
Show all assets from DimoMaint. Display asset code, name, 
and current status.
```

### Filter Work Orders

```
Find all work orders in DimoMaint where status is "Open". 
Display work order number, description, and assigned technician.
```

### Get Part Information

```
Get details for part code "PART-001" from DimoMaint.
```

### Create Work Order

```
Create a new work order in DimoMaint for asset "ASSET-123" 
with description "Routine maintenance check".
```

## Best Practices

* **Specify resource type** - Always mention which DimoMaint resource you're working with (e.g., "assets", "work orders", "parts")
* **Use filters** - Describe what records you want to find
* **Mention the integration** - Always say "from DimoMaint" or "to DimoMaint" so Leo knows which integration to use
* **Use pagination** - For large datasets, specify page size and current page

## Troubleshooting

### Connection Issues

* **Check API key** - Verify your API key is correct
* **Check tenant** - Ensure your tenant identifier is correct
* **Test connection** - Use the "Connection Test" button to verify credentials

### Data Not Showing

* **Check resource name** - Ensure you're using the correct resource name (e.g., `Asset`, `WorkOrder`, `Part`)
* **Verify permissions** - Make sure your API key has access to the resources
* **Check filter** - Review your filter criteria

### Can't Create/Update

* **Write permissions** - Ensure your API key has write access
* **Required fields** - Check that all required fields are provided
* **Data format** - Verify data matches DimoMaint's expected format

<CardGroup cols={2}>
  <Card title="Working with Integrations" icon="plug" href="/integrations/working-with-integrations">
    Learn how to use integrations effectively
  </Card>

  <Card title="Network Monitor" icon="activity" href="/features/network-monitor">
    Debug DimoMaint API calls
  </Card>
</CardGroup>