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

# December 2025

> Changelog entries for December 2025

## December 16, 2025

### Added

* **Webhooks API**: Full webhook support for real-time event notifications

  * Configure webhook endpoints to receive events when interviews complete, analyses finish, or failures occur
  * HMAC-SHA256 signature verification for secure payload validation
  * Automatic retry with exponential backoff for failed deliveries
  * Circuit breaker pattern to protect your endpoints from cascading failures
  * Custom headers support with encryption for sensitive authentication data
  * Test endpoint for verifying webhook connectivity

* **Test Interview Mode**: Enhanced interview creation with test mode support

  * Create test interviews that immediately complete without consuming billing minutes
  * Comprehensive mock analysis data automatically generated for screening interviews
  * Automatic webhook event delivery (`interview.completed` and `analysis.completed`) for testing webhook handlers
  * Perfect for integration testing, development, and webhook handler verification
  * Use `isTest: true` flag in interview creation endpoint

* **New Scopes**: Added `read:webhooks` and `write:webhooks` scopes for webhook management

### Documentation

* **Webhooks Guide**: Comprehensive guide covering event types, payloads, signature verification, and best practices
* **Webhooks Resource**: Detailed configuration reference for webhook management
* **API Reference**: Full endpoint documentation for webhook CRUD operations, testing, and circuit breaker reset
* **Test Interview Documentation**: Added comprehensive test mode documentation with examples and mock data structure details

***

## December 14, 2025

### Changed

* **Analysis Output Structure**: Fixed and improved analysis output structure documentation in interview responses
* **Interview Types**: Added comprehensive interview types documentation with detailed explanations

***

## December 10, 2025

### Changed

* **Currency Field Format**: Updated currency field to use ISO 4217 alpha-3 format
* **Response Descriptions**: Enhanced response descriptions and data formats in API responses
* **Data Handling**: Improved data handling examples and documentation

***

## December 8, 2025

### Added

* **Rate Limiting**: Added comprehensive rate limiting functionality, integrated with subscription plans

***

## December 7, 2025

### Changed

* **Interview Validation**: Enhanced interview creation validation documentation, including XOR constraint explanations
* **Error Messages**: Improved error messages in API responses for better understanding
* **Scopes and Permissions**: Updated scopes and permissions guide with latest API key validation logic

***

## December 4, 2025

### Added

* **Transient Jobs and Agents**: Added support for transient jobs and agents in public API
* **Immediate Scheduling**: Added optional immediate scheduling functionality

***

## December 3, 2025

### Added

* **Transient Candidates**: Added support for transient candidates and jobs in interview creation

***

## December 2, 2025

### Changed

* **Job Description**: Made jobDescription field optional in job creation and updates
* **ATS Keys**: Added support for ATS keys to use companyId

***

## December 1, 2025

### Added

* **JobId Field**: Added jobId field to interview creation endpoint

### Changed

* **Validation Constraints**: Added min/max items constraints for jobIds in candidate creation