feat: update API specifications

Author: github-actions[bot]

openapi.yml

@@ -1009,7 +1009,8 @@ paths:
       security:
         - ApiKeyAuth: []
       operationId: getProjectUsage
-      description: Retrieves the usage for a specific project
+      description: Retrieves the usage for a specific project. Use Get Project Usage Breakdown for a more comprehensive usage summary.
+      deprecated: true
       parameters:
         - $ref: '#/components/parameters/project_id'
         - $ref: '#/components/parameters/start_date'
@@ -1101,7 +1102,7 @@ paths:
       security:
         - ApiKeyAuth: []
       operationId: getProjectUsageBreakdown
-      description: Retrieves the usage breakdown for a specific project, with various filter options by API feature or by groupings.
+      description: Retrieves the usage breakdown for a specific project, with various filter options by API feature or by groupings. Setting a feature (e.g. diarize) to true includes requests that used that feature, while false excludes requests that used it. Multiple true filters are combined with OR logic, while false filters use AND logic.
       parameters:
         - $ref: '#/components/parameters/project_id'
         - $ref: '#/components/parameters/start_date'