Agent skill · software engineering · jeremylongshore
maintainx-install-auth
Install and configure MaintainX REST API authentication.
Why this skill is useful
Adds a complete API client wrapper for MaintainX, including authentication setup and error handling that the AI cannot generate on its own.
What it needs
Requires node, python installed locally. Requires maintainx account access. About 3k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
MaintainX Install & Auth Overview Set up MaintainX REST API authentication and configure your development environment for CMMS integration. Prerequisites Node.js 18+ or Python 3.10+ MaintainX account with API access (Professional or Enterprise plan) Admin access to generate API keys Instructions Step 1: Generate API Key 1. Log into MaintainX at https://app.getmaintainx.com 2. Navigate to Settings > Integrations 3. Click New Key > Generate Key 4. Copy and securely store your API key (shown only once) Step 2: Configure Environment Variables Step 3: Create API Client Wrapper Step 4: Verify Connection Python Alternative Output Environment variable or .env file with API key configured MaintainX client wrapper installed and configured Successful connection verification output Error Handling Error Cause Solution ------- ------- ---------- 401 Unauthorized Invalid or expired API key Generate new key in Settings > Integrations 403 Forbidden Insufficient permissions Ensure admin role or correct plan tier 404 Not Found Wrong base URL or endpoint Use api.getmaintainx.com/v1 Network Error Firewall blocking HTTPS Allow outbound 443 to getmaintainx.com Security Best Practices 1. Never commit API keys to version control 2. Use environment variables or secret managers 3. Rotate keys periodically (every 90 days recommended) 4. Use organization-specific keys for multi-tenant setups 5. Limit key scope to required operations only Resources MaintainX API Documentation MaintainX Help Center Generating API Keys Next Steps After successful auth, proceed to maintainx-hello-world for your first API call. Examples Quick test with curl: Multi-org setup (for contractors managing multiple facilities):
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/maintainx-install-auth