Skip to content

feat:Update openapi.yaml: add audio formats, locale, 204 responses and docs#66

Merged
HavenDV merged 1 commit intomainfrom
bot/update-openapi_202503271237
Mar 27, 2025
Merged

feat:Update openapi.yaml: add audio formats, locale, 204 responses and docs#66
HavenDV merged 1 commit intomainfrom
bot/update-openapi_202503271237

Conversation

@HavenDV
Copy link
Copy Markdown
Contributor

@HavenDV HavenDV commented Mar 27, 2025

Summary by CodeRabbit

  • New Features

    • Expanded audio output options with several additional high-quality formats.
    • Added a locale filter to support more tailored, localized requests.
    • Updated response feedback with a new indicator for successful deletion actions.
  • Documentation

    • Enhanced API descriptions and configuration details with clearer guidelines and examples for improved usability.

@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented Mar 27, 2025

Walkthrough

The changes modify the API specification in the openapi.yaml file. They add several new audio formats, a new locale query parameter, and update certain response codes to include a 204 for deletion. In addition, the component documentation is enhanced with improved descriptions, examples, and expanded widget configuration details.

Changes

File(s) Change Summary
src/libs/.../openapi.yaml - Audio Formats: Added opus_48000_32, opus_48000_64, opus_48000_96, opus_48000_128, and opus_48000_192.
- Query Parameter: Introduced locale with description, schema, and example.
- Responses: Updated to include a 204 status code for deletions and modified the 200 response.
- Components: Enhanced descriptions, examples, and widget configuration sections.

Possibly related PRs

Poem

I’m a rabbit tapping on code with glee,
New sounds and params hopping wild and free.
Formats, responses, and widgets in play,
My API dreams dance in a bright array.
With bunny beats and ASCII cheer, hooray!

Hop on, code—let’s celebrate the day!


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share
🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>, please review it.
    • Generate unit testing code for this file.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query. Examples:
    • @coderabbitai generate unit testing code for this file.
    • @coderabbitai modularize this function.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
    • @coderabbitai read src/utils.ts and generate unit testing code.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.
    • @coderabbitai help me debug CodeRabbit configuration file.

Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments.

CodeRabbit Commands (Invoked using PR comments)

  • @coderabbitai pause to pause the reviews on a PR.
  • @coderabbitai resume to resume the paused reviews.
  • @coderabbitai review to trigger an incremental review. This is useful when automatic reviews are disabled for the repository.
  • @coderabbitai full review to do a full review from scratch and review all the files again.
  • @coderabbitai summary to regenerate the summary of the PR.
  • @coderabbitai generate docstrings to generate docstrings for this PR.
  • @coderabbitai resolve resolve all the CodeRabbit review comments.
  • @coderabbitai plan to trigger planning for file edits and PR creation.
  • @coderabbitai configuration to show the current CodeRabbit configuration for the repository.
  • @coderabbitai help to get help.

Other keywords and placeholders

  • Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (.coderabbit.yaml)

  • You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
  • Please see the configuration documentation for more information.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Documentation and Community

  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

@HavenDV HavenDV merged commit 6b405e2 into main Mar 27, 2025
1 of 3 checks passed
@HavenDV HavenDV deleted the bot/update-openapi_202503271237 branch March 27, 2025 12:38
@coderabbitai coderabbitai Bot changed the title feat:@coderabbitai feat:Update openapi.yaml: add audio formats, locale, 204 responses and docs Mar 27, 2025
Copy link
Copy Markdown

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 0

🧹 Nitpick comments (2)
src/libs/ElevenLabs/openapi.yaml (2)

273-283: Audio Formats Enumeration Updates (Part 1)
New audio format values (opus_48000_32, opus_48000_64, opus_48000_96, opus_48000_128, opus_48000_192) have been added to several endpoints. The updates look consistent in the enumeration lists across multiple sections.

Also applies to: 536-546, 627-637, 717-727, 809-819, 900-910, 991-1001


17502-17633: WidgetConfig – Expanded UI Configuration
A comprehensive list of widget configuration properties (avatars, colors, fonts, text labels, borders, and more) has been added. All fields include titles, types, descriptions, defaults, and nullability where applicable. Overall, this is a well‐documented enhancement for widget customization.
(Consider verifying that the default color values match your branding guidelines.)

📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 495a833 and e3e3747.

⛔ Files ignored due to path filters (114)
  • src/libs/ElevenLabs/Generated/ElevenLabs.ConversationalAIClient.DeleteConvaiAgentsByAgentId.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.ConversationalAIClient.GetConvaiAgents.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.DubbingClient.CreateDubbing.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.IConversationalAIClient.DeleteConvaiAgentsByAgentId.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.IConversationalAIClient.GetConvaiAgents.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.IDubbingClient.CreateDubbing.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.ITextToSpeechClient.CreateTextToSpeechByVoiceId.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.ITextToSpeechClient.CreateTextToSpeechByVoiceIdStream.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.ITextToSpeechClient.CreateTextToSpeechByVoiceIdStreamWithTimestamps.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.ITextToSpeechClient.CreateTextToSpeechByVoiceIdWithTimestamps.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.IVoicesClient.GetSharedVoices.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.ASRConversationalConfig.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.AgentCallLimits.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.AgentConfigAPIModelInput.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.AgentConfigAPIModelOutput.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.AgentConfigOverride.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.AgentConfigOverrideConfig.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.AgentMetadataResponseModel.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.AgentPlatformSettingsRequestModel.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.AgentPlatformSettingsRequestModelDataCollection.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.AgentPlatformSettingsResponseModel.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.AgentPlatformSettingsResponseModelDataCollection.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.AgentSummaryResponseModel.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.AllowlistItem.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.AuthSettings.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.BodyDubAVideoOrAnAudioFileV1DubbingPost.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.BodyTextToSpeechStreamingV1TextToSpeechVoiceIdStreamPost.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.BodyTextToSpeechStreamingWithTimestampsV1TextToSpeechVoiceIdStreamWithTimestampsPost.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.BodyTextToSpeechV1TextToSpeechVoiceIdPost.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.BodyTextToSpeechWithTimestampsV1TextToSpeechVoiceIdWithTimestampsPost.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.ClientToolConfigInput.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.ClientToolConfigInputType.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.ClientToolConfigOutput.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.ClientToolConfigOutputType.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.ConversationConfig.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.ConversationInitiationClientDataConfigInput.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.ConversationInitiationClientDataConfigOutput.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.ConversationInitiationClientDataWebhook.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.ConversationInitiationClientDataWebhookRequestHeaders.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.ConversationTokenDBModel.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.ConversationalConfigAPIModelInput.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.ConversationalConfigAPIModelInputLanguagePresets.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.ConversationalConfigAPIModelOutput.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.ConversationalConfigAPIModelOutputLanguagePresets.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.CreateAgentResponseModel.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.CreatePhoneNumberResponseModel.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.CustomLLM.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.DeleteAgentV1ConvaiAgentsAgentIdDeleteResponse.Json.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.DeleteAgentV1ConvaiAgentsAgentIdDeleteResponse.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.DynamicVariablesConfig.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.DynamicVariablesConfigDynamicVariablePlaceholders.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.EmbeddingModelEnum.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.EvaluationSettings.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.GenerateAVoicePreviewFromDescriptionV1TextToVoiceCreatePreviewsPostOutputFormat.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.GetAgentLinkResponseModel.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.GetAgentResponseModel.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.GetAgentsPageResponseModel.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.GetPhoneNumberResponseModel.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.ImageAvatar.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.ImageAvatarType.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.KnowledgeBaseLocator.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.KnowledgeBaseLocatorType.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.LibraryVoiceResponseModel.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.LiteralJsonSchemaProperty.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.OrbAvatar.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.OrbAvatarType.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.PhoneNumberAgentInfo.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.PrivacyConfig.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.PromptAgentInput.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.PromptAgentOutput.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.PromptAgentOverride.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.PromptAgentOverrideConfig.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.PromptEvaluationCriteria.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.PromptEvaluationCriteriaType.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.PydanticPronunciationDictionaryVersionLocator.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.ResourceAccessInfo.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.ResourceAccessInfoRole.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.SoundGenerationV1SoundGenerationPostOutputFormat.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.SpeechToSpeechStreamingV1SpeechToSpeechVoiceIdStreamPostOutputFormat.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.SpeechToSpeechV1SpeechToSpeechVoiceIdPostOutputFormat.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.SystemToolConfig.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.SystemToolConfigType.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.TTSConversationalConfig.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.TTSConversationalConfigOverrideConfig.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.TextToSpeechStreamingV1TextToSpeechVoiceIdStreamPostOutputFormat.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.TextToSpeechStreamingWithTimestampsV1TextToSpeechVoiceIdStreamWithTimestampsPostOutputFormat.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.TextToSpeechV1TextToSpeechVoiceIdPostOutputFormat.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.TextToSpeechWithTimestampsV1TextToSpeechVoiceIdWithTimestampsPostOutputFormat.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.ToolsItem2.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.ToolsItem3.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.TurnConfig.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.URLAvatar.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.URLAvatarType.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.WebhookToolApiSchemaConfigInput.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.WebhookToolApiSchemaConfigInputMethod.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.WebhookToolApiSchemaConfigInputPathParamsSchema.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.WebhookToolApiSchemaConfigInputRequestHeaders.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.WebhookToolApiSchemaConfigOutput.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.WebhookToolApiSchemaConfigOutputMethod.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.WebhookToolApiSchemaConfigOutputPathParamsSchema.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.WebhookToolApiSchemaConfigOutputRequestHeaders.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.WebhookToolConfigInput.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.WebhookToolConfigInputType.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.WebhookToolConfigOutput.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.WebhookToolConfigOutputType.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.WidgetConfig.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.Models.WidgetConfigResponseModel.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.TextToSpeechClient.CreateTextToSpeechByVoiceId.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.TextToSpeechClient.CreateTextToSpeechByVoiceIdStream.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.TextToSpeechClient.CreateTextToSpeechByVoiceIdStreamWithTimestamps.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.TextToSpeechClient.CreateTextToSpeechByVoiceIdWithTimestamps.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/ElevenLabs.VoicesClient.GetSharedVoices.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/JsonSerializerContext.g.cs is excluded by !**/generated/**
  • src/libs/ElevenLabs/Generated/JsonSerializerContextTypes.g.cs is excluded by !**/generated/**
📒 Files selected for processing (1)
  • src/libs/ElevenLabs/openapi.yaml (82 hunks)
🔇 Additional comments (74)
src/libs/ElevenLabs/openapi.yaml (74)

1107-1117: Audio Formats Enumeration – Default Value Check
In this hunk the default value has changed to mp3_44100_192 instead of the previously used mp3_44100_128. Please verify that this change is intentional and that downstream clients will handle the new default correctly.


4551-4565: New Locale Query Parameter
A new query parameter locale has been introduced (with description, schema, and example). This addition looks clear. Verify that the intended formats (e.g. en-US) are documented elsewhere as needed.


5807-5813: Response Code Modification
The response section now includes status code 204 with the description "Agent successfully deleted". Ensure that clients do not expect a content body on 204 responses.


6001-6009: List Agents Endpoint Update
The GET operation for listing agents has updated summary, description, and a clear operationId. The documentation is concise and descriptive.


7163-7174: Enhanced ASR Input Format Example
The ASRInputFormat section now includes examples (with keywords, provider, quality, and user_input_audio_format). This additional example improves clarity.


7380-7393: Agent Configuration Enhancements
In the AgentConfigAPIModel, the properties agent_concurrency_limit and daily_limit have been enhanced with descriptive text and examples. This will help consumers understand usage and constraints.


7441-7454: AgentConfigOverride – Descriptive Update
The override schema now includes nullable string descriptions for first_message and language. The added descriptions are clear, though note that later the override flags change type.


7460-7475: AgentConfigOverride – Flag Type Change
In this hunk the properties first_message and language have changed to boolean values, with descriptions indicating they control whether overriding is allowed. Please double‐check that this change (from expected string content to boolean flags) is aligned with your API’s design.


7481-7485: Timestamp Field Clarity
The created_at_unix_secs field now has a simplified description. This minor improvement positively enhances understanding.


7497-7511: AgentPlatformSettingsRequestModel Enhancements
The request model now includes additional descriptions (e.g. “Data collection settings”) for properties. This helps clarify the purpose of the configuration.


7521-7531: AgentPlatformSettingsResponseModel Consistency
Mirroring the request model changes, the response model now includes clear descriptions. The consistency between these endpoints is good.


7544-7562: Agent Metadata Update
Additional descriptions have been provided for properties such as agent_id, name, and created_at_unix_secs in the metadata response model with an example. This update improves clarity.


7580-7584: Allowed Origin Hostname Description
The hostname field now explicitly describes the hostname of the allowed origin. This is a clear and useful addition.


7802-7814: Auth and Allowlist Configuration Updates
Enhancements have been made to the enable_auth, allowlist, and shareable_token properties for client authentication. The descriptions are complete and add context for proper usage.


8970-8977: Voice Cloning Options Update
The fields related to voice cloning (e.g. disable_voice_cloning) were updated with improved descriptions that mention BETA status. This is helpful for users to understand availability.


9587-9596: Text Normalization Parameter Enhancements (Streaming TTS)
Updates to the text normalization parameters include detailed descriptions, defaults, and examples. This additional documentation could help in setting correct latency expectations.


9683-9692: Text Normalization Parameter Updates (TTS v1)
The similar update for the Body_Text_to_speech_v1 endpoint follows the pattern from the streaming variant. It appears consistent.


9779-9788: Text Normalization Parameter Updates (TTS with Timestamps)
The changes for the Body_Text_to_speech_with_timestamps endpoint mirror the previous updates. Consistency is maintained.


9872-9881: Dubbing Transcription Settings
The Body_Transcribes_segments_v1_dubbing_resource endpoint now includes similar descriptive enhancements for text normalization parameters. This makes the API behavior clearer.


10514-10519: Client Tool Type Description Update
A description for the tool type (defaults to client) has been added. This helps clarify the role of the tool in client interactions.


10530-10541: Client Tool Response Settings
The parameters expects_response and response_timeout_secs now include richer descriptions and examples. This should assist developers in correctly configuring client tools.


10557-10564: Additional Client Tool Type Description
A similar update for another instance of tool configuration reiterates the expected type and properties. Consistency across definitions is maintained.


10573-10591: Further Client Tool Configuration Enhancements
This hunk continues detailing tools that send events to the client with updated descriptions. No issues detected.


10685-10703: Conversation Config Client Override Enhancements
The ConversationConfigClientOverride-Input now features a new client_events array with description and an example. This should help in configuring client event notifications correctly.


10982-10996: Conversation Initiation Client Data – Output Update
The output model now includes flags for custom_llm_extra_body and enable_conversation_initiation_client_data_from_webhook with defaults and descriptions. This is a useful clarification.


11001-11015: Conversation Initiation Client Data – Request Update
The corresponding request model has been updated similarly to the output. The consistency between request and response is maintained.


11059-11075: Conversation Signed URL Response Enhancements
Additional details in the ConversationSignedUrlResponseModel regarding request headers (with example) have been added. This will aid in configuring secure webhook calls.


11131-11151: Conversation Token Purpose and Details
The ConversationTokenPurpose section now includes expanded information on agent_id, token, and expiration time. The added example improves clarity.


11180-11186: Conversational Config API Model – Language Presets
The output model now includes a property for language presets with a detailed description. This enhancement should make it easier for consumers to understand how to supply or interpret language-related configuration.


11200-11206: Conversational Config API Model – Agent Submodel
The agent submodel reference has been revalidated and the language presets addition is clearly explained. Good clarity here.


11236-11242: Create Phone Number Response Update
The CreatePhoneNumberResponseModel now includes a description for the agent_id field. Small but useful documentation detail.


11248-11254: Pronunciation Dictionary Response Update
Minor descriptive updates to the CreatePronunciationDictionaryResponseModel improve understanding of the phone entity ID.


11322-11332: Chat Completions Endpoint – LLM Configuration
This hunk provides enhanced descriptions for the URL, model_id, and api_key fields in the Chat Completions configuration. The clarifications are beneficial.


11787-11795: Edit Chapter Response Model Enhancements
Additional details regarding dynamic variable placeholders have been added along with an example. This provides better guidance for API users.


11853-11859: Evaluation Success Result – Criteria Description
The EvaluationSuccessResult now includes a detailed description of individual criteria. This added context should help in understanding how evaluation success is determined.


12160-12168: Get Agent Response Model – Agent Token Details
The GetAgentResponseModel has been updated with enhanced descriptions for the agent id and conversation token. The improvements add clarity to the token’s intended usage.


12177-12187: Get Agent Response Model – Agent Name & Description
Enhanced description for agent_id and name in the GetAgentResponseModel helps clarify what each field represents.


12193-12200: Get Agents Page Response Model – Phone Numbers Listing
The schema now includes a description for the list of phone numbers associated with the agent along with an example. This is a helpful addition.


12209-12225: Audio Native Project Settings Response Updates
New fields such as next_cursor and has_more have been added with descriptive text and examples. This enhances pagination support documentation.


12601-12609: Projects Response Model – Phone Number ID Example
The GetProjectsResponseModel now includes an example for phone_number_id, which improves practical understanding.


12991-13001: Invoice Response Model – Avatar Type Description
A small update in the InvoiceResponseModel now clarifies the type for avatars, reinforcing the available options.


13064-13083: Knowledge Base Locator Enhancements
Additional descriptions for properties such as type, name, and id are now present. The example provided helps illustrate the intended structure.


13234-13244: LLM Schema Update – Locale Addition
A new locale field has been introduced along with voice language settings. Please confirm that the distinction between “language” and “locale” is well documented and that consumers know when to use each.


13363-13373: Property Descriptions for Dynamic Variables
The schema now includes more detailed descriptions for description, dynamic_variable, and other property attributes. This makes the intended usage clearer.


13377-13386: Manual Verification File Response Model Update
Additional example values and a default for constant_value have been added. This improves the overall clarity of the model.


13715-13734: PatchConvAISettingsRequest – Avatar Color and Type Updates
The PatchConvAISettingsRequest now includes fields for avatar type and additional color properties with defaults and examples. The changes are detailed and align with UI configuration needs.


13749-13760: Podcast Bulletin Mode Schema Enhancements
Descriptions for agent_id and agent_name have been added. The improved documentation should help developers use this model correctly.


13932-13963: Privacy Settings for Conversations
The privacy settings (record_voice, retention_days, delete flags, etc.) now include comprehensive descriptions and defaults. This is an important update for data retention policies.


14576-14593: PromptAgent Output – Enhanced LLM and Temperature Settings
The PromptAgent-Output section now documents fields such as prompt, llm, temperature, and max_tokens with clear descriptions and default values. This will improve LLM configuration clarity.


14598-14609: PromptAgent Tools – Discriminator Addition
The tools list now includes a discriminator mapping to clearly distinguish between client, system, and webhook tools. This enhancement reduces ambiguity in tool configuration.


14665-14706: PromptAgent Override – Configuration Enhancements
Updates to the PromptAgentOverride and its configuration provide additional clarity for prompt management. The new example is also useful.


14733-14739: Prompt Evaluation Criteria – Identification Fields
The addition of an id and refined description for the name field improves the definition of evaluation criteria.


14742-14762: Prompt Evaluation Criteria – Detailed Description
The updated prompt evaluation parameters now feature a conversation_goal_prompt and a flag for use_knowledge_base with an example. This enriches the evaluation process documentation.


14763-14888: Pronunciation Dictionary Alias Rule Request Model Update
Additional descriptive text for pronunciation_dictionary_id and version_id clarifies how to reference specific dictionary versions. The extended description is very helpful.


15091-15116: Query Parameters JSON Schema – Creator and Role Details
The QueryParamsJsonSchema now explicitly documents fields such as is_creator, creator_name, creator_email, and role along with examples. This level of detail improves API usability.


16080-16087: System Tool Type Specification
The schema now refines the allowed enum value (system) and provides a brief description. This ensures that system tools are clearly distinguished.


16092-16097: TTS Conversational Config – System Tool Clarification
The TTSConversationalConfig now includes a brief description noting it is used for calling system methods. The update is concise and useful.


16104-16110: TTS Conversational Config – Voice ID and Format Update
The inclusion of a voice_id and the reference to TTSOutputFormat in the agent_output_audio_format field provides better control over TTS settings.


16115-16149: TTS Conversational Config – Stability, Speed, and Similarity Settings
The enhancements for stability, speed, similarity_boost, and pronunciation_dictionary_locators are well documented with defaults and an example. This detailed configuration offers fine-tuning for TTS output.


16161-16168: TTS Conversational Config Override – Voice ID Flag
A new boolean flag to allow overriding the voice_id has been added. The update is straightforward and useful.


16205-16215: TurnMode Configuration Update
The TurnMode schema now includes a turn_timeout property (with default and example) and a reference to TurnMode. This addition improves real‐time conversation management.


16245-16255: Update Phone Number Request – Custom URL for Webhook
The UpdatePhoneNumberRequest now includes a custom_url field with a descriptive note. This change provides better control over webhook endpoints.


17329-17334: Webhook Configuration – URL Description Update
The webhook configuration now includes an updated description for the url field that clarifies that path parameters can be included. This is a clear enhancement.


17338-17347: Webhook Configuration – HTTP Method Options
The update provides an enumeration of HTTP methods (PATCH, DELETE) for the webhook along with descriptions. This aids in understanding the allowed methods.


17357-17375: Webhook Request Headers and Schema Enhancements
The webhook configuration now specifies that header values can be either a string or a special secret locator. The detailed example is an excellent touch.


17382-17388: WebhookToolApiSchemaConfig – Output Improvements
Minor improvements to the WebhookToolApiSchemaConfig-Output including title and required fields have been applied. The changes look sound.


17391-17404: WebhookToolApiSchemaConfig – Extended Schema Details
The extended details for path and query parameters increase clarity, especially the mapping for placeholders in URLs. This update is well executed.


17410-17429: WebhookToolConfig-Input – Example and Requirements
The input configuration for webhook tools now shows a concrete example with proper header and request body schema details. This practical example is very useful.


17439-17446: WebhookToolConfig-Input – Tool Type Specification
The tool type is clearly set to webhook with an updated description. This removes any ambiguity.


17455-17465: WebhookToolConfig-Output – Consolidated Schema
The output configuration for webhook tools is extended with dynamic_variables and clear requirements. The description now succinctly explains its purpose.


17470-17477: WebhookToolConfig-Output – Type Enforcement
This hunk reaffirms that the tool type is webhook and includes an updated default and description. The changes are straightforward.


17486-17491: WidgetConfig Introduction
The transition from webhook tool definitions to WidgetConfig is introduced here. No issues noted; the separation of concerns is clear.


17645-17700: WidgetConfigResponseModel – Detailed Response Schema
The WidgetConfigResponseModel now mirrors many of the configuration fields in WidgetConfig with similarly detailed descriptions and defaults. The consistency and completeness of this section are commendable.


17768-17796: WidgetExpandable Schema Update
The WidgetExpandable section has been updated with a clear enumeration and an example. This will help in managing widget behavior under various expansion modes.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant