maintainx-install-auth

# 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 ```bash # Set environment variable export MAINTAINX_API_KEY="your-api-key-here" # Or create .env file echo 'MAINTAINX_API_KEY=your-api-key' >> .env # For multi-organization tokens, also set: export MAINTAINX_ORG_ID="your-organization-id" ``` ### Step 3: Create API Client Wrapper ```typescript // src/maintainx/client.ts import axios, { AxiosInstance, AxiosError } from 'axios'; export class MaintainXClient { private client: AxiosInstance; private baseUrl = 'https://api.getmaintainx.com/v1'; constructor(apiKey?: string, orgId?: string) { const key = apiKey || process.env.MAINTAINX_API_KEY; if (!key) { throw new Error('MAINTAINX_API_KEY is required'); } this.client = axios.create({ baseURL: this.baseUrl, headers: { 'Authorization': `Bearer ${key}`, 'Content-Type': 'application/json', ...(orgId && { 'X-Organization-Id': orgId }...