bamboohr-cost-tuning

# BambooHR Cost Tuning ## Overview BambooHR pricing is per-employee-per-month (not per-API-call), but excessive API usage triggers rate limiting (503 errors) which causes sync failures and operational issues. This skill covers reducing API call volume, monitoring usage, and building efficient sync patterns. ## Prerequisites - BambooHR integration in production - Understanding of current API usage patterns - Application logging capturing API calls ## Instructions ### Step 1: Understand BambooHR Pricing BambooHR charges by **employee count**, not API calls: | Plan | Pricing Model | API Access | |------|--------------|------------| | Essentials | Per employee/month | Full REST API | | Advantage | Per employee/month | Full REST API + advanced reports | | Custom/Enterprise | Negotiated | Full API + dedicated support | **Key insight:** API call volume does not directly affect your bill, but hitting rate limits causes operational failures. Optimize for reliability, not cost. ### Step 2: Audit Current API Usage ```typescript // Instrument your client to log all API calls class InstrumentedBambooHRClient { private callLog: { endpoint: string; method: string; timestamp: number; durationMs: number }[] = []; async request<T>(method: string, path: string, body?: unknown): Promise<T> { const start = Date.now(); const result = await this.innerClient.request<T>(method, path, body); this.callLog.push({ endpoint: path.split('?')[0], // Strip query params ...