v2.1.217

AI Hosting Plan & Key Management Updates

This release significantly expands the AI Hosting client capabilities with full plan lifecycle management, enhanced key filtering, and pagination support. Customers and projects can now easily declare hosting profiles, retrieve specific or list all plans with usage statistics, and rename existing plans. Key management operations have been updated to enforce plan association and support advanced querying.

New Endpoints

• Profile Declaration: customerDeclareProfile - Creates an AI hosting profile and accepts the current model terms for a customer.
• Plan Retrieval (Customer): customerGetPlan retrieves details for a specific plan by planId. customerGetPlans lists all AI hosting plans with current usage.
• Plan Updates (Customer): customerUpdatePlan allows renaming or updating the description of an AI hosting plan.
• Plan Retrieval (Project): projectGetPlan and projectGetPlans provide the same plan detail and listing capabilities scoped to projects.

API Enhancements

• Mandatory Plan Association: planId is now a required parameter for CustomerCreateKey and ProjectCreateKey operations.
• Targeted Key Retrieval: CustomerGetKeys and ProjectGetKeys now support filtering keys by planId.
• Pagination Support: Key retrieval endpoints (CustomerGetKeys, ProjectGetKeys) and plan listing endpoints now accept limit, skip, and page query parameters for efficient data handling.
• Schema Alignment: CustomerGetUsageOKResponse now correctly maps to the updated CustomerPlan schema instead of the legacy PlanOptions type.

Deprecations

• customerGetUsage and projectGetUsage are deprecated. These legacy endpoints should be replaced with the new plan-specific routes: /v2/customers/{customerId}/ai-hostings and /v2/projects/{projectId}/ai-hostings. Existing integrations will continue to function but will begin emitting deprecation notices.