From 0cf0e854067e4a6d2bf8977e59cfa7428b0186b3 Mon Sep 17 00:00:00 2001
From: Lucas Mathis <lucasquinnmathis@gmail.com>
Date: Wed, 4 Mar 2026 10:21:17 +0100
Subject: [PATCH] Add STT usage in minutes to docs and spec

---
 .../admin-api/organization-usage-analytics.mdx     |  3 ++-
 api-reference/openapi.yaml                         | 14 +++++++-------
 2 files changed, 9 insertions(+), 8 deletions(-)

diff --git a/api-reference/admin-api/organization-usage-analytics.mdx b/api-reference/admin-api/organization-usage-analytics.mdx
index f11f7d2..869f5f4 100644
--- a/api-reference/admin-api/organization-usage-analytics.mdx
+++ b/api-reference/admin-api/organization-usage-analytics.mdx
@@ -35,11 +35,12 @@ The optional `group_by` parameter allows you to organize usage data in different
 
 ### Usage breakdown
 
-All responses include a breakdown of character usage by service type:
+All responses include a breakdown of usage by service type:
 * **Total characters**: Combined usage across all services
 * **Text translation characters**: Characters used for text translation
 * **Document translation characters**: Characters used for document translation
 * **Text improvement characters**: Characters used for text improvement (rephrasing)
+* **Speech-to-text minutes**: Duration of speech-to-text usage in minutes
 
 ## Use cases
 
diff --git a/api-reference/openapi.yaml b/api-reference/openapi.yaml
index dab4d3c..312335c 100644
--- a/api-reference/openapi.yaml
+++ b/api-reference/openapi.yaml
@@ -138,7 +138,7 @@ paths:
                         text_translation_characters: 4892
                         document_translation_characters: 0
                         text_improvement_characters: 4727
-                        speech_to_text_milliseconds: 1800000
+                        speech_to_text_minutes: 107.46
                       group_by: "key_and_day"
                       start_date: "2025-09-29T00:00:00"
                       end_date: "2025-10-01T00:00:00"
@@ -151,7 +151,7 @@ paths:
                           text_translation_characters: 159
                           document_translation_characters: 0
                           text_improvement_characters: 156
-                          speech_to_text_milliseconds: 1800000
+                          speech_to_text_minutes: 11.94
                 withoutGrouping:
                   summary: Usage report without grouping
                   value:
@@ -161,7 +161,7 @@ paths:
                         text_translation_characters: 4892
                         document_translation_characters: 0
                         text_improvement_characters: 4727
-                        speech_to_text_milliseconds: 1800000
+                        speech_to_text_minutes: 107.46
                       start_date: "2025-09-29T00:00:00"
                       end_date: "2025-10-01T00:00:00"
         400:
@@ -4592,10 +4592,10 @@ components:
           type: integer
           description: Number of characters used for text improvement.
           example: 4727
-        speech_to_text_milliseconds:
-          type: integer
-          description: Duration of speech-to-text usage in milliseconds.
-          example: 1800000
+        speech_to_text_minutes:
+          type: number
+          description: Duration of speech-to-text usage in minutes.
+          example: 107.46
     KeyAndDayUsageItem:
       type: object
       description: Usage statistics for a specific API key and optionally a specific date.