Merge pull request #25 from AssemblyAI/fern-bot/11-16-2023-0526PM

🌿 Fern Regeneration -- November 16, 2023

Author: Swimburger

build.gradle

@@ -47,7 +47,7 @@ publishing {
         maven(MavenPublication) {
             groupId = 'com.assemblyai'
             artifactId = 'assemblyai-java'
-            version = '0.0.5-beta4'
+            version = '0.0.5-beta5'
             from components.java
         }
     }

src/main/java/com/assemblyai/api/core/ClientOptions.java

@@ -29,7 +29,7 @@ private ClientOptions(
                 "X-Fern-SDK-Name",
                 "com.assemblyai.fern:api-sdk",
                 "X-Fern-SDK-Version",
-                "0.0.5-beta4",
+                "0.0.5-beta5",
                 "X-Fern-Language",
                 "JAVA"));
         this.headerSuppliers = headerSuppliers;

src/main/java/com/assemblyai/api/resources/files/FilesClient.java

@@ -23,7 +23,7 @@ public FilesClient(ClientOptions clientOptions) {
     }
 
     /**
-     * Upload your audio or video file directly to the AssemblyAI API if it isn't accessible via a URL already.
+     * Upload your media file directly to the AssemblyAI API if it isn't accessible via a URL already.
      */
     public UploadedFile upload(byte[] request, RequestOptions requestOptions) {
         HttpUrl httpUrl = HttpUrl.parse(this.clientOptions.environment().getUrl())
@@ -52,7 +52,7 @@ public UploadedFile upload(byte[] request, RequestOptions requestOptions) {
     }
 
     /**
-     * Upload your audio or video file directly to the AssemblyAI API if it isn't accessible via a URL already.
+     * Upload your media file directly to the AssemblyAI API if it isn't accessible via a URL already.
      */
     public UploadedFile upload(byte[] request) {
         return upload(request, null);

src/main/java/com/assemblyai/api/resources/lemur/LemurClient.java

@@ -31,6 +31,13 @@ public LemurClient(ClientOptions clientOptions) {
         this.clientOptions = clientOptions;
     }
 
+    /**
+     * Custom Summary allows you to distill a piece of audio into a few impactful sentences. You can give the model context to obtain more targeted results while outputting the results in a variety of formats described in human language.
+     */
+    public LemurSummaryResponse summary() {
+        return summary(LemurSummaryParameters.builder().build());
+    }
+
     /**
      * Custom Summary allows you to distill a piece of audio into a few impactful sentences. You can give the model context to obtain more targeted results while outputting the results in a variety of formats described in human language.
      */
@@ -116,6 +123,13 @@ public LemurQuestionAnswerResponse questionAnswer(LemurQuestionAnswerParameters
         return questionAnswer(request, null);
     }
 
+    /**
+     * Use LeMUR to generate a list of Action Items from a transcript
+     */
+    public LemurActionItemsResponse actionItems() {
+        return actionItems(LemurBaseParameters.builder().build());
+    }
+
     /**
      * Use LeMUR to generate a list of Action Items from a transcript
      */
@@ -159,7 +173,7 @@ public LemurActionItemsResponse actionItems(LemurBaseParameters request) {
     }
 
     /**
-     * Use LeMUR to ask anything with Custom Task
+     * Use your own prompt to run a Custom Task to handle your specialized task.
      */
     public LemurTaskResponse task(LemurTaskParameters request, RequestOptions requestOptions) {
         HttpUrl httpUrl = HttpUrl.parse(this.clientOptions.environment().getUrl())
@@ -194,7 +208,7 @@ public LemurTaskResponse task(LemurTaskParameters request, RequestOptions reques
     }
 
     /**
-     * Use LeMUR to ask anything with Custom Task
+     * Use your own prompt to run a Custom Task to handle your specialized task.
      */
     public LemurTaskResponse task(LemurTaskParameters request) {
         return task(request, null);

src/main/java/com/assemblyai/api/resources/lemur/requests/LemurQuestionAnswerParameters.java

@@ -26,7 +26,9 @@
 @JsonInclude(JsonInclude.Include.NON_EMPTY)
 @JsonDeserialize(builder = LemurQuestionAnswerParameters.Builder.class)
 public final class LemurQuestionAnswerParameters implements ILemurBaseParameters {
-    private final List<String> transcriptIds;
+    private final Optional<List<String>> transcriptIds;
+
+    private final Optional<String> inputText;
 
     private final Optional<LemurBaseParametersContext> context;
 
@@ -41,14 +43,16 @@ public final class LemurQuestionAnswerParameters implements ILemurBaseParameters
     private final Map<String, Object> additionalProperties;
 
     private LemurQuestionAnswerParameters(
-            List<String> transcriptIds,
+            Optional<List<String>> transcriptIds,
+            Optional<String> inputText,
             Optional<LemurBaseParametersContext> context,
             Optional<LemurModel> finalModel,
             Optional<Integer> maxOutputSize,
             Optional<Double> temperature,
             List<LemurQuestion> questions,
             Map<String, Object> additionalProperties) {
         this.transcriptIds = transcriptIds;
+        this.inputText = inputText;
         this.context = context;
         this.finalModel = finalModel;
         this.maxOutputSize = maxOutputSize;
@@ -58,14 +62,25 @@ private LemurQuestionAnswerParameters(
     }
 
     /**
-     * @return A list of completed transcripts with text. Up to 100 files max, or 100 hours max. Whichever is lower.
+     * @return A list of completed transcripts with text. Up to a maximum of 100 files or 100 hours, whichever is lower.
+     * Use either transcript_ids or input_text as input into LeMUR.
      */
     @JsonProperty("transcript_ids")
     @Override
-    public List<String> getTranscriptIds() {
+    public Optional<List<String>> getTranscriptIds() {
         return transcriptIds;
     }
 
+    /**
+     * @return Custom formatted transcript data. Maximum size is the context limit of the selected model, which defaults to 100000.
+     * Use either transcript_ids or input_text as input into LeMUR.
+     */
+    @JsonProperty("input_text")
+    @Override
+    public Optional<String> getInputText() {
+        return inputText;
+    }
+
     /**
      * @return Context to provide the model. This can be a string or a free-form JSON value.
      */
@@ -82,7 +97,7 @@ public Optional<LemurModel> getFinalModel() {
     }
 
     /**
-     * @return Max output size in tokens. Up to 4000 allowed.
+     * @return Max output size in tokens, up to 4000
      */
     @JsonProperty("max_output_size")
     @Override
@@ -102,7 +117,7 @@ public Optional<Double> getTemperature() {
     }
 
     /**
-     * @return A list of questions to ask.
+     * @return A list of questions to ask
      */
     @JsonProperty("questions")
     public List<LemurQuestion> getQuestions() {
@@ -122,6 +137,7 @@ public Map<String, Object> getAdditionalProperties() {
 
     private boolean equalTo(LemurQuestionAnswerParameters other) {
         return transcriptIds.equals(other.transcriptIds)
+                && inputText.equals(other.inputText)
                 && context.equals(other.context)
                 && finalModel.equals(other.finalModel)
                 && maxOutputSize.equals(other.maxOutputSize)
@@ -133,6 +149,7 @@ private boolean equalTo(LemurQuestionAnswerParameters other) {
     public int hashCode() {
         return Objects.hash(
                 this.transcriptIds,
+                this.inputText,
                 this.context,
                 this.finalModel,
                 this.maxOutputSize,
@@ -151,7 +168,9 @@ public static Builder builder() {
 
     @JsonIgnoreProperties(ignoreUnknown = true)
     public static final class Builder {
-        private List<String> transcriptIds = new ArrayList<>();
+        private Optional<List<String>> transcriptIds = Optional.empty();
+
+        private Optional<String> inputText = Optional.empty();
 
         private Optional<LemurBaseParametersContext> context = Optional.empty();
 
@@ -170,6 +189,7 @@ private Builder() {}
 
         public Builder from(LemurQuestionAnswerParameters other) {
             transcriptIds(other.getTranscriptIds());
+            inputText(other.getInputText());
             context(other.getContext());
             finalModel(other.getFinalModel());
             maxOutputSize(other.getMaxOutputSize());
@@ -179,19 +199,24 @@ public Builder from(LemurQuestionAnswerParameters other) {
         }
 
         @JsonSetter(value = "transcript_ids", nulls = Nulls.SKIP)
+        public Builder transcriptIds(Optional<List<String>> transcriptIds) {
+            this.transcriptIds = transcriptIds;
+            return this;
+        }
+
         public Builder transcriptIds(List<String> transcriptIds) {
-            this.transcriptIds.clear();
-            this.transcriptIds.addAll(transcriptIds);
+            this.transcriptIds = Optional.of(transcriptIds);
             return this;
         }
 
-        public Builder addTranscriptIds(String transcriptIds) {
-            this.transcriptIds.add(transcriptIds);
+        @JsonSetter(value = "input_text", nulls = Nulls.SKIP)
+        public Builder inputText(Optional<String> inputText) {
+            this.inputText = inputText;
             return this;
         }
 
-        public Builder addAllTranscriptIds(List<String> transcriptIds) {
-            this.transcriptIds.addAll(transcriptIds);
+        public Builder inputText(String inputText) {
+            this.inputText = Optional.of(inputText);
             return this;
         }
 
@@ -258,7 +283,14 @@ public Builder addAllQuestions(List<LemurQuestion> questions) {
 
         public LemurQuestionAnswerParameters build() {
             return new LemurQuestionAnswerParameters(
-                    transcriptIds, context, finalModel, maxOutputSize, temperature, questions, additionalProperties);
+                    transcriptIds,
+                    inputText,
+                    context,
+                    finalModel,
+                    maxOutputSize,
+                    temperature,
+                    questions,
+                    additionalProperties);
         }
     }
 }

src/main/java/com/assemblyai/api/resources/lemur/requests/LemurSummaryParameters.java

@@ -15,7 +15,6 @@
 import com.fasterxml.jackson.annotation.JsonSetter;
 import com.fasterxml.jackson.annotation.Nulls;
 import com.fasterxml.jackson.databind.annotation.JsonDeserialize;
-import java.util.ArrayList;
 import java.util.HashMap;
 import java.util.List;
 import java.util.Map;
@@ -25,7 +24,9 @@
 @JsonInclude(JsonInclude.Include.NON_EMPTY)
 @JsonDeserialize(builder = LemurSummaryParameters.Builder.class)
 public final class LemurSummaryParameters implements ILemurBaseParameters {
-    private final List<String> transcriptIds;
+    private final Optional<List<String>> transcriptIds;
+
+    private final Optional<String> inputText;
 
     private final Optional<LemurBaseParametersContext> context;
 
@@ -40,14 +41,16 @@ public final class LemurSummaryParameters implements ILemurBaseParameters {
     private final Map<String, Object> additionalProperties;
 
     private LemurSummaryParameters(
-            List<String> transcriptIds,
+            Optional<List<String>> transcriptIds,
+            Optional<String> inputText,
             Optional<LemurBaseParametersContext> context,
             Optional<LemurModel> finalModel,
             Optional<Integer> maxOutputSize,
             Optional<Double> temperature,
             Optional<String> answerFormat,
             Map<String, Object> additionalProperties) {
         this.transcriptIds = transcriptIds;
+        this.inputText = inputText;
         this.context = context;
         this.finalModel = finalModel;
         this.maxOutputSize = maxOutputSize;
@@ -57,14 +60,25 @@ private LemurSummaryParameters(
     }
 
     /**
-     * @return A list of completed transcripts with text. Up to 100 files max, or 100 hours max. Whichever is lower.
+     * @return A list of completed transcripts with text. Up to a maximum of 100 files or 100 hours, whichever is lower.
+     * Use either transcript_ids or input_text as input into LeMUR.
      */
     @JsonProperty("transcript_ids")
     @Override
-    public List<String> getTranscriptIds() {
+    public Optional<List<String>> getTranscriptIds() {
         return transcriptIds;
     }
 
+    /**
+     * @return Custom formatted transcript data. Maximum size is the context limit of the selected model, which defaults to 100000.
+     * Use either transcript_ids or input_text as input into LeMUR.
+     */
+    @JsonProperty("input_text")
+    @Override
+    public Optional<String> getInputText() {
+        return inputText;
+    }
+
     /**
      * @return Context to provide the model. This can be a string or a free-form JSON value.
      */
@@ -81,7 +95,7 @@ public Optional<LemurModel> getFinalModel() {
     }
 
     /**
-     * @return Max output size in tokens. Up to 4000 allowed.
+     * @return Max output size in tokens, up to 4000
      */
     @JsonProperty("max_output_size")
     @Override
@@ -121,6 +135,7 @@ public Map<String, Object> getAdditionalProperties() {
 
     private boolean equalTo(LemurSummaryParameters other) {
         return transcriptIds.equals(other.transcriptIds)
+                && inputText.equals(other.inputText)
                 && context.equals(other.context)
                 && finalModel.equals(other.finalModel)
                 && maxOutputSize.equals(other.maxOutputSize)
@@ -132,6 +147,7 @@ private boolean equalTo(LemurSummaryParameters other) {
     public int hashCode() {
         return Objects.hash(
                 this.transcriptIds,
+                this.inputText,
                 this.context,
                 this.finalModel,
                 this.maxOutputSize,
@@ -150,7 +166,9 @@ public static Builder builder() {
 
     @JsonIgnoreProperties(ignoreUnknown = true)
     public static final class Builder {
-        private List<String> transcriptIds = new ArrayList<>();
+        private Optional<List<String>> transcriptIds = Optional.empty();
+
+        private Optional<String> inputText = Optional.empty();
 
         private Optional<LemurBaseParametersContext> context = Optional.empty();
 
@@ -169,6 +187,7 @@ private Builder() {}
 
         public Builder from(LemurSummaryParameters other) {
             transcriptIds(other.getTranscriptIds());
+            inputText(other.getInputText());
             context(other.getContext());
             finalModel(other.getFinalModel());
             maxOutputSize(other.getMaxOutputSize());
@@ -178,19 +197,24 @@ public Builder from(LemurSummaryParameters other) {
         }
 
         @JsonSetter(value = "transcript_ids", nulls = Nulls.SKIP)
+        public Builder transcriptIds(Optional<List<String>> transcriptIds) {
+            this.transcriptIds = transcriptIds;
+            return this;
+        }
+
         public Builder transcriptIds(List<String> transcriptIds) {
-            this.transcriptIds.clear();
-            this.transcriptIds.addAll(transcriptIds);
+            this.transcriptIds = Optional.of(transcriptIds);
             return this;
         }
 
-        public Builder addTranscriptIds(String transcriptIds) {
-            this.transcriptIds.add(transcriptIds);
+        @JsonSetter(value = "input_text", nulls = Nulls.SKIP)
+        public Builder inputText(Optional<String> inputText) {
+            this.inputText = inputText;
             return this;
         }
 
-        public Builder addAllTranscriptIds(List<String> transcriptIds) {
-            this.transcriptIds.addAll(transcriptIds);
+        public Builder inputText(String inputText) {
+            this.inputText = Optional.of(inputText);
             return this;
         }
 
@@ -251,7 +275,14 @@ public Builder answerFormat(String answerFormat) {
 
         public LemurSummaryParameters build() {
             return new LemurSummaryParameters(
-                    transcriptIds, context, finalModel, maxOutputSize, temperature, answerFormat, additionalProperties);
+                    transcriptIds,
+                    inputText,
+                    context,
+                    finalModel,
+                    maxOutputSize,
+                    temperature,
+                    answerFormat,
+                    additionalProperties);
         }
     }
 }

src/main/java/com/assemblyai/api/resources/lemur/requests/LemurTaskParameters.java

@@ -15,7 +15,6 @@
 import com.fasterxml.jackson.annotation.JsonSetter;
 import com.fasterxml.jackson.annotation.Nulls;
 import com.fasterxml.jackson.databind.annotation.JsonDeserialize;
-import java.util.ArrayList;
 import java.util.HashMap;
 import java.util.List;
 import java.util.Map;
@@ -25,7 +24,9 @@
 @JsonInclude(JsonInclude.Include.NON_EMPTY)
 @JsonDeserialize(builder = LemurTaskParameters.Builder.class)
 public final class LemurTaskParameters implements ILemurBaseParameters {
-    private final List<String> transcriptIds;
+    private final Optional<List<String>> transcriptIds;
+
+    private final Optional<String> inputText;
 
     private final Optional<LemurBaseParametersContext> context;
 
@@ -40,14 +41,16 @@ public final class LemurTaskParameters implements ILemurBaseParameters {
     private final Map<String, Object> additionalProperties;
 
     private LemurTaskParameters(
-            List<String> transcriptIds,
+            Optional<List<String>> transcriptIds,
+            Optional<String> inputText,
             Optional<LemurBaseParametersContext> context,
             Optional<LemurModel> finalModel,
             Optional<Integer> maxOutputSize,
             Optional<Double> temperature,
             String prompt,
             Map<String, Object> additionalProperties) {
         this.transcriptIds = transcriptIds;
+        this.inputText = inputText;
         this.context = context;
         this.finalModel = finalModel;
         this.maxOutputSize = maxOutputSize;
@@ -57,14 +60,25 @@ private LemurTaskParameters(
     }
 
     /**
-     * @return A list of completed transcripts with text. Up to 100 files max, or 100 hours max. Whichever is lower.
+     * @return A list of completed transcripts with text. Up to a maximum of 100 files or 100 hours, whichever is lower.
+     * Use either transcript_ids or input_text as input into LeMUR.
      */
     @JsonProperty("transcript_ids")
     @Override
-    public List<String> getTranscriptIds() {
+    public Optional<List<String>> getTranscriptIds() {
         return transcriptIds;
     }
 
+    /**
+     * @return Custom formatted transcript data. Maximum size is the context limit of the selected model, which defaults to 100000.
+     * Use either transcript_ids or input_text as input into LeMUR.
+     */
+    @JsonProperty("input_text")
+    @Override
+    public Optional<String> getInputText() {
+        return inputText;
+    }
+
     /**
      * @return Context to provide the model. This can be a string or a free-form JSON value.
      */
@@ -81,7 +95,7 @@ public Optional<LemurModel> getFinalModel() {
     }
 
     /**
-     * @return Max output size in tokens. Up to 4000 allowed.
+     * @return Max output size in tokens, up to 4000
      */
     @JsonProperty("max_output_size")
     @Override
@@ -121,6 +135,7 @@ public Map<String, Object> getAdditionalProperties() {
 
     private boolean equalTo(LemurTaskParameters other) {
         return transcriptIds.equals(other.transcriptIds)
+                && inputText.equals(other.inputText)
                 && context.equals(other.context)
                 && finalModel.equals(other.finalModel)
                 && maxOutputSize.equals(other.maxOutputSize)
@@ -131,7 +146,13 @@ private boolean equalTo(LemurTaskParameters other) {
     @Override
     public int hashCode() {
         return Objects.hash(
-                this.transcriptIds, this.context, this.finalModel, this.maxOutputSize, this.temperature, this.prompt);
+                this.transcriptIds,
+                this.inputText,
+                this.context,
+                this.finalModel,
+                this.maxOutputSize,
+                this.temperature,
+                this.prompt);
     }
 
     @Override
@@ -152,11 +173,13 @@ public interface PromptStage {
     public interface _FinalStage {
         LemurTaskParameters build();
 
+        _FinalStage transcriptIds(Optional<List<String>> transcriptIds);
+
         _FinalStage transcriptIds(List<String> transcriptIds);
 
-        _FinalStage addTranscriptIds(String transcriptIds);
+        _FinalStage inputText(Optional<String> inputText);
 
-        _FinalStage addAllTranscriptIds(List<String> transcriptIds);
+        _FinalStage inputText(String inputText);
 
         _FinalStage context(Optional<LemurBaseParametersContext> context);
 
@@ -187,7 +210,9 @@ public static final class Builder implements PromptStage, _FinalStage {
 
         private Optional<LemurBaseParametersContext> context = Optional.empty();
 
-        private List<String> transcriptIds = new ArrayList<>();
+        private Optional<String> inputText = Optional.empty();
+
+        private Optional<List<String>> transcriptIds = Optional.empty();
 
         @JsonAnySetter
         private Map<String, Object> additionalProperties = new HashMap<>();
@@ -197,6 +222,7 @@ private Builder() {}
         @Override
         public Builder from(LemurTaskParameters other) {
             transcriptIds(other.getTranscriptIds());
+            inputText(other.getInputText());
             context(other.getContext());
             finalModel(other.getFinalModel());
             maxOutputSize(other.getMaxOutputSize());
@@ -236,7 +262,7 @@ public _FinalStage temperature(Optional<Double> temperature) {
         }
 
         /**
-         * <p>Max output size in tokens. Up to 4000 allowed.</p>
+         * <p>Max output size in tokens, up to 4000</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override
@@ -283,37 +309,52 @@ public _FinalStage context(Optional<LemurBaseParametersContext> context) {
         }
 
         /**
-         * <p>A list of completed transcripts with text. Up to 100 files max, or 100 hours max. Whichever is lower.</p>
+         * <p>Custom formatted transcript data. Maximum size is the context limit of the selected model, which defaults to 100000.
+         * Use either transcript_ids or input_text as input into LeMUR.</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override
-        public _FinalStage addAllTranscriptIds(List<String> transcriptIds) {
-            this.transcriptIds.addAll(transcriptIds);
+        public _FinalStage inputText(String inputText) {
+            this.inputText = Optional.of(inputText);
+            return this;
+        }
+
+        @Override
+        @JsonSetter(value = "input_text", nulls = Nulls.SKIP)
+        public _FinalStage inputText(Optional<String> inputText) {
+            this.inputText = inputText;
             return this;
         }
 
         /**
-         * <p>A list of completed transcripts with text. Up to 100 files max, or 100 hours max. Whichever is lower.</p>
+         * <p>A list of completed transcripts with text. Up to a maximum of 100 files or 100 hours, whichever is lower.
+         * Use either transcript_ids or input_text as input into LeMUR.</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override
-        public _FinalStage addTranscriptIds(String transcriptIds) {
-            this.transcriptIds.add(transcriptIds);
+        public _FinalStage transcriptIds(List<String> transcriptIds) {
+            this.transcriptIds = Optional.of(transcriptIds);
             return this;
         }
 
         @Override
         @JsonSetter(value = "transcript_ids", nulls = Nulls.SKIP)
-        public _FinalStage transcriptIds(List<String> transcriptIds) {
-            this.transcriptIds.clear();
-            this.transcriptIds.addAll(transcriptIds);
+        public _FinalStage transcriptIds(Optional<List<String>> transcriptIds) {
+            this.transcriptIds = transcriptIds;
             return this;
         }
 
         @Override
         public LemurTaskParameters build() {
             return new LemurTaskParameters(
-                    transcriptIds, context, finalModel, maxOutputSize, temperature, prompt, additionalProperties);
+                    transcriptIds,
+                    inputText,
+                    context,
+                    finalModel,
+                    maxOutputSize,
+                    temperature,
+                    prompt,
+                    additionalProperties);
         }
     }
 }

src/main/java/com/assemblyai/api/resources/realtime/requests/CreateRealtimeTemporaryTokenParameters.java

@@ -28,7 +28,7 @@ private CreateRealtimeTemporaryTokenParameters(int expiresIn, Map<String, Object
     }
 
     /**
-     * @return The amount of time until the token expires in seconds.
+     * @return The amount of time until the token expires in seconds
      */
     @JsonProperty("expires_in")
     public int getExpiresIn() {
@@ -91,7 +91,7 @@ public Builder from(CreateRealtimeTemporaryTokenParameters other) {
         }
 
         /**
-         * <p>The amount of time until the token expires in seconds.</p>
+         * <p>The amount of time until the token expires in seconds</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override

src/main/java/com/assemblyai/api/resources/transcript/TranscriptClient.java

@@ -34,14 +34,14 @@ public TranscriptClient(ClientOptions clientOptions) {
     }
 
     /**
-     * Retrieve a list of transcripts you have created.
+     * Retrieve a list of transcripts you created
      */
     public TranscriptList list() {
         return list(TranscriptListRequest.builder().build());
     }
 
     /**
-     * Retrieve a list of transcripts you have created.
+     * Retrieve a list of transcripts you created
      */
     public TranscriptList list(TranscriptListRequest request, RequestOptions requestOptions) {
         HttpUrl.Builder httpUrl = HttpUrl.parse(this.clientOptions.environment().getUrl())
@@ -87,7 +87,7 @@ public TranscriptList list(TranscriptListRequest request, RequestOptions request
     }
 
     /**
-     * Retrieve a list of transcripts you have created.
+     * Retrieve a list of transcripts you created
      */
     public TranscriptList list(TranscriptListRequest request) {
         return list(request, null);
@@ -384,7 +384,7 @@ public WordSearchResponse wordSearch(String transcriptId, TranscriptWordSearchRe
     }
 
     /**
-     * Retrieves the redacted audio object containing the status and URL to the redacted audio.
+     * Retrieve the redacted audio object containing the status and URL to the redacted audio.
      */
     public RedactedAudioResponse getRedactedAudio(String transcriptId, RequestOptions requestOptions) {
         HttpUrl httpUrl = HttpUrl.parse(this.clientOptions.environment().getUrl())
@@ -414,7 +414,7 @@ public RedactedAudioResponse getRedactedAudio(String transcriptId, RequestOption
     }
 
     /**
-     * Retrieves the redacted audio object containing the status and URL to the redacted audio.
+     * Retrieve the redacted audio object containing the status and URL to the redacted audio.
      */
     public RedactedAudioResponse getRedactedAudio(String transcriptId) {
         return getRedactedAudio(transcriptId, null);

src/main/java/com/assemblyai/api/resources/transcript/requests/CreateTranscriptParameters.java

@@ -176,18 +176,14 @@ private CreateTranscriptParameters(
         this.additionalProperties = additionalProperties;
     }
 
-    /**
-     * @return The language of your audio file. Possible values are found in <a href="https://www.assemblyai.com/docs/Concepts/supported_languages">Supported Languages</a>.
-     * The default value is 'en_us'.
-     */
     @JsonProperty("language_code")
     @Override
     public Optional<TranscriptLanguageCode> getLanguageCode() {
         return languageCode;
     }
 
     /**
-     * @return Enable Automatic Punctuation, can be true or false.
+     * @return Enable Automatic Punctuation, can be true or false
      */
     @JsonProperty("punctuate")
     @Override
@@ -196,7 +192,7 @@ public Optional<Boolean> getPunctuate() {
     }
 
     /**
-     * @return Enable Text Formatting, can be true or false.
+     * @return Enable Text Formatting, can be true or false
      */
     @JsonProperty("format_text")
     @Override
@@ -205,7 +201,7 @@ public Optional<Boolean> getFormatText() {
     }
 
     /**
-     * @return Enable <a href="https://assemblyai.com/docs/Models/speech_recognition#dual-channel-transcription">Dual Channel</a> transcription, can be true or false.
+     * @return Enable <a href="https://assemblyai.com/docs/Models/speech_recognition#dual-channel-transcription">Dual Channel</a> transcription, can be true or false
      */
     @JsonProperty("dual_channel")
     @Override
@@ -214,7 +210,7 @@ public Optional<Boolean> getDualChannel() {
     }
 
     /**
-     * @return The URL to which we send webhooks upon trancription completion, if provided in the transcription request.
+     * @return The URL to which AssemblyAI send webhooks upon trancription completion
      */
     @JsonProperty("webhook_url")
     @Override
@@ -223,7 +219,7 @@ public Optional<String> getWebhookUrl() {
     }
 
     /**
-     * @return The header name which should be sent back with webhook calls, if provided in the transcription request.
+     * @return The header name which should be sent back with webhook calls
      */
     @JsonProperty("webhook_auth_header_name")
     @Override
@@ -232,7 +228,7 @@ public Optional<String> getWebhookAuthHeaderName() {
     }
 
     /**
-     * @return Defaults to null. Optionally allows a user to specify a header name and value to send back with a webhook call for added security.
+     * @return Specify a header name and value to send back with a webhook call for added security
      */
     @JsonProperty("webhook_auth_header_value")
     @Override
@@ -241,7 +237,7 @@ public Optional<String> getWebhookAuthHeaderValue() {
     }
 
     /**
-     * @return Whether Key Phrases was enabled in the transcription request, either true or false
+     * @return Whether Key Phrases is enabled, either true or false
      */
     @JsonProperty("auto_highlights")
     @Override
@@ -250,7 +246,7 @@ public Optional<Boolean> getAutoHighlights() {
     }
 
     /**
-     * @return The point in time, in milliseconds, to begin transcription from in your media file
+     * @return The point in time, in milliseconds, to begin transcribing in your media file
      */
     @JsonProperty("audio_start_from")
     @Override
@@ -268,7 +264,7 @@ public Optional<Integer> getAudioEndAt() {
     }
 
     /**
-     * @return The list of custom vocabulary to boost transcription probability for, if provided in the transcription request.
+     * @return The list of custom vocabulary to boost transcription probability for
      */
     @JsonProperty("word_boost")
     @Override
@@ -277,7 +273,7 @@ public Optional<List<String>> getWordBoost() {
     }
 
     /**
-     * @return The word boost parameter value, if provided in the transcription request.
+     * @return The word boost parameter value
      */
     @JsonProperty("boost_param")
     @Override
@@ -286,7 +282,7 @@ public Optional<TranscriptBoostParam> getBoostParam() {
     }
 
     /**
-     * @return Filter profanity from the transcribed text, can be true or false.
+     * @return Filter profanity from the transcribed text, can be true or false
      */
     @JsonProperty("filter_profanity")
     @Override
@@ -330,9 +326,6 @@ public Optional<List<PiiPolicy>> getRedactPiiPolicies() {
         return redactPiiPolicies;
     }
 
-    /**
-     * @return The replacement logic for detected PII, can be &quot;entity_type&quot; or &quot;hash&quot;. See <a href="https://www.assemblyai.com/docs/Models/pii_redaction">PII redaction</a> for more details.
-     */
     @JsonProperty("redact_pii_sub")
     @Override
     public Optional<SubstitutionPolicy> getRedactPiiSub() {
@@ -349,7 +342,7 @@ public Optional<Boolean> getSpeakerLabels() {
     }
 
     /**
-     * @return Tells the speaker label model how many speakers it should attempt to identify, up to 10. See <a href="https://www.assemblyai.com/docs/Models/speaker_diarization">Speaker diarization</a> for more details.
+     * @return Tell the speaker label model how many speakers it should attempt to identify, up to 10. See <a href="https://www.assemblyai.com/docs/Models/speaker_diarization">Speaker diarization</a> for more details.
      */
     @JsonProperty("speakers_expected")
     @Override
@@ -376,7 +369,7 @@ public Optional<Boolean> getIabCategories() {
     }
 
     /**
-     * @return Whether <a href="https://www.assemblyai.com/docs/Models/speech_recognition#automatic-language-detection">Automatic language detection</a> was enabled in the transcription request, either true or false.
+     * @return Whether <a href="https://www.assemblyai.com/docs/Models/speech_recognition#automatic-language-detection">Automatic language detection</a> is enabled, either true or false
      */
     @JsonProperty("language_detection")
     @Override
@@ -394,7 +387,7 @@ public Optional<List<TranscriptCustomSpelling>> getCustomSpelling() {
     }
 
     /**
-     * @return Transcribe Filler Words, like &quot;umm&quot;, in your media file; can be true or false.
+     * @return Transcribe Filler Words, like &quot;umm&quot;, in your media file; can be true or false
      */
     @JsonProperty("disfluencies")
     @Override
@@ -467,7 +460,7 @@ public Optional<SummaryType> getSummaryType() {
     }
 
     /**
-     * @return Whether custom topics was enabled in the transcription request, either true or false
+     * @return Whether custom topics is enabled, either true or false
      */
     @JsonProperty("custom_topics")
     @Override
@@ -476,7 +469,7 @@ public Optional<Boolean> getCustomTopics() {
     }
 
     /**
-     * @return The list of custom topics provided if custom topics was enabled in the transcription request
+     * @return The list of custom topics provided, if custom topics is enabled
      */
     @JsonProperty("topics")
     @Override
@@ -865,7 +858,7 @@ public _FinalStage audioUrl(String audioUrl) {
         }
 
         /**
-         * <p>The list of custom topics provided if custom topics was enabled in the transcription request</p>
+         * <p>The list of custom topics provided, if custom topics is enabled</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override
@@ -882,7 +875,7 @@ public _FinalStage topics(Optional<List<String>> topics) {
         }
 
         /**
-         * <p>Whether custom topics was enabled in the transcription request, either true or false</p>
+         * <p>Whether custom topics is enabled, either true or false</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override
@@ -1019,7 +1012,7 @@ public _FinalStage sentimentAnalysis(Optional<Boolean> sentimentAnalysis) {
         }
 
         /**
-         * <p>Transcribe Filler Words, like &quot;umm&quot;, in your media file; can be true or false.</p>
+         * <p>Transcribe Filler Words, like &quot;umm&quot;, in your media file; can be true or false</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override
@@ -1053,7 +1046,7 @@ public _FinalStage customSpelling(Optional<List<TranscriptCustomSpelling>> custo
         }
 
         /**
-         * <p>Whether <a href="https://www.assemblyai.com/docs/Models/speech_recognition#automatic-language-detection">Automatic language detection</a> was enabled in the transcription request, either true or false.</p>
+         * <p>Whether <a href="https://www.assemblyai.com/docs/Models/speech_recognition#automatic-language-detection">Automatic language detection</a> is enabled, either true or false</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override
@@ -1104,7 +1097,7 @@ public _FinalStage contentSafety(Optional<Boolean> contentSafety) {
         }
 
         /**
-         * <p>Tells the speaker label model how many speakers it should attempt to identify, up to 10. See <a href="https://www.assemblyai.com/docs/Models/speaker_diarization">Speaker diarization</a> for more details.</p>
+         * <p>Tell the speaker label model how many speakers it should attempt to identify, up to 10. See <a href="https://www.assemblyai.com/docs/Models/speaker_diarization">Speaker diarization</a> for more details.</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override
@@ -1137,10 +1130,6 @@ public _FinalStage speakerLabels(Optional<Boolean> speakerLabels) {
             return this;
         }
 
-        /**
-         * <p>The replacement logic for detected PII, can be &quot;entity_type&quot; or &quot;hash&quot;. See <a href="https://www.assemblyai.com/docs/Models/pii_redaction">PII redaction</a> for more details.</p>
-         * @return Reference to {@code this} so that method calls can be chained together.
-         */
         @Override
         public _FinalStage redactPiiSub(SubstitutionPolicy redactPiiSub) {
             this.redactPiiSub = Optional.of(redactPiiSub);
@@ -1223,7 +1212,7 @@ public _FinalStage redactPii(Optional<Boolean> redactPii) {
         }
 
         /**
-         * <p>Filter profanity from the transcribed text, can be true or false.</p>
+         * <p>Filter profanity from the transcribed text, can be true or false</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override
@@ -1240,7 +1229,7 @@ public _FinalStage filterProfanity(Optional<Boolean> filterProfanity) {
         }
 
         /**
-         * <p>The word boost parameter value, if provided in the transcription request.</p>
+         * <p>The word boost parameter value</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override
@@ -1257,7 +1246,7 @@ public _FinalStage boostParam(Optional<TranscriptBoostParam> boostParam) {
         }
 
         /**
-         * <p>The list of custom vocabulary to boost transcription probability for, if provided in the transcription request.</p>
+         * <p>The list of custom vocabulary to boost transcription probability for</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override
@@ -1291,7 +1280,7 @@ public _FinalStage audioEndAt(Optional<Integer> audioEndAt) {
         }
 
         /**
-         * <p>The point in time, in milliseconds, to begin transcription from in your media file</p>
+         * <p>The point in time, in milliseconds, to begin transcribing in your media file</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override
@@ -1308,7 +1297,7 @@ public _FinalStage audioStartFrom(Optional<Integer> audioStartFrom) {
         }
 
         /**
-         * <p>Whether Key Phrases was enabled in the transcription request, either true or false</p>
+         * <p>Whether Key Phrases is enabled, either true or false</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override
@@ -1325,7 +1314,7 @@ public _FinalStage autoHighlights(Optional<Boolean> autoHighlights) {
         }
 
         /**
-         * <p>Defaults to null. Optionally allows a user to specify a header name and value to send back with a webhook call for added security.</p>
+         * <p>Specify a header name and value to send back with a webhook call for added security</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override
@@ -1342,7 +1331,7 @@ public _FinalStage webhookAuthHeaderValue(Optional<String> webhookAuthHeaderValu
         }
 
         /**
-         * <p>The header name which should be sent back with webhook calls, if provided in the transcription request.</p>
+         * <p>The header name which should be sent back with webhook calls</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override
@@ -1359,7 +1348,7 @@ public _FinalStage webhookAuthHeaderName(Optional<String> webhookAuthHeaderName)
         }
 
         /**
-         * <p>The URL to which we send webhooks upon trancription completion, if provided in the transcription request.</p>
+         * <p>The URL to which AssemblyAI send webhooks upon trancription completion</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override
@@ -1376,7 +1365,7 @@ public _FinalStage webhookUrl(Optional<String> webhookUrl) {
         }
 
         /**
-         * <p>Enable <a href="https://assemblyai.com/docs/Models/speech_recognition#dual-channel-transcription">Dual Channel</a> transcription, can be true or false.</p>
+         * <p>Enable <a href="https://assemblyai.com/docs/Models/speech_recognition#dual-channel-transcription">Dual Channel</a> transcription, can be true or false</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override
@@ -1393,7 +1382,7 @@ public _FinalStage dualChannel(Optional<Boolean> dualChannel) {
         }
 
         /**
-         * <p>Enable Text Formatting, can be true or false.</p>
+         * <p>Enable Text Formatting, can be true or false</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override
@@ -1410,7 +1399,7 @@ public _FinalStage formatText(Optional<Boolean> formatText) {
         }
 
         /**
-         * <p>Enable Automatic Punctuation, can be true or false.</p>
+         * <p>Enable Automatic Punctuation, can be true or false</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override
@@ -1426,11 +1415,6 @@ public _FinalStage punctuate(Optional<Boolean> punctuate) {
             return this;
         }
 
-        /**
-         * <p>The language of your audio file. Possible values are found in <a href="https://www.assemblyai.com/docs/Concepts/supported_languages">Supported Languages</a>.
-         * The default value is 'en_us'.</p>
-         * @return Reference to {@code this} so that method calls can be chained together.
-         */
         @Override
         public _FinalStage languageCode(TranscriptLanguageCode languageCode) {
             this.languageCode = Optional.of(languageCode);

src/main/java/com/assemblyai/api/types/AudioData.java

@@ -28,7 +28,7 @@ private AudioData(String audioData, Map<String, Object> additionalProperties) {
     }
 
     /**
-     * @return Raw audio data, base64 encoded. This can be the raw data recorded directly from a microphone or read from an audio file.
+     * @return Base64 encoded raw audio data
      */
     @JsonProperty("audio_data")
     public String getAudioData() {
@@ -90,7 +90,7 @@ public Builder from(AudioData other) {
         }
 
         /**
-         * <p>Raw audio data, base64 encoded. This can be the raw data recorded directly from a microphone or read from an audio file.</p>
+         * <p>Base64 encoded raw audio data</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override

src/main/java/com/assemblyai/api/types/ContentSafetyLabelResult.java

@@ -57,7 +57,7 @@ public String getText() {
     }
 
     /**
-     * @return An array of objects, one per sensitive topic that was detected in the section
+     * @return An array of safety labels, one per sensitive topic that was detected in the section
      */
     @JsonProperty("labels")
     public List<ContentSafetyLabel> getLabels() {
@@ -222,7 +222,7 @@ public _FinalStage timestamp(Timestamp timestamp) {
         }
 
         /**
-         * <p>An array of objects, one per sensitive topic that was detected in the section</p>
+         * <p>An array of safety labels, one per sensitive topic that was detected in the section</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override
@@ -232,7 +232,7 @@ public _FinalStage addAllLabels(List<ContentSafetyLabel> labels) {
         }
 
         /**
-         * <p>An array of objects, one per sensitive topic that was detected in the section</p>
+         * <p>An array of safety labels, one per sensitive topic that was detected in the section</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override

src/main/java/com/assemblyai/api/types/ContentSafetyLabelsResult.java

@@ -46,7 +46,7 @@ private ContentSafetyLabelsResult(
     }
 
     /**
-     * @return Will be either success, or unavailable in the rare case that the Content Moderation model failed.
+     * @return The status of the Content Moderation model. Either success, or unavailable in the rare case that the model failed.
      */
     @JsonProperty("status")
     public AudioIntelligenceModelStatus getStatus() {
@@ -159,7 +159,7 @@ public Builder from(ContentSafetyLabelsResult other) {
         }
 
         /**
-         * <p>Will be either success, or unavailable in the rare case that the Content Moderation model failed.</p>
+         * <p>The status of the Content Moderation model. Either success, or unavailable in the rare case that the model failed.</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override

src/main/java/com/assemblyai/api/types/CreateTranscriptOptionalParameters.java

@@ -164,18 +164,14 @@ private CreateTranscriptOptionalParameters(
         this.additionalProperties = additionalProperties;
     }
 
-    /**
-     * @return The language of your audio file. Possible values are found in <a href="https://www.assemblyai.com/docs/Concepts/supported_languages">Supported Languages</a>.
-     * The default value is 'en_us'.
-     */
     @JsonProperty("language_code")
     @Override
     public Optional<TranscriptLanguageCode> getLanguageCode() {
         return languageCode;
     }
 
     /**
-     * @return Enable Automatic Punctuation, can be true or false.
+     * @return Enable Automatic Punctuation, can be true or false
      */
     @JsonProperty("punctuate")
     @Override
@@ -184,7 +180,7 @@ public Optional<Boolean> getPunctuate() {
     }
 
     /**
-     * @return Enable Text Formatting, can be true or false.
+     * @return Enable Text Formatting, can be true or false
      */
     @JsonProperty("format_text")
     @Override
@@ -193,7 +189,7 @@ public Optional<Boolean> getFormatText() {
     }
 
     /**
-     * @return Enable <a href="https://assemblyai.com/docs/Models/speech_recognition#dual-channel-transcription">Dual Channel</a> transcription, can be true or false.
+     * @return Enable <a href="https://assemblyai.com/docs/Models/speech_recognition#dual-channel-transcription">Dual Channel</a> transcription, can be true or false
      */
     @JsonProperty("dual_channel")
     @Override
@@ -202,7 +198,7 @@ public Optional<Boolean> getDualChannel() {
     }
 
     /**
-     * @return The URL to which we send webhooks upon trancription completion, if provided in the transcription request.
+     * @return The URL to which AssemblyAI send webhooks upon trancription completion
      */
     @JsonProperty("webhook_url")
     @Override
@@ -211,7 +207,7 @@ public Optional<String> getWebhookUrl() {
     }
 
     /**
-     * @return The header name which should be sent back with webhook calls, if provided in the transcription request.
+     * @return The header name which should be sent back with webhook calls
      */
     @JsonProperty("webhook_auth_header_name")
     @Override
@@ -220,7 +216,7 @@ public Optional<String> getWebhookAuthHeaderName() {
     }
 
     /**
-     * @return Defaults to null. Optionally allows a user to specify a header name and value to send back with a webhook call for added security.
+     * @return Specify a header name and value to send back with a webhook call for added security
      */
     @JsonProperty("webhook_auth_header_value")
     @Override
@@ -229,7 +225,7 @@ public Optional<String> getWebhookAuthHeaderValue() {
     }
 
     /**
-     * @return Whether Key Phrases was enabled in the transcription request, either true or false
+     * @return Whether Key Phrases is enabled, either true or false
      */
     @JsonProperty("auto_highlights")
     @Override
@@ -238,7 +234,7 @@ public Optional<Boolean> getAutoHighlights() {
     }
 
     /**
-     * @return The point in time, in milliseconds, to begin transcription from in your media file
+     * @return The point in time, in milliseconds, to begin transcribing in your media file
      */
     @JsonProperty("audio_start_from")
     @Override
@@ -256,7 +252,7 @@ public Optional<Integer> getAudioEndAt() {
     }
 
     /**
-     * @return The list of custom vocabulary to boost transcription probability for, if provided in the transcription request.
+     * @return The list of custom vocabulary to boost transcription probability for
      */
     @JsonProperty("word_boost")
     @Override
@@ -265,7 +261,7 @@ public Optional<List<String>> getWordBoost() {
     }
 
     /**
-     * @return The word boost parameter value, if provided in the transcription request.
+     * @return The word boost parameter value
      */
     @JsonProperty("boost_param")
     @Override
@@ -274,7 +270,7 @@ public Optional<TranscriptBoostParam> getBoostParam() {
     }
 
     /**
-     * @return Filter profanity from the transcribed text, can be true or false.
+     * @return Filter profanity from the transcribed text, can be true or false
      */
     @JsonProperty("filter_profanity")
     @Override
@@ -318,9 +314,6 @@ public Optional<List<PiiPolicy>> getRedactPiiPolicies() {
         return redactPiiPolicies;
     }
 
-    /**
-     * @return The replacement logic for detected PII, can be &quot;entity_type&quot; or &quot;hash&quot;. See <a href="https://www.assemblyai.com/docs/Models/pii_redaction">PII redaction</a> for more details.
-     */
     @JsonProperty("redact_pii_sub")
     @Override
     public Optional<SubstitutionPolicy> getRedactPiiSub() {
@@ -337,7 +330,7 @@ public Optional<Boolean> getSpeakerLabels() {
     }
 
     /**
-     * @return Tells the speaker label model how many speakers it should attempt to identify, up to 10. See <a href="https://www.assemblyai.com/docs/Models/speaker_diarization">Speaker diarization</a> for more details.
+     * @return Tell the speaker label model how many speakers it should attempt to identify, up to 10. See <a href="https://www.assemblyai.com/docs/Models/speaker_diarization">Speaker diarization</a> for more details.
      */
     @JsonProperty("speakers_expected")
     @Override
@@ -364,7 +357,7 @@ public Optional<Boolean> getIabCategories() {
     }
 
     /**
-     * @return Whether <a href="https://www.assemblyai.com/docs/Models/speech_recognition#automatic-language-detection">Automatic language detection</a> was enabled in the transcription request, either true or false.
+     * @return Whether <a href="https://www.assemblyai.com/docs/Models/speech_recognition#automatic-language-detection">Automatic language detection</a> is enabled, either true or false
      */
     @JsonProperty("language_detection")
     @Override
@@ -382,7 +375,7 @@ public Optional<List<TranscriptCustomSpelling>> getCustomSpelling() {
     }
 
     /**
-     * @return Transcribe Filler Words, like &quot;umm&quot;, in your media file; can be true or false.
+     * @return Transcribe Filler Words, like &quot;umm&quot;, in your media file; can be true or false
      */
     @JsonProperty("disfluencies")
     @Override
@@ -455,7 +448,7 @@ public Optional<SummaryType> getSummaryType() {
     }
 
     /**
-     * @return Whether custom topics was enabled in the transcription request, either true or false
+     * @return Whether custom topics is enabled, either true or false
      */
     @JsonProperty("custom_topics")
     @Override
@@ -464,7 +457,7 @@ public Optional<Boolean> getCustomTopics() {
     }
 
     /**
-     * @return The list of custom topics provided if custom topics was enabled in the transcription request
+     * @return The list of custom topics provided, if custom topics is enabled
      */
     @JsonProperty("topics")
     @Override

src/main/java/com/assemblyai/api/types/FinalTranscript.java

@@ -61,7 +61,7 @@ private FinalTranscript(
     }
 
     /**
-     * @return Start time of audio sample relative to session start, in milliseconds.
+     * @return Start time of audio sample relative to session start, in milliseconds
      */
     @JsonProperty("audio_start")
     @Override
@@ -70,7 +70,7 @@ public int getAudioStart() {
     }
 
     /**
-     * @return End time of audio sample relative to session start, in milliseconds.
+     * @return End time of audio sample relative to session start, in milliseconds
      */
     @JsonProperty("audio_end")
     @Override
@@ -79,7 +79,7 @@ public int getAudioEnd() {
     }
 
     /**
-     * @return The confidence score of the entire transcription, between 0 and 1.
+     * @return The confidence score of the entire transcription, between 0 and 1
      */
     @JsonProperty("confidence")
     @Override
@@ -88,7 +88,7 @@ public double getConfidence() {
     }
 
     /**
-     * @return The partial transcript for your audio.
+     * @return The partial transcript for your audio
      */
     @JsonProperty("text")
     @Override
@@ -97,7 +97,8 @@ public String getText() {
     }
 
     /**
-     * @return An array of objects, with the information for each word in the transcription text. Includes the start/end time (in milliseconds) of the word, the confidence score of the word, and the text (i.e. the word itself).
+     * @return An array of objects, with the information for each word in the transcription text.
+     * Includes the start and end time of the word in milliseconds, the confidence score of the word, and the text, which is the word itself.
      */
     @JsonProperty("words")
     @Override
@@ -106,7 +107,7 @@ public List<Word> getWords() {
     }
 
     /**
-     * @return The timestamp for the partial transcript.
+     * @return The timestamp for the partial transcript
      */
     @JsonProperty("created")
     @Override
@@ -120,15 +121,15 @@ public String getMessageType() {
     }
 
     /**
-     * @return Whether the text has been punctuated and cased.
+     * @return Whether the text is punctuated and cased
      */
     @JsonProperty("punctuated")
     public boolean getPunctuated() {
         return punctuated;
     }
 
     /**
-     * @return Whether the text has been formatted (e.g. Dollar -&gt; $)
+     * @return Whether the text is formatted, for example Dollar -&gt; $
      */
     @JsonProperty("text_formatted")
     public boolean getTextFormatted() {
@@ -264,7 +265,7 @@ public Builder from(FinalTranscript other) {
         }
 
         /**
-         * <p>Start time of audio sample relative to session start, in milliseconds.</p>
+         * <p>Start time of audio sample relative to session start, in milliseconds</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override
@@ -275,7 +276,7 @@ public AudioEndStage audioStart(int audioStart) {
         }
 
         /**
-         * <p>End time of audio sample relative to session start, in milliseconds.</p>
+         * <p>End time of audio sample relative to session start, in milliseconds</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override
@@ -286,7 +287,7 @@ public ConfidenceStage audioEnd(int audioEnd) {
         }
 
         /**
-         * <p>The confidence score of the entire transcription, between 0 and 1.</p>
+         * <p>The confidence score of the entire transcription, between 0 and 1</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override
@@ -297,7 +298,7 @@ public TextStage confidence(double confidence) {
         }
 
         /**
-         * <p>The partial transcript for your audio.</p>
+         * <p>The partial transcript for your audio</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override
@@ -308,7 +309,7 @@ public CreatedStage text(String text) {
         }
 
         /**
-         * <p>The timestamp for the partial transcript.</p>
+         * <p>The timestamp for the partial transcript</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override
@@ -319,7 +320,7 @@ public PunctuatedStage created(String created) {
         }
 
         /**
-         * <p>Whether the text has been punctuated and cased.</p>
+         * <p>Whether the text is punctuated and cased</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override
@@ -330,7 +331,7 @@ public TextFormattedStage punctuated(boolean punctuated) {
         }
 
         /**
-         * <p>Whether the text has been formatted (e.g. Dollar -&gt; $)</p>
+         * <p>Whether the text is formatted, for example Dollar -&gt; $</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override
@@ -341,7 +342,8 @@ public _FinalStage textFormatted(boolean textFormatted) {
         }
 
         /**
-         * <p>An array of objects, with the information for each word in the transcription text. Includes the start/end time (in milliseconds) of the word, the confidence score of the word, and the text (i.e. the word itself).</p>
+         * <p>An array of objects, with the information for each word in the transcription text.
+         * Includes the start and end time of the word in milliseconds, the confidence score of the word, and the text, which is the word itself.</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override
@@ -351,7 +353,8 @@ public _FinalStage addAllWords(List<Word> words) {
         }
 
         /**
-         * <p>An array of objects, with the information for each word in the transcription text. Includes the start/end time (in milliseconds) of the word, the confidence score of the word, and the text (i.e. the word itself).</p>
+         * <p>An array of objects, with the information for each word in the transcription text.
+         * Includes the start and end time of the word in milliseconds, the confidence score of the word, and the text, which is the word itself.</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override

src/main/java/com/assemblyai/api/types/ILemurBaseParameters.java

@@ -7,7 +7,9 @@
 import java.util.Optional;
 
 public interface ILemurBaseParameters {
-    List<String> getTranscriptIds();
+    Optional<List<String>> getTranscriptIds();
+
+    Optional<String> getInputText();
 
     Optional<LemurBaseParametersContext> getContext();
 

src/main/java/com/assemblyai/api/types/LemurActionItemsResponse.java

@@ -40,7 +40,7 @@ public String getRequestId() {
     }
 
     /**
-     * @return The response generated by LeMUR.
+     * @return The response generated by LeMUR
      */
     @JsonProperty("response")
     public String getResponse() {
@@ -120,7 +120,7 @@ public ResponseStage requestId(String requestId) {
         }
 
         /**
-         * <p>The response generated by LeMUR.</p>
+         * <p>The response generated by LeMUR</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override

src/main/java/com/assemblyai/api/types/LemurBaseParameters.java

@@ -12,7 +12,6 @@
 import com.fasterxml.jackson.annotation.JsonSetter;
 import com.fasterxml.jackson.annotation.Nulls;
 import com.fasterxml.jackson.databind.annotation.JsonDeserialize;
-import java.util.ArrayList;
 import java.util.HashMap;
 import java.util.List;
 import java.util.Map;
@@ -22,7 +21,9 @@
 @JsonInclude(JsonInclude.Include.NON_EMPTY)
 @JsonDeserialize(builder = LemurBaseParameters.Builder.class)
 public final class LemurBaseParameters implements ILemurBaseParameters {
-    private final List<String> transcriptIds;
+    private final Optional<List<String>> transcriptIds;
+
+    private final Optional<String> inputText;
 
     private final Optional<LemurBaseParametersContext> context;
 
@@ -35,13 +36,15 @@ public final class LemurBaseParameters implements ILemurBaseParameters {
     private final Map<String, Object> additionalProperties;
 
     private LemurBaseParameters(
-            List<String> transcriptIds,
+            Optional<List<String>> transcriptIds,
+            Optional<String> inputText,
             Optional<LemurBaseParametersContext> context,
             Optional<LemurModel> finalModel,
             Optional<Integer> maxOutputSize,
             Optional<Double> temperature,
             Map<String, Object> additionalProperties) {
         this.transcriptIds = transcriptIds;
+        this.inputText = inputText;
         this.context = context;
         this.finalModel = finalModel;
         this.maxOutputSize = maxOutputSize;
@@ -50,14 +53,25 @@ private LemurBaseParameters(
     }
 
     /**
-     * @return A list of completed transcripts with text. Up to 100 files max, or 100 hours max. Whichever is lower.
+     * @return A list of completed transcripts with text. Up to a maximum of 100 files or 100 hours, whichever is lower.
+     * Use either transcript_ids or input_text as input into LeMUR.
      */
     @JsonProperty("transcript_ids")
     @Override
-    public List<String> getTranscriptIds() {
+    public Optional<List<String>> getTranscriptIds() {
         return transcriptIds;
     }
 
+    /**
+     * @return Custom formatted transcript data. Maximum size is the context limit of the selected model, which defaults to 100000.
+     * Use either transcript_ids or input_text as input into LeMUR.
+     */
+    @JsonProperty("input_text")
+    @Override
+    public Optional<String> getInputText() {
+        return inputText;
+    }
+
     /**
      * @return Context to provide the model. This can be a string or a free-form JSON value.
      */
@@ -74,7 +88,7 @@ public Optional<LemurModel> getFinalModel() {
     }
 
     /**
-     * @return Max output size in tokens. Up to 4000 allowed.
+     * @return Max output size in tokens, up to 4000
      */
     @JsonProperty("max_output_size")
     @Override
@@ -106,6 +120,7 @@ public Map<String, Object> getAdditionalProperties() {
 
     private boolean equalTo(LemurBaseParameters other) {
         return transcriptIds.equals(other.transcriptIds)
+                && inputText.equals(other.inputText)
                 && context.equals(other.context)
                 && finalModel.equals(other.finalModel)
                 && maxOutputSize.equals(other.maxOutputSize)
@@ -114,7 +129,13 @@ private boolean equalTo(LemurBaseParameters other) {
 
     @Override
     public int hashCode() {
-        return Objects.hash(this.transcriptIds, this.context, this.finalModel, this.maxOutputSize, this.temperature);
+        return Objects.hash(
+                this.transcriptIds,
+                this.inputText,
+                this.context,
+                this.finalModel,
+                this.maxOutputSize,
+                this.temperature);
     }
 
     @Override
@@ -128,7 +149,9 @@ public static Builder builder() {
 
     @JsonIgnoreProperties(ignoreUnknown = true)
     public static final class Builder {
-        private List<String> transcriptIds = new ArrayList<>();
+        private Optional<List<String>> transcriptIds = Optional.empty();
+
+        private Optional<String> inputText = Optional.empty();
 
         private Optional<LemurBaseParametersContext> context = Optional.empty();
 
@@ -145,6 +168,7 @@ private Builder() {}
 
         public Builder from(LemurBaseParameters other) {
             transcriptIds(other.getTranscriptIds());
+            inputText(other.getInputText());
             context(other.getContext());
             finalModel(other.getFinalModel());
             maxOutputSize(other.getMaxOutputSize());
@@ -153,19 +177,24 @@ public Builder from(LemurBaseParameters other) {
         }
 
         @JsonSetter(value = "transcript_ids", nulls = Nulls.SKIP)
+        public Builder transcriptIds(Optional<List<String>> transcriptIds) {
+            this.transcriptIds = transcriptIds;
+            return this;
+        }
+
         public Builder transcriptIds(List<String> transcriptIds) {
-            this.transcriptIds.clear();
-            this.transcriptIds.addAll(transcriptIds);
+            this.transcriptIds = Optional.of(transcriptIds);
             return this;
         }
 
-        public Builder addTranscriptIds(String transcriptIds) {
-            this.transcriptIds.add(transcriptIds);
+        @JsonSetter(value = "input_text", nulls = Nulls.SKIP)
+        public Builder inputText(Optional<String> inputText) {
+            this.inputText = inputText;
             return this;
         }
 
-        public Builder addAllTranscriptIds(List<String> transcriptIds) {
-            this.transcriptIds.addAll(transcriptIds);
+        public Builder inputText(String inputText) {
+            this.inputText = Optional.of(inputText);
             return this;
         }
 
@@ -215,7 +244,7 @@ public Builder temperature(Double temperature) {
 
         public LemurBaseParameters build() {
             return new LemurBaseParameters(
-                    transcriptIds, context, finalModel, maxOutputSize, temperature, additionalProperties);
+                    transcriptIds, inputText, context, finalModel, maxOutputSize, temperature, additionalProperties);
         }
     }
 }

src/main/java/com/assemblyai/api/types/LemurQuestion.java

@@ -53,7 +53,7 @@ public String getQuestion() {
     }
 
     /**
-     * @return Any context about the transcripts you wish to provide. This can be a string, or free-form JSON.
+     * @return Any context about the transcripts you wish to provide. This can be a string or any object.
      */
     @JsonProperty("context")
     public Optional<LemurQuestionContext> getContext() {
@@ -200,7 +200,7 @@ public _FinalStage answerFormat(Optional<String> answerFormat) {
         }
 
         /**
-         * <p>Any context about the transcripts you wish to provide. This can be a string, or free-form JSON.</p>
+         * <p>Any context about the transcripts you wish to provide. This can be a string or any object.</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override

src/main/java/com/assemblyai/api/types/LemurQuestionAnswer.java

@@ -31,15 +31,15 @@ private LemurQuestionAnswer(String question, String answer, Map<String, Object>
     }
 
     /**
-     * @return The question for LeMUR to answer.
+     * @return The question for LeMUR to answer
      */
     @JsonProperty("question")
     public String getQuestion() {
         return question;
     }
 
     /**
-     * @return The answer generated by LeMUR.
+     * @return The answer generated by LeMUR
      */
     @JsonProperty("answer")
     public String getAnswer() {
@@ -108,7 +108,7 @@ public Builder from(LemurQuestionAnswer other) {
         }
 
         /**
-         * <p>The question for LeMUR to answer.</p>
+         * <p>The question for LeMUR to answer</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override
@@ -119,7 +119,7 @@ public AnswerStage question(String question) {
         }
 
         /**
-         * <p>The answer generated by LeMUR.</p>
+         * <p>The answer generated by LeMUR</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override

src/main/java/com/assemblyai/api/types/LemurQuestionAnswerResponse.java

@@ -44,7 +44,7 @@ public String getRequestId() {
     }
 
     /**
-     * @return The answers generated by LeMUR and their questions.
+     * @return The answers generated by LeMUR and their questions
      */
     @JsonProperty("response")
     public List<LemurQuestionAnswer> getResponse() {
@@ -126,7 +126,7 @@ public _FinalStage requestId(String requestId) {
         }
 
         /**
-         * <p>The answers generated by LeMUR and their questions.</p>
+         * <p>The answers generated by LeMUR and their questions</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override
@@ -136,7 +136,7 @@ public _FinalStage addAllResponse(List<LemurQuestionAnswer> response) {
         }
 
         /**
-         * <p>The answers generated by LeMUR and their questions.</p>
+         * <p>The answers generated by LeMUR and their questions</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override

src/main/java/com/assemblyai/api/types/LemurSummaryResponse.java

@@ -40,7 +40,7 @@ public String getRequestId() {
     }
 
     /**
-     * @return The response generated by LeMUR.
+     * @return The response generated by LeMUR
      */
     @JsonProperty("response")
     public String getResponse() {
@@ -120,7 +120,7 @@ public ResponseStage requestId(String requestId) {
         }
 
         /**
-         * <p>The response generated by LeMUR.</p>
+         * <p>The response generated by LeMUR</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override

src/main/java/com/assemblyai/api/types/LemurTaskResponse.java

@@ -40,7 +40,7 @@ public String getRequestId() {
     }
 
     /**
-     * @return The response generated by LeMUR.
+     * @return The response generated by LeMUR
      */
     @JsonProperty("response")
     public String getResponse() {
@@ -120,7 +120,7 @@ public ResponseStage requestId(String requestId) {
         }
 
         /**
-         * <p>The response generated by LeMUR.</p>
+         * <p>The response generated by LeMUR</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override

src/main/java/com/assemblyai/api/types/PartialTranscript.java

@@ -53,7 +53,7 @@ private PartialTranscript(
     }
 
     /**
-     * @return Start time of audio sample relative to session start, in milliseconds.
+     * @return Start time of audio sample relative to session start, in milliseconds
      */
     @JsonProperty("audio_start")
     @Override
@@ -62,7 +62,7 @@ public int getAudioStart() {
     }
 
     /**
-     * @return End time of audio sample relative to session start, in milliseconds.
+     * @return End time of audio sample relative to session start, in milliseconds
      */
     @JsonProperty("audio_end")
     @Override
@@ -71,7 +71,7 @@ public int getAudioEnd() {
     }
 
     /**
-     * @return The confidence score of the entire transcription, between 0 and 1.
+     * @return The confidence score of the entire transcription, between 0 and 1
      */
     @JsonProperty("confidence")
     @Override
@@ -80,7 +80,7 @@ public double getConfidence() {
     }
 
     /**
-     * @return The partial transcript for your audio.
+     * @return The partial transcript for your audio
      */
     @JsonProperty("text")
     @Override
@@ -89,7 +89,8 @@ public String getText() {
     }
 
     /**
-     * @return An array of objects, with the information for each word in the transcription text. Includes the start/end time (in milliseconds) of the word, the confidence score of the word, and the text (i.e. the word itself).
+     * @return An array of objects, with the information for each word in the transcription text.
+     * Includes the start and end time of the word in milliseconds, the confidence score of the word, and the text, which is the word itself.
      */
     @JsonProperty("words")
     @Override
@@ -98,7 +99,7 @@ public List<Word> getWords() {
     }
 
     /**
-     * @return The timestamp for the partial transcript.
+     * @return The timestamp for the partial transcript
      */
     @JsonProperty("created")
     @Override
@@ -209,7 +210,7 @@ public Builder from(PartialTranscript other) {
         }
 
         /**
-         * <p>Start time of audio sample relative to session start, in milliseconds.</p>
+         * <p>Start time of audio sample relative to session start, in milliseconds</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override
@@ -220,7 +221,7 @@ public AudioEndStage audioStart(int audioStart) {
         }
 
         /**
-         * <p>End time of audio sample relative to session start, in milliseconds.</p>
+         * <p>End time of audio sample relative to session start, in milliseconds</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override
@@ -231,7 +232,7 @@ public ConfidenceStage audioEnd(int audioEnd) {
         }
 
         /**
-         * <p>The confidence score of the entire transcription, between 0 and 1.</p>
+         * <p>The confidence score of the entire transcription, between 0 and 1</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override
@@ -242,7 +243,7 @@ public TextStage confidence(double confidence) {
         }
 
         /**
-         * <p>The partial transcript for your audio.</p>
+         * <p>The partial transcript for your audio</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override
@@ -253,7 +254,7 @@ public CreatedStage text(String text) {
         }
 
         /**
-         * <p>The timestamp for the partial transcript.</p>
+         * <p>The timestamp for the partial transcript</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override
@@ -264,7 +265,8 @@ public _FinalStage created(String created) {
         }
 
         /**
-         * <p>An array of objects, with the information for each word in the transcription text. Includes the start/end time (in milliseconds) of the word, the confidence score of the word, and the text (i.e. the word itself).</p>
+         * <p>An array of objects, with the information for each word in the transcription text.
+         * Includes the start and end time of the word in milliseconds, the confidence score of the word, and the text, which is the word itself.</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override
@@ -274,7 +276,8 @@ public _FinalStage addAllWords(List<Word> words) {
         }
 
         /**
-         * <p>An array of objects, with the information for each word in the transcription text. Includes the start/end time (in milliseconds) of the word, the confidence score of the word, and the text (i.e. the word itself).</p>
+         * <p>An array of objects, with the information for each word in the transcription text.
+         * Includes the start and end time of the word in milliseconds, the confidence score of the word, and the text, which is the word itself.</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override

src/main/java/com/assemblyai/api/types/PurgeLemurRequestDataResponse.java

@@ -35,23 +35,23 @@ private PurgeLemurRequestDataResponse(
     }
 
     /**
-     * @return The ID of the LeMUR request
+     * @return The ID of the deletion request of the LeMUR request
      */
     @JsonProperty("request_id")
     public String getRequestId() {
         return requestId;
     }
 
     /**
-     * @return The ID of the deletion request of the LeMUR request
+     * @return The ID of the LeMUR request to purge the data for
      */
     @JsonProperty("request_id_to_purge")
     public String getRequestIdToPurge() {
         return requestIdToPurge;
     }
 
     /**
-     * @return Whether the request data was deleted.
+     * @return Whether the request data was deleted
      */
     @JsonProperty("deleted")
     public boolean getDeleted() {
@@ -129,7 +129,7 @@ public Builder from(PurgeLemurRequestDataResponse other) {
         }
 
         /**
-         * <p>The ID of the LeMUR request</p>
+         * <p>The ID of the deletion request of the LeMUR request</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override
@@ -140,7 +140,7 @@ public RequestIdToPurgeStage requestId(String requestId) {
         }
 
         /**
-         * <p>The ID of the deletion request of the LeMUR request</p>
+         * <p>The ID of the LeMUR request to purge the data for</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override
@@ -151,7 +151,7 @@ public DeletedStage requestIdToPurge(String requestIdToPurge) {
         }
 
         /**
-         * <p>Whether the request data was deleted.</p>
+         * <p>Whether the request data was deleted</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override

src/main/java/com/assemblyai/api/types/RealtimeBaseMessage.java

@@ -28,7 +28,7 @@ private RealtimeBaseMessage(MessageType messageType, Map<String, Object> additio
     }
 
     /**
-     * @return Describes the type of the message.
+     * @return Describes the type of the message
      */
     @JsonProperty("message_type")
     @Override
@@ -91,7 +91,7 @@ public Builder from(RealtimeBaseMessage other) {
         }
 
         /**
-         * <p>Describes the type of the message.</p>
+         * <p>Describes the type of the message</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override

src/main/java/com/assemblyai/api/types/RealtimeBaseTranscript.java

@@ -53,7 +53,7 @@ private RealtimeBaseTranscript(
     }
 
     /**
-     * @return Start time of audio sample relative to session start, in milliseconds.
+     * @return Start time of audio sample relative to session start, in milliseconds
      */
     @JsonProperty("audio_start")
     @Override
@@ -62,7 +62,7 @@ public int getAudioStart() {
     }
 
     /**
-     * @return End time of audio sample relative to session start, in milliseconds.
+     * @return End time of audio sample relative to session start, in milliseconds
      */
     @JsonProperty("audio_end")
     @Override
@@ -71,7 +71,7 @@ public int getAudioEnd() {
     }
 
     /**
-     * @return The confidence score of the entire transcription, between 0 and 1.
+     * @return The confidence score of the entire transcription, between 0 and 1
      */
     @JsonProperty("confidence")
     @Override
@@ -80,7 +80,7 @@ public double getConfidence() {
     }
 
     /**
-     * @return The partial transcript for your audio.
+     * @return The partial transcript for your audio
      */
     @JsonProperty("text")
     @Override
@@ -89,7 +89,8 @@ public String getText() {
     }
 
     /**
-     * @return An array of objects, with the information for each word in the transcription text. Includes the start/end time (in milliseconds) of the word, the confidence score of the word, and the text (i.e. the word itself).
+     * @return An array of objects, with the information for each word in the transcription text.
+     * Includes the start and end time of the word in milliseconds, the confidence score of the word, and the text, which is the word itself.
      */
     @JsonProperty("words")
     @Override
@@ -98,7 +99,7 @@ public List<Word> getWords() {
     }
 
     /**
-     * @return The timestamp for the partial transcript.
+     * @return The timestamp for the partial transcript
      */
     @JsonProperty("created")
     @Override
@@ -204,7 +205,7 @@ public Builder from(RealtimeBaseTranscript other) {
         }
 
         /**
-         * <p>Start time of audio sample relative to session start, in milliseconds.</p>
+         * <p>Start time of audio sample relative to session start, in milliseconds</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override
@@ -215,7 +216,7 @@ public AudioEndStage audioStart(int audioStart) {
         }
 
         /**
-         * <p>End time of audio sample relative to session start, in milliseconds.</p>
+         * <p>End time of audio sample relative to session start, in milliseconds</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override
@@ -226,7 +227,7 @@ public ConfidenceStage audioEnd(int audioEnd) {
         }
 
         /**
-         * <p>The confidence score of the entire transcription, between 0 and 1.</p>
+         * <p>The confidence score of the entire transcription, between 0 and 1</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override
@@ -237,7 +238,7 @@ public TextStage confidence(double confidence) {
         }
 
         /**
-         * <p>The partial transcript for your audio.</p>
+         * <p>The partial transcript for your audio</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override
@@ -248,7 +249,7 @@ public CreatedStage text(String text) {
         }
 
         /**
-         * <p>The timestamp for the partial transcript.</p>
+         * <p>The timestamp for the partial transcript</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override
@@ -259,7 +260,8 @@ public _FinalStage created(String created) {
         }
 
         /**
-         * <p>An array of objects, with the information for each word in the transcription text. Includes the start/end time (in milliseconds) of the word, the confidence score of the word, and the text (i.e. the word itself).</p>
+         * <p>An array of objects, with the information for each word in the transcription text.
+         * Includes the start and end time of the word in milliseconds, the confidence score of the word, and the text, which is the word itself.</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override
@@ -269,7 +271,8 @@ public _FinalStage addAllWords(List<Word> words) {
         }
 
         /**
-         * <p>An array of objects, with the information for each word in the transcription text. Includes the start/end time (in milliseconds) of the word, the confidence score of the word, and the text (i.e. the word itself).</p>
+         * <p>An array of objects, with the information for each word in the transcription text.
+         * Includes the start and end time of the word in milliseconds, the confidence score of the word, and the text, which is the word itself.</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override

src/main/java/com/assemblyai/api/types/SessionBegins.java

@@ -36,15 +36,15 @@ public String getMessageType() {
     }
 
     /**
-     * @return Unique identifier for the established session.
+     * @return Unique identifier for the established session
      */
     @JsonProperty("session_id")
     public String getSessionId() {
         return sessionId;
     }
 
     /**
-     * @return Timestamp when this session will expire.
+     * @return Timestamp when this session will expire
      */
     @JsonProperty("expires_at")
     public String getExpiresAt() {
@@ -113,7 +113,7 @@ public Builder from(SessionBegins other) {
         }
 
         /**
-         * <p>Unique identifier for the established session.</p>
+         * <p>Unique identifier for the established session</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override
@@ -124,7 +124,7 @@ public ExpiresAtStage sessionId(String sessionId) {
         }
 
         /**
-         * <p>Timestamp when this session will expire.</p>
+         * <p>Timestamp when this session will expire</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override

src/main/java/com/assemblyai/api/types/TerminateSession.java

@@ -32,7 +32,7 @@ private TerminateSession(
     }
 
     /**
-     * @return Describes the type of the message.
+     * @return Describes the type of the message
      */
     @JsonProperty("message_type")
     @Override
@@ -41,7 +41,7 @@ public MessageType getMessageType() {
     }
 
     /**
-     * @return A boolean value to communicate that you wish to end your real-time session forever.
+     * @return Set to true to end your real-time session forever
      */
     @JsonProperty("terminate_session")
     public boolean getTerminateSession() {
@@ -110,7 +110,7 @@ public Builder from(TerminateSession other) {
         }
 
         /**
-         * <p>Describes the type of the message.</p>
+         * <p>Describes the type of the message</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override
@@ -121,7 +121,7 @@ public TerminateSessionStage messageType(MessageType messageType) {
         }
 
         /**
-         * <p>A boolean value to communicate that you wish to end your real-time session forever.</p>
+         * <p>Set to true to end your real-time session forever</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override

src/main/java/com/assemblyai/api/types/TranscriptIabCategoriesResult.java src/main/java/com/assemblyai/api/types/TopicDetectionModelResult.java

@@ -20,8 +20,8 @@
 import java.util.Objects;
 
 @JsonInclude(JsonInclude.Include.NON_EMPTY)
-@JsonDeserialize(builder = TranscriptIabCategoriesResult.Builder.class)
-public final class TranscriptIabCategoriesResult {
+@JsonDeserialize(builder = TopicDetectionModelResult.Builder.class)
+public final class TopicDetectionModelResult {
     private final AudioIntelligenceModelStatus status;
 
     private final List<TopicDetectionResult> results;
@@ -30,7 +30,7 @@ public final class TranscriptIabCategoriesResult {
 
     private final Map<String, Object> additionalProperties;
 
-    private TranscriptIabCategoriesResult(
+    private TopicDetectionModelResult(
             AudioIntelligenceModelStatus status,
             List<TopicDetectionResult> results,
             Map<String, Double> summary,
@@ -42,15 +42,15 @@ private TranscriptIabCategoriesResult(
     }
 
     /**
-     * @return Will be either success, or unavailable in the rare case that the Content Moderation model failed.
+     * @return The status of the Topic Detection model. Either success, or unavailable in the rare case that the model failed.
      */
     @JsonProperty("status")
     public AudioIntelligenceModelStatus getStatus() {
         return status;
     }
 
     /**
-     * @return An array of results for the Topic Detection model.
+     * @return An array of results for the Topic Detection model
      */
     @JsonProperty("results")
     public List<TopicDetectionResult> getResults() {
@@ -68,15 +68,15 @@ public Map<String, Double> getSummary() {
     @Override
     public boolean equals(Object other) {
         if (this == other) return true;
-        return other instanceof TranscriptIabCategoriesResult && equalTo((TranscriptIabCategoriesResult) other);
+        return other instanceof TopicDetectionModelResult && equalTo((TopicDetectionModelResult) other);
     }
 
     @JsonAnyGetter
     public Map<String, Object> getAdditionalProperties() {
         return this.additionalProperties;
     }
 
-    private boolean equalTo(TranscriptIabCategoriesResult other) {
+    private boolean equalTo(TopicDetectionModelResult other) {
         return status.equals(other.status) && results.equals(other.results) && summary.equals(other.summary);
     }
 
@@ -97,11 +97,11 @@ public static StatusStage builder() {
     public interface StatusStage {
         _FinalStage status(AudioIntelligenceModelStatus status);
 
-        Builder from(TranscriptIabCategoriesResult other);
+        Builder from(TopicDetectionModelResult other);
     }
 
     public interface _FinalStage {
-        TranscriptIabCategoriesResult build();
+        TopicDetectionModelResult build();
 
         _FinalStage results(List<TopicDetectionResult> results);
 
@@ -130,15 +130,15 @@ public static final class Builder implements StatusStage, _FinalStage {
         private Builder() {}
 
         @Override
-        public Builder from(TranscriptIabCategoriesResult other) {
+        public Builder from(TopicDetectionModelResult other) {
             status(other.getStatus());
             results(other.getResults());
             summary(other.getSummary());
             return this;
         }
 
         /**
-         * <p>Will be either success, or unavailable in the rare case that the Content Moderation model failed.</p>
+         * <p>The status of the Topic Detection model. Either success, or unavailable in the rare case that the model failed.</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override
@@ -177,7 +177,7 @@ public _FinalStage summary(Map<String, Double> summary) {
         }
 
         /**
-         * <p>An array of results for the Topic Detection model.</p>
+         * <p>An array of results for the Topic Detection model</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override
@@ -187,7 +187,7 @@ public _FinalStage addAllResults(List<TopicDetectionResult> results) {
         }
 
         /**
-         * <p>An array of results for the Topic Detection model.</p>
+         * <p>An array of results for the Topic Detection model</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @Override
@@ -205,8 +205,8 @@ public _FinalStage results(List<TopicDetectionResult> results) {
         }
 
         @Override
-        public TranscriptIabCategoriesResult build() {
-            return new TranscriptIabCategoriesResult(status, results, summary, additionalProperties);
+        public TopicDetectionModelResult build() {
+            return new TopicDetectionModelResult(status, results, summary, additionalProperties);
         }
     }
 }

src/main/java/com/assemblyai/api/types/Transcript.java

@@ -11,12 +11,12 @@ public final class TranscriptListRequestStatus {
 
     public static final TranscriptListRequestStatus QUEUED = new TranscriptListRequestStatus(Value.QUEUED, "queued");
 
-    public static final TranscriptListRequestStatus PROCESSING =
-            new TranscriptListRequestStatus(Value.PROCESSING, "processing");
-
     public static final TranscriptListRequestStatus COMPLETED =
             new TranscriptListRequestStatus(Value.COMPLETED, "completed");
 
+    public static final TranscriptListRequestStatus PROCESSING =
+            new TranscriptListRequestStatus(Value.PROCESSING, "processing");
+
     private final Value value;
 
     private final String string;
@@ -54,10 +54,10 @@ public <T> T visit(Visitor<T> visitor) {
                 return visitor.visitError();
             case QUEUED:
                 return visitor.visitQueued();
-            case PROCESSING:
-                return visitor.visitProcessing();
             case COMPLETED:
                 return visitor.visitCompleted();
+            case PROCESSING:
+                return visitor.visitProcessing();
             case UNKNOWN:
             default:
                 return visitor.visitUnknown(string);
@@ -71,10 +71,10 @@ public static TranscriptListRequestStatus valueOf(String value) {
                 return ERROR;
             case "queued":
                 return QUEUED;
-            case "processing":
-                return PROCESSING;
             case "completed":
                 return COMPLETED;
+            case "processing":
+                return PROCESSING;
             default:
                 return new TranscriptListRequestStatus(Value.UNKNOWN, value);
         }

src/main/java/com/assemblyai/api/types/TranscriptListRequestStatus.java

@@ -11,10 +11,10 @@ public final class TranscriptStatus {
 
     public static final TranscriptStatus QUEUED = new TranscriptStatus(Value.QUEUED, "queued");
 
-    public static final TranscriptStatus PROCESSING = new TranscriptStatus(Value.PROCESSING, "processing");
-
     public static final TranscriptStatus COMPLETED = new TranscriptStatus(Value.COMPLETED, "completed");
 
+    public static final TranscriptStatus PROCESSING = new TranscriptStatus(Value.PROCESSING, "processing");
+
     private final Value value;
 
     private final String string;
@@ -51,10 +51,10 @@ public <T> T visit(Visitor<T> visitor) {
                 return visitor.visitError();
             case QUEUED:
                 return visitor.visitQueued();
-            case PROCESSING:
-                return visitor.visitProcessing();
             case COMPLETED:
                 return visitor.visitCompleted();
+            case PROCESSING:
+                return visitor.visitProcessing();
             case UNKNOWN:
             default:
                 return visitor.visitUnknown(string);
@@ -68,10 +68,10 @@ public static TranscriptStatus valueOf(String value) {
                 return ERROR;
             case "queued":
                 return QUEUED;
-            case "processing":
-                return PROCESSING;
             case "completed":
                 return COMPLETED;
+            case "processing":
+                return PROCESSING;
             default:
                 return new TranscriptStatus(Value.UNKNOWN, value);
         }