> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.vapi.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.vapi.ai/_mcp/server.

# API Versioning & Infrastructure Updates

1. **API Version 2 Introduction**: Access enhanced functionality through new versioned endpoints while maintaining full backward compatibility:
   * [`/v2/call`](https://api.vapi.ai/api#:~:text=/v2/call): Enhanced call management with new features and improved response formats
   * [`/v2/phone-number`](https://api.vapi.ai/api#:~:text=/v2/phone-number): Advanced phone number management with extended capabilities

2. **Enhanced Pagination**: Improved pagination controls across all endpoints with [`PaginationMeta`](https://api.vapi.ai/api#:~:text=PaginationMeta) enhancements:
   * `createdAtGe` and `createdAtLe`: Date range filtering for creation timestamps
   * Better sorting and filtering options for large datasets
   * Enhanced metadata for pagination state management

3. **Workflow Message Configuration**: Customize voicemail handling in workflows with [`CreateWorkflowDTO.voicemailMessage`](https://api.vapi.ai/api#:~:text=CreateWorkflowDTO.voicemailMessage) and [`CreateWorkflowDTO.voicemailDetection`](https://api.vapi.ai/api#:~:text=CreateWorkflowDTO.voicemailDetection) for comprehensive call flow management.

4. **Credential Integration**: Seamless credential management across all workflow and assistant configurations with enhanced [`credentials.items.discriminator.mapping.custom-credential`](https://api.vapi.ai/api#:~:text=credentials.items.discriminator.mapping.custom-credential) support.

5. **Transport Infrastructure**: Foundation for advanced communication channels with improved transport configuration and management capabilities.

> **Info**
>
> Version 2 endpoints provide enhanced features while v1 endpoints remain fully functional. Migrate to v2 when you need access to new capabilities or improved performance characteristics.

## Infrastructure Improvements

#### Backward Compatibility

Existing v1 endpoints continue to work unchanged, ensuring smooth transitions and zero downtime for existing integrations.

#### Enhanced Filtering

Improved date range filtering and pagination controls for better data management and API performance.

#### Workflow Integration

Enhanced workflow configuration with better voicemail handling and credential management throughout the call flow.

#### Future-Ready Architecture

Foundation for advanced features and capabilities that will be built on the v2 API structure.