# MaintainX API Documentation

This is the complete API documentation for connecting to the MaintainX API using MindCloud's Universal API.

MindCloud offers one normalized API to access 3,400+ apps from a single place. It centralizes authentication and normalizes app APIs so they are easier and more consistent to use.

## Quickstart

1. A **MindCloud account** — sign in or create an account at [MindCloud](https://app.mindcloud.co).
2. A **MindCloud API Key** — create one in [API Keys](https://app.mindcloud.co/user/api-keys). Keep it on your server.
3. At least one **MaintainX connection** — create or choose one in [Connections](https://app.mindcloud.co/credentials). Note its `connectionId`.

```text
POST https://connect.mindcloud.co/v2/universal/apps/maintainX/actions/{actionSlug}/run
```

## MaintainX actions

- POST `create-asset` Create Asset
- POST `create-custom-field` Create Custom Field
- POST `create-location` Create Location
- POST `create-user` Create User
- DELETE `delete-location` Delete Location
- GET `get-asset` Get Asset
- GET `get-location` Get Location
- GET `get-work-order` Get Work Order
- GET `list-asset-statuses` List Asset Statuses
- GET `list-assets` List Assets
- GET `list-assets-criticalities` List Assets Criticalities
- GET `list-locations` List Locations
- GET `list-users` List Users
- GET `list-vendors` List Vendors
- GET `list-work-order-comments` List Work Order Comments
- GET `list-work-orders` List Work Orders
- PUT `update-asset` Update Asset
- PUT `update-location` Update Location
- PUT `update-user` Update User
- PUT `update-work-order` Update Work Order