Changelog

All notable changes to the MAIA Platform API are documented here.

v1.7.167 - 2026-02-25

New Features

CRM Custom Field Lookup

• Custom Field Search - New query parameters on GET /crm/search for exact-match lookups by custom field value
  • customFieldId + customFieldValue - Find records where a specific custom field has an exact value
  • Useful for looking up records by phone number, email, external ID, or any indexed field
  • Case-insensitive matching
  • Bypasses full-text search for fast, precise lookups using the DynamoDB field value index
  • See CRM Search API for details

---

v1.7.101 - 2026-01-15

New Features

Full-Text Search

• Enhanced CRM Search - Upgraded search capabilities powered by Typesense full-text search engine
  • Substring Matching - Search for text anywhere within field values, not just at the beginning
  • Typo Tolerance - Find records even with minor spelling mistakes (up to 2 typos)
  • All Custom Fields Indexed - Search across title and all text-based custom fields (text, email, phone, url, select, multiselect)
  • Search doe now finds "John Doe - New Lead" (previously only john would match)
  • Search example now finds "john@example.com"
  • See CRM Search API for details

Bug Fixes

AI Agent

• Agent-to-Agent Call Message Leak - Fixed an issue where internal agent messages during agent-to-agent handoff calls were being exposed to end users. Agent handoff conversations are now properly isolated.

---

v1.7.100 - 2026-01-14

New Features

CRM Public API

• API Token Authentication - Access CRM endpoints programmatically using API tokens

  • Generate API tokens via Settings → API Tokens in the dashboard
  • Supports both JWT (dashboard) and API token authentication
  • See Authentication for token generation details

• CRM Records API - Full CRUD operations for CRM records

  • GET /crm/records - List records with filtering and pagination
  • GET /crm/records/{id} - Get a single record by ID
  • POST /crm/records - Create new records
  • PUT /crm/records/{id} - Update existing records
  • DELETE /crm/records/{id} - Delete records
  • See CRM API for full documentation

• Search & Discovery - Search and explore your CRM data

  • GET /crm/search - Search records with prefix matching
  • GET /crm/search/aggregations - Get status counts per kanban
  • GET /crm/search/suggest - Get autocomplete suggestions
  • GET /crm/fields - Retrieve custom field definitions
  • GET /crm/statuses - Get status configurations

• Kanbans API - Access kanban board configurations

  • GET /kanbans - List all kanban boards with statuses and fields
  • GET /kanbans/{id} - Get a single kanban by ID or slug

• Rate Limiting - Protect API availability with sliding window rate limiting

  • Default: 120 requests/minute, 3,000 requests/hour
  • Rate limit headers included in responses: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset
  • Contact your administrator to adjust limits

---

v1.7.96 - 2026-01-12

Improvements

Audio Upload Support

• Opus Audio Format - Added support for audio/opus MIME type in file uploads
  • Upload Opus audio files via the /messages/upload endpoint
  • Opus files are automatically transcribed using OpenAI Whisper
  • Native WhatsApp compatibility (no conversion required)

---

v1.7.91 - 2026-01-11

New Features

Light Theme Support

• Light/Dark Theme Toggle - New appearance settings to switch between dark and light themes
  • Access via Settings → Appearance in the dashboard
  • PWA users can toggle themes in Settings within the mobile app
  • Light theme features WhatsApp-style chat interface with green sent message bubbles
  • All UI components including Monaco code editors, charts, and dialogs adapt to the selected theme
  • Theme preference is persisted across sessions

---

v1.7.90 - 2026-01-10

New Features

Webhook Center

• Outbound Webhooks - New webhook management system for receiving real-time notifications about CRM events
  • Configure webhooks via Settings → Webhooks in the dashboard
  • Supported event types:
    • crm_field_update - When a field value changes on a CRM record
    • crm_record_created - When a new CRM record is created
    • crm_record_deleted - When a CRM record is deleted
    • ai_pause - When AI is paused or resumed for a session
  • Filter webhooks by specific kanbans or fields
  • HMAC-SHA256 signature verification for security
  • Automatic retries with exponential backoff
  • Delivery logs to track webhook history
  • See CRM Webhooks for payload details

---

Previous Versions

For changes prior to v1.7.90, please refer to the GitHub releases.