For Agents
Manage CMMS assets, work orders, inventory, and purchase orders in Maintenance Connection. Used by agents that automate preventive maintenance scheduling, parts ordering, and asset record-keeping for facilities and plants.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Maintenance Connection API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with Maintenance Connection API.
Open a new work order against a specific asset and assign a technician
Record meter readings on an asset to drive condition-based maintenance triggers
Look up the parts inventory level for a stock item across multiple warehouses
GET STARTED
Use for: I need to open a work order for asset PUMP-104, Record a meter reading of 12450 hours on the compressor, List all open work orders assigned to technician Maria, Get the current stock level for spare bearing part 800-44
Not supported: Does not handle accounting, payroll, or general-purpose CRM — use for CMMS asset, work-order, parts, and purchase-order operations only.
Jentic publishes the only available OpenAPI specification for Maintenance Connection API, keeping it validated and agent-ready. Maintenance Connection is a Computerized Maintenance Management System (CMMS) and its v8 REST API exposes 136 endpoints covering assets, work orders, parts and inventory, purchase orders, classifications, companies, and document management. The API uses HTTP basic auth and is the integration surface for plant-floor automation, asset tracking, and preventive maintenance workflows.
Attach photos and documents to an asset record for compliance reviews
Create a purchase order for replenishment parts and route it for approval
Pull every work order completed against an asset for a reliability report
Patterns agents use Maintenance Connection API for, with concrete tasks.
★ Preventive Maintenance Automation
Plant maintenance teams run preventive maintenance schedules driven by meter readings and elapsed time. The Maintenance Connection asset and meter-history endpoints record the readings that trigger PM work orders, and the work-order endpoints open, assign, and close the resulting jobs. An automation script can poll telemetry, post readings, and watch the system generate the right PMs without manual entry.
POST /Assets/{assetPK}/meterhistory with the new reading and verify the resulting PM work order on GET /WorkOrders.
Spare Parts Inventory Replenishment
Stockouts on critical spare parts cause unplanned downtime. The Maintenance Connection inventory endpoints expose stock levels by warehouse and the purchase-order endpoints create and route POs for replenishment. A nightly batch can identify items below reorder point, generate the purchase orders, and capture the PO numbers for tracking.
Query parts below reorder point, POST /PurchaseOrders with the consolidated reorder list, and capture the returned PO numbers.
Asset Document and Photo Management
Compliance reviews and reliability investigations need quick access to asset documentation, including manuals, inspection reports, and condition photos. The asset documents and images endpoints upload binary files against the asset record and list everything attached to a given asset, making it possible to compile a full asset dossier programmatically.
POST /Assets/{assetPK}/documents with the inspection PDF, then list all documents on the asset to confirm the upload.
AI Agent Maintenance Assistant
Maintenance supervisors can delegate routine work order creation, status checks, and parts lookups to an AI agent. Through Jentic the agent searches by intent, loads the schema for the right CMMS operation, and executes the call while basic-auth credentials stay in the vault. The same loop powers shop-floor copilots and supervisor chatbots.
Use Jentic to search 'create maintenance work order', execute POST /WorkOrders with the asset and description from the user request, and return the new work order ID.
136 endpoints — jentic publishes the only available openapi specification for maintenance connection api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/Assets
List all assets
/Assets
Create one or more assets
/Assets/{assetPK}
Get asset by PK
/Assets/{assetPK}/meterhistory
Create asset meter history records
/Assets/{assetPK}/images
Upload asset images
/Assets/{assetPK}/documents
Upload asset documents
/AssetSpecifications
List all asset specifications
/Assets
List all assets
/Assets
Create one or more assets
/Assets/{assetPK}
Get asset by PK
/Assets/{assetPK}/meterhistory
Create asset meter history records
/Assets/{assetPK}/images
Upload asset images
Three things that make agents converge on Jentic-routed access.
Credential isolation
Maintenance Connection basic-auth credentials are stored encrypted in the Jentic vault. Agents call the API through a scoped execution token and Jentic injects the Authorization header server-side, so the username and password never enter agent context.
Intent-based discovery
Agents search by intent (e.g., 'open a work order against an asset') and Jentic returns the right Maintenance Connection endpoint with its input schema — no need to navigate the 136-operation surface manually.
Time to first call
Direct Maintenance Connection integration: 1-2 weeks for auth, error handling, and shaping the deeply nested asset model. Through Jentic: under a day — search, load, execute.
Alternatives and complements available in the Jentic catalogue.
Specific to using Maintenance Connection API through Jentic.
Why is there no official OpenAPI spec for Maintenance Connection API?
Maintenance Connection does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Maintenance Connection API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the Maintenance Connection API use?
Maintenance Connection uses HTTP basic authentication: the username and password of a Maintenance Connection account user. Through Jentic the credentials are stored encrypted in the vault and injected at execute time, so they never enter the agent context.
Can I open a work order against an asset through the API?
Yes. The work-order endpoints accept the asset PK, description, and assigned technician on POST and return the new work-order PK. Use GET on the same resource to track status updates.
How do I record a meter reading on an asset?
Call POST /Assets/{assetPK}/meterhistory with the meter reading payload. The reading drives any meter-based preventive maintenance schedules attached to the asset.
What are the rate limits for the Maintenance Connection API?
The OpenAPI spec does not declare numeric rate limits — they are governed by the Maintenance Connection deployment your account belongs to. Confirm the limit with your Maintenance Connection administrator before driving high-volume integrations.
How do I open a work order through Jentic?
Run pip install jentic, search 'open a maintenance work order', load the schema for the work-order POST, and execute with the asset PK and description. Jentic injects the basic-auth header from the encrypted vault.
/Assets/{assetPK}/documents
Upload asset documents
/AssetSpecifications
List all asset specifications