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

Setup

  1. Go to Project SettingsProject 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

Filter Work Orders

Get Part Information

Create Work Order

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

Working with Integrations

Learn how to use integrations effectively

Network Monitor

Debug DimoMaint API calls