Skip to content

feat:Add remove_audio_tags field to AssemblyAI OpenAPI schemas#160

Merged
HavenDV merged 1 commit intomainfrom
bot/update-openapi_202603130154
Mar 13, 2026
Merged

feat:Add remove_audio_tags field to AssemblyAI OpenAPI schemas#160
HavenDV merged 1 commit intomainfrom
bot/update-openapi_202603130154

Conversation

@HavenDV
Copy link
Contributor

@HavenDV HavenDV commented Mar 13, 2026

Summary by CodeRabbit

  • New Features
    • Added optional parameter to remove audio event tags from transcripts (Universal-3-Pro models only).

@HavenDV HavenDV merged commit 6dbc18c into main Mar 13, 2026
2 of 4 checks passed
@HavenDV HavenDV deleted the bot/update-openapi_202603130154 branch March 13, 2026 01:55
@coderabbitai
Copy link

coderabbitai bot commented Mar 13, 2026

Walkthrough

This pull request adds a new optional remove_audio_tags field to OpenAPI schemas in the AssemblyAI specification. The field accepts "all" or null (with null as default) and is documented as removing audio event tags from transcript text, supported only by the Universal-3-Pro model. The field is consistently added across TranscriptOptionalParams, Transcript, and DeleteTranscriptResponse schemas.

Changes

Cohort / File(s) Summary
OpenAPI Schema Updates
src/libs/AssemblyAI/openapi.yaml
Added remove_audio_tags optional field to TranscriptOptionalParams and Transcript schemas with enum value "all" or null (default), and updated DeleteTranscriptResponse example to include the field. Field is documented as Universal-3-Pro only.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

  • AssemblyAI#123 — Modifies the same TranscriptOptionalParams schema by adding language_detection_options field, indicating parallel feature development in optional request parameters.
  • AssemblyAI#125 — Updates both TranscriptOptionalParams and Transcript schemas but removes word_boost/boost_param fields, suggesting coordinated schema refactoring across these related schemas.

Poem

🐰 Audio tags flutter away,
When remove_audio_tags says "all" in the fray,
Clean transcripts now hop and play,
Universal-3-Pro leads the way! ✨

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Title Check ✅ Passed Title check skipped as CodeRabbit has written the PR title.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch bot/update-openapi_202603130154
📝 Coding Plan
  • Generate coding plan for human review comments

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

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitai coderabbitai bot changed the title feat:@coderabbitai feat:Add remove_audio_tags field to AssemblyAI OpenAPI schemas Mar 13, 2026
Copy link

@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.

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

1578-1583: Extract remove_audio_tags into a shared component schema.

The same union definition is duplicated in both request and response models. A shared schema will reduce drift and keep SDK generation behavior consistent if this enum grows later.

♻️ Suggested refactor
@@
-        remove_audio_tags:
-          x-label: Remove audio tags
-          description: |
-            Remove [audio event tags](https://www.assemblyai.com/docs/pre-recorded-audio/universal-3-pro#audio-event-tags) from the transcript text. Set to `"all"` to remove all audio tags.
-
-            Note: This parameter is only supported for the Universal-3-Pro model.
-          oneOf:
-            - type: string
-              enum:
-                - all
-            - type: "null"
-          default: null
+        remove_audio_tags:
+          x-label: Remove audio tags
+          description: |
+            Remove [audio event tags](https://www.assemblyai.com/docs/pre-recorded-audio/universal-3-pro#audio-event-tags) from the transcript text. Set to `"all"` to remove all audio tags.
+
+            Note: This parameter is only supported for the Universal-3-Pro model.
+          $ref: "#/components/schemas/RemoveAudioTags"
@@
-        remove_audio_tags:
-          x-label: Remove audio tags
-          description: |
-            Whether [audio event tags](https://www.assemblyai.com/docs/pre-recorded-audio/universal-3-pro#audio-event-tags) were removed from the transcript text.
-
-            Note: This parameter is only supported for the Universal-3-Pro model.
-          oneOf:
-            - type: string
-              enum:
-                - all
-            - type: "null"
+        remove_audio_tags:
+          x-label: Remove audio tags
+          description: |
+            Whether [audio event tags](https://www.assemblyai.com/docs/pre-recorded-audio/universal-3-pro#audio-event-tags) were removed from the transcript text.
+
+            Note: This parameter is only supported for the Universal-3-Pro model.
+          $ref: "#/components/schemas/RemoveAudioTags"
@@
+    RemoveAudioTags:
+      oneOf:
+        - type: string
+          enum:
+            - all
+        - type: "null"

Also applies to: 3073-3078

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@src/libs/AssemblyAI/openapi.yaml` around lines 1578 - 1583, Create a shared
component schema named something like RemoveAudioTags under components.schemas
that contains the oneOf union (type: string with enum: ["all"] and type: "null")
and default: null; then replace the duplicated inline definitions for
remove_audio_tags in both the request and response models with a $ref to this
new components.schemas.RemoveAudioTags (ensure the schema name matches
references and update any swagger/openapi references accordingly so SDK
generation uses the shared component).

3069-3071: Clarify Transcript.remove_audio_tags semantics in the description.

The current wording reads like a boolean outcome, but the actual value is "all" or null. A slightly more explicit description will reduce SDK/docs confusion.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@src/libs/AssemblyAI/openapi.yaml` around lines 3069 - 3071, Update the
OpenAPI description for the Transcript.remove_audio_tags property to accurately
reflect its semantics: state that the field is not a boolean but holds the
string "all" when all audio event tags were removed and null when no tags were
removed (or when the information is unavailable). Locate the
Transcript.remove_audio_tags entry in src/libs/AssemblyAI/openapi.yaml and
replace the existing description with a concise sentence that explicitly
documents the two possible values ("all" or null) and what each means.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Nitpick comments:
In `@src/libs/AssemblyAI/openapi.yaml`:
- Around line 1578-1583: Create a shared component schema named something like
RemoveAudioTags under components.schemas that contains the oneOf union (type:
string with enum: ["all"] and type: "null") and default: null; then replace the
duplicated inline definitions for remove_audio_tags in both the request and
response models with a $ref to this new components.schemas.RemoveAudioTags
(ensure the schema name matches references and update any swagger/openapi
references accordingly so SDK generation uses the shared component).
- Around line 3069-3071: Update the OpenAPI description for the
Transcript.remove_audio_tags property to accurately reflect its semantics: state
that the field is not a boolean but holds the string "all" when all audio event
tags were removed and null when no tags were removed (or when the information is
unavailable). Locate the Transcript.remove_audio_tags entry in
src/libs/AssemblyAI/openapi.yaml and replace the existing description with a
concise sentence that explicitly documents the two possible values ("all" or
null) and what each means.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: eaac9e8d-641a-4970-83f1-dc688d63bbd4

📥 Commits

Reviewing files that changed from the base of the PR and between e018073 and 8cce423.

⛔ Files ignored due to path filters (11)
  • src/libs/AssemblyAI/Generated/AssemblyAI..JsonSerializerContext.g.cs is excluded by !**/generated/**
  • src/libs/AssemblyAI/Generated/AssemblyAI.JsonConverters.TranscriptOptionalParamsRemoveAudioTags.g.cs is excluded by !**/generated/**
  • src/libs/AssemblyAI/Generated/AssemblyAI.JsonConverters.TranscriptOptionalParamsRemoveAudioTagsNullable.g.cs is excluded by !**/generated/**
  • src/libs/AssemblyAI/Generated/AssemblyAI.JsonConverters.TranscriptRemoveAudioTags.g.cs is excluded by !**/generated/**
  • src/libs/AssemblyAI/Generated/AssemblyAI.JsonConverters.TranscriptRemoveAudioTagsNullable.g.cs is excluded by !**/generated/**
  • src/libs/AssemblyAI/Generated/AssemblyAI.JsonSerializerContextTypes.g.cs is excluded by !**/generated/**
  • src/libs/AssemblyAI/Generated/AssemblyAI.Models.Transcript.g.cs is excluded by !**/generated/**
  • src/libs/AssemblyAI/Generated/AssemblyAI.Models.TranscriptOptionalParams.g.cs is excluded by !**/generated/**
  • src/libs/AssemblyAI/Generated/AssemblyAI.Models.TranscriptOptionalParamsRemoveAudioTags.g.cs is excluded by !**/generated/**
  • src/libs/AssemblyAI/Generated/AssemblyAI.Models.TranscriptParams.g.cs is excluded by !**/generated/**
  • src/libs/AssemblyAI/Generated/AssemblyAI.Models.TranscriptRemoveAudioTags.g.cs is excluded by !**/generated/**
📒 Files selected for processing (1)
  • src/libs/AssemblyAI/openapi.yaml

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