> ## Documentation Index
> Fetch the complete documentation index at: https://lupitor-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> Track the latest updates and changes to the AI CSR API

## v1.1.0 - October 2025

<Accordion title="Enhanced Documentation & Monitoring" icon="book" defaultOpen>
  **Released:** October 31, 2025

  ### New Features

  * 📚 **Comprehensive API Key Guide** - Step-by-step visual guide for creating and managing API keys
  * 🏥 **Health Check Endpoint** - Public `/api/health` endpoint for uptime monitoring
  * 📊 **API Request Logs** - Detailed logging with metrics (success rate, response times, error tracking)
  * 🔒 **Enhanced Rate Limiting** - Distributed rate limiting using Vercel KV (Redis)

  ### Rate Limiting Updates

  * `/api/health`: 60 requests/minute per IP address
  * `/api/v1/*`: 1,000 requests/hour per API key (upgraded from 100/min)
  * Sliding window algorithm for more flexible usage
  * Rate limit headers in all responses (`X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset`)

  ### Documentation Improvements

  * 📖 Step-by-step API key creation guide with screenshots
  * 📖 Health check endpoint documentation
  * 📖 Rate limiting best practices and monitoring
  * 📖 Security best practices for key management
  * 📖 API key rotation and revocation guides

  ### Monitoring Features

  * Dashboard view of all API requests
  * Summary metrics (total requests, success rate, avg response time, error count)
  * Detailed request logs with timestamps, endpoints, status codes, and response times
  * Filter logs by API key, campaign, method, and date range
</Accordion>

***

## v1.0.0 - July 2025

<Accordion title="Initial API Release" icon="rocket">
  **Released:** July 20, 2025

  ### New Features

  * ✨ Full API authentication with API keys
  * ✨ Lead management endpoints (create, list, bulk import)
  * ✨ Campaign-scoped and company-wide API keys
  * ✨ Read and write permission scopes
  * ✨ Comprehensive error handling
  * ✨ Rate limiting (100 req/min standard, 10 req/min bulk)

  ### Endpoints Added

  * `POST /api/v1/leads` - Create single lead
  * `GET /api/v1/leads` - List leads with filtering
  * `POST /api/v1/leads/bulk` - Bulk create up to 1000 leads

  ### Documentation

  * 📖 Complete API reference documentation
  * 📖 Authentication guide
  * 📖 Quickstart tutorial
  * 📖 Error handling guide
  * 📖 Rate limits documentation
</Accordion>

***

## Upcoming Features

<Info>
  These features are planned for future releases. Check back for updates!
</Info>

### Q1 2026

<AccordionGroup>
  <Accordion title="Conversations API" icon="message">
    * List conversations for a campaign
    * Get conversation details and transcripts
    * Filter by outcome, date range, agent
    * Webhook notifications for completed calls
  </Accordion>

  <Accordion title="Analytics API" icon="chart-line">
    * Campaign performance metrics
    * Outcome distribution
    * Success rates and trends
    * Agent performance comparison
  </Accordion>

  <Accordion title="Webhooks" icon="webhook">
    * Real-time call completion notifications
    * Lead status change events
    * Campaign milestones
    * Custom webhook endpoints
  </Accordion>
</AccordionGroup>

### Q2 2026

<AccordionGroup>
  <Accordion title="Campaigns API" icon="bullhorn">
    * Create and manage campaigns via API
    * Update campaign configuration
    * Configure outcomes and extractions
    * Traffic allocation control
  </Accordion>

  <Accordion title="Agents API" icon="robot">
    * List available agents
    * Get agent configuration
    * Create new agent variations
    * Update agent instructions and voice
  </Accordion>

  <Accordion title="Enhanced Lead Management" icon="users">
    * Update existing leads
    * Delete leads
    * Bulk update operations
    * Lead scheduling controls
  </Accordion>
</AccordionGroup>

### Q3 2026

<AccordionGroup>
  <Accordion title="GraphQL API" icon="diagram-project">
    * Alternative to REST API
    * Flexible data querying
    * Real-time subscriptions
    * Reduced over-fetching
  </Accordion>

  <Accordion title="SDK Libraries" icon="code">
    * Official Python SDK
    * Official Node.js SDK
    * Official Ruby SDK
    * TypeScript type definitions
  </Accordion>

  <Accordion title="Advanced Analytics" icon="chart-mixed">
    * Custom report generation
    * Data export capabilities
    * Conversation sentiment analysis
    * A/B testing metrics
  </Accordion>
</AccordionGroup>

***

## Migration Guides

<Note>
  **No breaking changes yet!** When we release v2.0, we'll provide comprehensive migration guides here.
</Note>

***

## API Versioning

Our API follows semantic versioning:

* **Major version** (v1, v2): Breaking changes
* **Minor updates**: New features, backwards compatible
* **Patches**: Bug fixes, backwards compatible

### Version Support Policy

* **Current version (v1)**: Fully supported
* **Previous version**: Supported for 12 months after deprecation
* **Deprecated versions**: 6 months notice before removal

***

## Request a Feature

Have an idea for the API? We'd love to hear it!

<Steps>
  <Step title="Check Roadmap">
    See if it's already planned above
  </Step>

  <Step title="Submit Request">
    Email [support@lupitor.com](mailto:support@lupitor.com) with your use case
  </Step>

  <Step title="Community Vote">
    Features with most demand get prioritized
  </Step>

  <Step title="Implementation">
    We'll notify you when your feature ships
  </Step>
</Steps>
