# Maintainx AI integration on Definable

> MaintainX is a cloud-based computerized maintenance management system (CMMS) that helps organizations centralize maintenance data, communication, and workflows.

## What this connects

MaintainX is a cloud-based computerized maintenance management system (CMMS) that helps organizations centralize maintenance data, communication, and workflows.

Vendor: https://www.getmaintainx.com/

## Tools available

**30** tools available. First 12:

- `MAINTAINX_CREATE_CATEGORY` — Create Category — Tool to create a new category in MaintainX for organizing work orders, assets, and other items. Use when you need to add a new category to the organization's classification system.
- `MAINTAINX_CREATE_LOCATION` — Create Location — Tool to create a new location in MaintainX. Use when you need to add a new physical location where assets are stored or work is performed. Locations can be organized hierarchically using the parentId parameter.
- `MAINTAINX_CREATE_PROCEDURE_TEMPLATE` — Create Procedure Template — Tool to create a new procedure template in MaintainX with checklist items for work orders. Use when you need to create a standardized procedure that can be attached to work orders. The template can include various field types like text, checkboxes, signatures, and multiple choice options.
- `MAINTAINX_CREATE_WORK_ORDER` — Create Work Order — This tool creates a new work order in MaintainX. It uses the POST /api/v1/workorders endpoint. The tool requires a 'title' for the work order and offers several optional parameters including description, priority, dueDate, startDate, userIds, teamIds, procedureTemplateId, locationId, assetId, and categories.
- `MAINTAINX_CREATE_WORK_ORDER_COMMENT` — Create Work Order Comment — This tool creates a new comment on an existing work order in MaintainX. It allows users to add comments for documentation, updates, or communication purposes within a specific work order. It requires a workOrderId and the text content of the comment to create a new comment on the work order, providing capabilities to update maintenance work order records.
- `MAINTAINX_CREATE_WORK_REQUEST` — Create Work Request — Tool to create a new work request in MaintainX. Use when you need to submit a request for work that can later be converted to a work order. Work requests are typically used to initiate maintenance or service requests that require approval before becoming work orders.
- `MAINTAINX_CREATE_WORK_REQUEST_PORTAL` — Create Work Request Portal — Creates a new work request portal in MaintainX. A work request portal allows users to submit work requests through a dedicated URL. The portal can be customized with a title, welcome text, and description placeholder. It can be associated with a specific location and asset, and can be configured to require email contact information.
- `MAINTAINX_DELETE_ASSETS` — Delete Assets — Tool to delete an asset from MaintainX by its ID. Use when you need to permanently remove an asset from the system. Returns a success confirmation upon successful deletion (HTTP 204).
- `MAINTAINX_DELETE_CATEGORY` — Delete Category — Tool to delete a category in MaintainX. Use when you need to remove a category from the system. Returns success status upon deletion (HTTP 204).
- `MAINTAINX_FIND_ENTITY` — Find Entity — A tool to search and find specific entities within MaintainX by specified fields. This tool allows users to search for different types of entities including work orders, users, and locations.
- `MAINTAINX_GET_CATEGORY` — Get Category — Tool to retrieve detailed information about a specific category by its ID. Use when you need to get the label, description, update time, or work order count for a category.
- `MAINTAINX_GET_LOCATION` — Get Location — Tool to retrieve detailed information about a specific location by its ID. Use when you need to get comprehensive details including address, attachments, child locations, and custom fields for a location.

## Auth

Auth schemes: `API_KEY`.

## How agents use Maintainx

Inside a Definable workflow, Maintainx is one of the tools the **Distributor specialist** can call. Example coordination patterns:

- **Researcher → Maintainx** — the Researcher (GPT-5.5) pulls context from Maintainx (records, threads, documents), synthesises findings, and briefs the rest of the team.
- **Writer → Distributor → Maintainx** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into Maintainx (create record, post message, draft email).
- **Designer / Engineer → Distributor → Maintainx** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via Maintainx (attach file, open PR comment, post status).

The Verifier checks every Maintainx call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention.

## Categories

- task management — https://definable.ai/apps/category/task-management/
- product management — https://definable.ai/apps/category/product-management/

## Related

- HTML page: https://definable.ai/apps/maintainx/
- Same category (task management): https://definable.ai/apps/category/task-management/
- All integrations: https://definable.ai/apps/
- Workflow (multi-agent loop): https://definable.ai/workflow/
- Apps llms.txt index: https://definable.ai/llms-apps.txt