@coval/sdk 0.4.6 → 0.6.0

package/src/generated/apis/UploadedConversationsApi.ts

@@ -0,0 +1,812 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Coval Agents API
+ *  Manage configurations for simulations and evaluations. 
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * Contact: support@coval.dev
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+import * as runtime from '../runtime.js';
+import {
+    type CovalUploadedConversationsAPIErrorResponse,
+    CovalUploadedConversationsAPIErrorResponseFromJSON,
+    CovalUploadedConversationsAPIErrorResponseToJSON,
+} from '../models/CovalUploadedConversationsAPIErrorResponse.js';
+import {
+    type CovalUploadedConversationsAPIGetUploadedConversationResponse,
+    CovalUploadedConversationsAPIGetUploadedConversationResponseFromJSON,
+    CovalUploadedConversationsAPIGetUploadedConversationResponseToJSON,
+} from '../models/CovalUploadedConversationsAPIGetUploadedConversationResponse.js';
+import {
+    type CovalUploadedConversationsAPIListUploadedConversationMetricsResponse,
+    CovalUploadedConversationsAPIListUploadedConversationMetricsResponseFromJSON,
+    CovalUploadedConversationsAPIListUploadedConversationMetricsResponseToJSON,
+} from '../models/CovalUploadedConversationsAPIListUploadedConversationMetricsResponse.js';
+import {
+    type CovalUploadedConversationsAPIPatchUploadedConversationRequest,
+    CovalUploadedConversationsAPIPatchUploadedConversationRequestFromJSON,
+    CovalUploadedConversationsAPIPatchUploadedConversationRequestToJSON,
+} from '../models/CovalUploadedConversationsAPIPatchUploadedConversationRequest.js';
+import {
+    type CovalUploadedConversationsAPISubmitUploadedConversationRequest,
+    CovalUploadedConversationsAPISubmitUploadedConversationRequestFromJSON,
+    CovalUploadedConversationsAPISubmitUploadedConversationRequestToJSON,
+} from '../models/CovalUploadedConversationsAPISubmitUploadedConversationRequest.js';
+import {
+    type GetUploadedConversationMetric200Response,
+    GetUploadedConversationMetric200ResponseFromJSON,
+    GetUploadedConversationMetric200ResponseToJSON,
+} from '../models/GetUploadedConversationMetric200Response.js';
+import {
+    type ListUploadedConversations200Response,
+    ListUploadedConversations200ResponseFromJSON,
+    ListUploadedConversations200ResponseToJSON,
+} from '../models/ListUploadedConversations200Response.js';
+import {
+    type SubmitUploadedConversation200Response,
+    SubmitUploadedConversation200ResponseFromJSON,
+    SubmitUploadedConversation200ResponseToJSON,
+} from '../models/SubmitUploadedConversation200Response.js';
+
+export interface DeleteUploadedConversationRequest {
+    conversationId: string;
+}
+
+export interface GetUploadedConversationRequest {
+    conversationId: string;
+    includeProgress?: boolean;
+}
+
+export interface GetUploadedConversationMetricRequest {
+    conversationId: string;
+    metricOutputId: string;
+}
+
+export interface ListUploadedConversationMetricsRequest {
+    conversationId: string;
+    filter?: string;
+    pageSize?: number;
+    pageToken?: string;
+    view?: ListUploadedConversationMetricsViewEnum;
+    includeSuperseded?: boolean;
+    orderBy?: string;
+}
+
+export interface ListUploadedConversationsRequest {
+    pageSize?: number;
+    pageToken?: string;
+    consistency?: ListUploadedConversationsConsistencyEnum;
+    filter?: string;
+    orderBy?: string;
+    view?: ListUploadedConversationsViewEnum;
+    metricId?: string;
+    include?: ListUploadedConversationsIncludeEnum;
+    groupByMetadata?: string;
+    aggregation?: ListUploadedConversationsAggregationEnum;
+    startDate?: Date;
+    endDate?: Date;
+}
+
+export interface PatchUploadedConversationRequest {
+    conversationId: string;
+    covalUploadedConversationsAPIPatchUploadedConversationRequest: CovalUploadedConversationsAPIPatchUploadedConversationRequest;
+}
+
+export interface SubmitUploadedConversationRequest {
+    covalUploadedConversationsAPISubmitUploadedConversationRequest: CovalUploadedConversationsAPISubmitUploadedConversationRequest;
+}
+
+/**
+ * UploadedConversationsApi - interface
+ * 
+ * @export
+ * @interface UploadedConversationsApiInterface
+ */
+export interface UploadedConversationsApiInterface {
+    /**
+     * Creates request options for deleteUploadedConversation without sending the request
+     * @param {string} conversationId Unique conversation identifier
+     * @throws {RequiredError}
+     * @memberof UploadedConversationsApiInterface
+     */
+    deleteUploadedConversationRequestOpts(requestParameters: DeleteUploadedConversationRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Delete or cancel a conversation evaluation. 
+     * @summary Delete or cancel conversation
+     * @param {string} conversationId Unique conversation identifier
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof UploadedConversationsApiInterface
+     */
+    deleteUploadedConversationRaw(requestParameters: DeleteUploadedConversationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<object>>;
+
+    /**
+     * Delete or cancel a conversation evaluation. 
+     * Delete or cancel conversation
+     */
+    deleteUploadedConversation(requestParameters: DeleteUploadedConversationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<object>;
+
+    /**
+     * Creates request options for getUploadedConversation without sending the request
+     * @param {string} conversationId Unique conversation identifier (22-26 characters)
+     * @param {boolean} [includeProgress] Include progress tracking information
+     * @throws {RequiredError}
+     * @memberof UploadedConversationsApiInterface
+     */
+    getUploadedConversationRequestOpts(requestParameters: GetUploadedConversationRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Retrieve detailed information about a specific conversation. 
+     * @summary Get conversation details
+     * @param {string} conversationId Unique conversation identifier (22-26 characters)
+     * @param {boolean} [includeProgress] Include progress tracking information
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof UploadedConversationsApiInterface
+     */
+    getUploadedConversationRaw(requestParameters: GetUploadedConversationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CovalUploadedConversationsAPIGetUploadedConversationResponse>>;
+
+    /**
+     * Retrieve detailed information about a specific conversation. 
+     * Get conversation details
+     */
+    getUploadedConversation(requestParameters: GetUploadedConversationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CovalUploadedConversationsAPIGetUploadedConversationResponse>;
+
+    /**
+     * Creates request options for getUploadedConversationMetric without sending the request
+     * @param {string} conversationId Unique conversation identifier
+     * @param {string} metricOutputId Either a 26-char MetricOutput ULID or a 22-char Metric definition ID. See endpoint description for response shape per ID type. 
+     * @throws {RequiredError}
+     * @memberof UploadedConversationsApiInterface
+     */
+    getUploadedConversationMetricRequestOpts(requestParameters: GetUploadedConversationMetricRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Retrieve metric output(s) for a conversation by ID. The path segment accepts two ID types and returns different response shapes:  - **26-char MetricOutput ULID** (e.g. `01JCQR8Z9PQSTNVWXY12345678`):   returns a single metric output as `{ \"metric\": {...} }`. - **22-char Metric definition ID** (e.g. `29BlkepvvX19ebbLDB0y6Q`):   returns every output for that metric on the conversation as   `{ \"metric_outputs\": [...] }`.  Clients should branch on the input ID length they passed.  This endpoint serves **uploaded conversations only**. To retrieve results for a simulation — including test-metric results from `POST /v1/metrics/{metric_id}/test` — use `GET /v1/conversations/simulated/{simulation_id}/metrics/{metric_output_id}` instead. 
+     * @summary Get conversation metric output(s)
+     * @param {string} conversationId Unique conversation identifier
+     * @param {string} metricOutputId Either a 26-char MetricOutput ULID or a 22-char Metric definition ID. See endpoint description for response shape per ID type. 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof UploadedConversationsApiInterface
+     */
+    getUploadedConversationMetricRaw(requestParameters: GetUploadedConversationMetricRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetUploadedConversationMetric200Response>>;
+
+    /**
+     * Retrieve metric output(s) for a conversation by ID. The path segment accepts two ID types and returns different response shapes:  - **26-char MetricOutput ULID** (e.g. `01JCQR8Z9PQSTNVWXY12345678`):   returns a single metric output as `{ \"metric\": {...} }`. - **22-char Metric definition ID** (e.g. `29BlkepvvX19ebbLDB0y6Q`):   returns every output for that metric on the conversation as   `{ \"metric_outputs\": [...] }`.  Clients should branch on the input ID length they passed.  This endpoint serves **uploaded conversations only**. To retrieve results for a simulation — including test-metric results from `POST /v1/metrics/{metric_id}/test` — use `GET /v1/conversations/simulated/{simulation_id}/metrics/{metric_output_id}` instead. 
+     * Get conversation metric output(s)
+     */
+    getUploadedConversationMetric(requestParameters: GetUploadedConversationMetricRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetUploadedConversationMetric200Response>;
+
+    /**
+     * Creates request options for listUploadedConversationMetrics without sending the request
+     * @param {string} conversationId Unique conversation identifier
+     * @param {string} [filter] Filter expression syntax.  Values may be unquoted or double-quoted. Values containing spaces must be quoted.  **Supported fields:** - &#x60;metric_name&#x60; (string): Filter by metric name (e.g., &#x60;metric_name&#x3D;latency&#x60;) - &#x60;status&#x60; (string): Filter by status (e.g., &#x60;status&#x3D;COMPLETED&#x60;) - &#x60;output_type&#x60; (string): Filter by type (e.g., &#x60;output_type&#x3D;float&#x60;)  **Examples:** - &#x60;filter&#x3D;status&#x3D;COMPLETED&#x60; - &#x60;filter&#x3D;metric_name&#x3D;latency AND status&#x3D;COMPLETED&#x60; - &#x60;filter&#x3D;output_type&#x3D;float&#x60; 
+     * @param {number} [pageSize] Maximum number of metrics to return (1-1000)
+     * @param {string} [pageToken] Pagination token from previous response (for fetching next page)
+     * @param {'BASIC' | 'FULL'} [view] Response detail level. &#x60;FULL&#x60; preserves the historical response including structured &#x60;result&#x60; and &#x60;runtime_metadata&#x60;; &#x60;BASIC&#x60; omits those heavy fields while retaining value, status, explanation, and bounded subvalues. 
+     * @param {boolean} [includeSuperseded] Include outputs that a later re-score of the same metric has superseded.  When &#x60;false&#x60; (default) each metric contributes only its most recent output. When &#x60;true&#x60; every output is returned, so one metric may appear multiple times; recency is determined by creation time, with the &#x60;metric_output_id&#x60; ULID breaking ties, and the response order still follows &#x60;order_by&#x60;. 
+     * @param {string} [orderBy] Field to order results by.  **Supported fields:** - &#x60;metric_name&#x60; (default): Sort by metric name alphabetically - &#x60;create_time&#x60;: Sort by creation time - &#x60;start_time&#x60;: Sort by computation start time - &#x60;end_time&#x60;: Sort by computation end time - &#x60;value&#x60;: Sort by metric value (float types only)  **Prefix with &#x60;-&#x60; for descending order** (e.g., &#x60;-create_time&#x60;) 
+     * @throws {RequiredError}
+     * @memberof UploadedConversationsApiInterface
+     */
+    listUploadedConversationMetricsRequestOpts(requestParameters: ListUploadedConversationMetricsRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * List the metrics computed for a specific conversation.  Re-scoring a metric on a conversation appends a new output rather than replacing the previous one. By default this endpoint returns only the most recent output for each metric, so a metric appears at most once. Pass `include_superseded=true` to get the full history, including outputs that a later re-score has replaced. 
+     * @summary List conversation metrics
+     * @param {string} conversationId Unique conversation identifier
+     * @param {string} [filter] Filter expression syntax.  Values may be unquoted or double-quoted. Values containing spaces must be quoted.  **Supported fields:** - &#x60;metric_name&#x60; (string): Filter by metric name (e.g., &#x60;metric_name&#x3D;latency&#x60;) - &#x60;status&#x60; (string): Filter by status (e.g., &#x60;status&#x3D;COMPLETED&#x60;) - &#x60;output_type&#x60; (string): Filter by type (e.g., &#x60;output_type&#x3D;float&#x60;)  **Examples:** - &#x60;filter&#x3D;status&#x3D;COMPLETED&#x60; - &#x60;filter&#x3D;metric_name&#x3D;latency AND status&#x3D;COMPLETED&#x60; - &#x60;filter&#x3D;output_type&#x3D;float&#x60; 
+     * @param {number} [pageSize] Maximum number of metrics to return (1-1000)
+     * @param {string} [pageToken] Pagination token from previous response (for fetching next page)
+     * @param {'BASIC' | 'FULL'} [view] Response detail level. &#x60;FULL&#x60; preserves the historical response including structured &#x60;result&#x60; and &#x60;runtime_metadata&#x60;; &#x60;BASIC&#x60; omits those heavy fields while retaining value, status, explanation, and bounded subvalues. 
+     * @param {boolean} [includeSuperseded] Include outputs that a later re-score of the same metric has superseded.  When &#x60;false&#x60; (default) each metric contributes only its most recent output. When &#x60;true&#x60; every output is returned, so one metric may appear multiple times; recency is determined by creation time, with the &#x60;metric_output_id&#x60; ULID breaking ties, and the response order still follows &#x60;order_by&#x60;. 
+     * @param {string} [orderBy] Field to order results by.  **Supported fields:** - &#x60;metric_name&#x60; (default): Sort by metric name alphabetically - &#x60;create_time&#x60;: Sort by creation time - &#x60;start_time&#x60;: Sort by computation start time - &#x60;end_time&#x60;: Sort by computation end time - &#x60;value&#x60;: Sort by metric value (float types only)  **Prefix with &#x60;-&#x60; for descending order** (e.g., &#x60;-create_time&#x60;) 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof UploadedConversationsApiInterface
+     */
+    listUploadedConversationMetricsRaw(requestParameters: ListUploadedConversationMetricsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CovalUploadedConversationsAPIListUploadedConversationMetricsResponse>>;
+
+    /**
+     * List the metrics computed for a specific conversation.  Re-scoring a metric on a conversation appends a new output rather than replacing the previous one. By default this endpoint returns only the most recent output for each metric, so a metric appears at most once. Pass `include_superseded=true` to get the full history, including outputs that a later re-score has replaced. 
+     * List conversation metrics
+     */
+    listUploadedConversationMetrics(requestParameters: ListUploadedConversationMetricsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CovalUploadedConversationsAPIListUploadedConversationMetricsResponse>;
+
+    /**
+     * Creates request options for listUploadedConversations without sending the request
+     * @param {number} [pageSize] Maximum number of conversations to return (1-250)
+     * @param {string} [pageToken] Token for retrieving next page (from previous response)
+     * @param {'eventual' | 'strong'} [consistency] Read consistency for the request. &#x60;strong&#x60; is available only for a single &#x60;external_conversation_id&#x60; equality filter with &#x60;page_size&#x60; at most 2 and without expansion, ordering, pagination, or aggregate-view parameters. All other list requests use &#x60;eventual&#x60; consistency. 
+     * @param {string} [filter] Filter expression syntax.  **Operators:** &#x60;&#x3D;&#x60;, &#x60;!&#x3D;&#x60;, &#x60;&gt;&#x60;, &#x60;&lt;&#x60;, &#x60;&gt;&#x3D;&#x60;, &#x60;&lt;&#x3D;&#x60;, &#x60;AND&#x60;, &#x60;OR&#x60;  Values may be unquoted or double-quoted. Values containing spaces must be quoted.  **Fields:** - &#x60;status&#x60; - PENDING, IN_QUEUE, IN_PROGRESS, COMPLETED, FAILED, CANCELLED, DELETED - &#x60;external_conversation_id&#x60; - Your system\&#39;s conversation ID - &#x60;create_time&#x60; - ISO 8601 timestamp - &#x60;occurred_at&#x60; - ISO 8601 timestamp - &#x60;metadata.{key}&#x60; - Custom metadata fields - &#x60;metric.{metric_id}&#x60; - Filter by a metric\&#39;s value (score filtering)  **Metric-value filtering:** a &#x60;metric.{metric_id}&#x60; predicate (e.g. &#x60;metric.29Blkepvvx&lt;\&quot;0.9\&quot;&#x60;; &#x60;&gt;&#x60;/&#x60;&lt;&#x60;/&#x60;&gt;&#x3D;&#x60;/&#x60;&lt;&#x3D;&#x60;/&#x60;&#x3D;&#x60;/&#x60;!&#x3D;&#x60; for float metrics, &#x60;&#x3D;&#x60;/&#x60;!&#x3D;&#x60; for string metrics) returns only conversations whose metric matches, with every metric\&#39;s value embedded inline (&#x60;metric_values&#x60;). The metric type is inferred from the literal — a numeric literal is compared as a float metric. When a metric predicate is present the request is served with keyset pagination, ordered newest-first by creation time, and supports only &#x60;AND&#x60; alongside &#x60;create_time&#x60; (inclusive bounds), &#x60;agent_id&#x60;, and &#x60;metadata.{key}&#x60;; other filter fields (including &#x60;occurred_at&#x60;) and any non-default &#x60;order_by&#x60; are rejected with 400, and &#x60;page_size&#x60; is capped at 100.  **Examples:** - &#x60;status&#x3D;COMPLETED&#x60; - &#x60;create_time&gt;\&quot;2025-11-01T00:00:00Z\&quot;&#x60; - &#x60;status&#x3D;COMPLETED AND occurred_at&gt;&#x3D;\&quot;2025-11-01T00:00:00Z\&quot;&#x60; - &#x60;external_conversation_id&#x3D;external-call-abc&#x60; - &#x60;metric.29BlkepvvX19ebbLDB0y6Q&lt;\&quot;0.5\&quot;&#x60; 
+     * @param {string} [orderBy] Sort field with optional &#x60;-&#x60; prefix for descending order.  **Fields:** &#x60;create_time&#x60;, &#x60;occurred_at&#x60;, &#x60;status&#x60;  **Examples:** - &#x60;create_time&#x60; (ascending) - &#x60;-create_time&#x60; (descending, most recent first) - &#x60;-occurred_at&#x60; (most recent conversations first) 
+     * @param {'metric_breakdown'} [view] Set to &#x60;metric_breakdown&#x60; to return an aggregate of one metric\&#39;s scores grouped by a &#x60;customer_metadata&#x60; key (e.g. vendor), computed over the whole scored uploaded-conversation corpus, instead of the conversation list. Requires &#x60;metric_id&#x60; and &#x60;group_by_metadata&#x60;; the response is a metric-breakdown object (&#x60;{view, metric_id, group_by_metadata, aggregation, breakdown:[{metadata_value, value, count}], total_count}&#x60;). 
+     * @param {string} [metricId] Metric to aggregate when &#x60;view&#x3D;metric_breakdown&#x60;, or the metric whose full outputs should be embedded when &#x60;include&#x3D;metric_outputs&#x60;. 
+     * @param {'metric_outputs' | 'metric_values'} [include] Set to &#x60;metric_outputs&#x60; to embed full outputs for &#x60;metric_id&#x60; on every conversation in the returned page, or &#x60;metric_values&#x60; to embed every metric\&#39;s value inline on each conversation (keyset-paginated; &#x60;page_size&#x60; capped at 100). Omitted by default to keep list payloads small. 
+     * @param {string} [groupByMetadata] Required when &#x60;view&#x3D;metric_breakdown&#x60;: the customer_metadata key to group by (e.g. nlp_provider).
+     * @param {'success' | 'avg'} [aggregation] Aggregation for &#x60;view&#x3D;metric_breakdown&#x60;. Defaults to &#x60;success&#x60; (a YES/NO success rate) for binary/string metrics and &#x60;avg&#x60; (numeric mean) for float metrics. 
+     * @param {Date} [startDate] Optional ISO-8601 lower bound (occurred_at) for &#x60;view&#x3D;metric_breakdown&#x60;.
+     * @param {Date} [endDate] Optional ISO-8601 upper bound (occurred_at) for &#x60;view&#x3D;metric_breakdown&#x60;.
+     * @throws {RequiredError}
+     * @memberof UploadedConversationsApiInterface
+     */
+    listUploadedConversationsRequestOpts(requestParameters: ListUploadedConversationsRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * List conversations with optional filtering, pagination, and ordering. 
+     * @summary List conversations
+     * @param {number} [pageSize] Maximum number of conversations to return (1-250)
+     * @param {string} [pageToken] Token for retrieving next page (from previous response)
+     * @param {'eventual' | 'strong'} [consistency] Read consistency for the request. &#x60;strong&#x60; is available only for a single &#x60;external_conversation_id&#x60; equality filter with &#x60;page_size&#x60; at most 2 and without expansion, ordering, pagination, or aggregate-view parameters. All other list requests use &#x60;eventual&#x60; consistency. 
+     * @param {string} [filter] Filter expression syntax.  **Operators:** &#x60;&#x3D;&#x60;, &#x60;!&#x3D;&#x60;, &#x60;&gt;&#x60;, &#x60;&lt;&#x60;, &#x60;&gt;&#x3D;&#x60;, &#x60;&lt;&#x3D;&#x60;, &#x60;AND&#x60;, &#x60;OR&#x60;  Values may be unquoted or double-quoted. Values containing spaces must be quoted.  **Fields:** - &#x60;status&#x60; - PENDING, IN_QUEUE, IN_PROGRESS, COMPLETED, FAILED, CANCELLED, DELETED - &#x60;external_conversation_id&#x60; - Your system\&#39;s conversation ID - &#x60;create_time&#x60; - ISO 8601 timestamp - &#x60;occurred_at&#x60; - ISO 8601 timestamp - &#x60;metadata.{key}&#x60; - Custom metadata fields - &#x60;metric.{metric_id}&#x60; - Filter by a metric\&#39;s value (score filtering)  **Metric-value filtering:** a &#x60;metric.{metric_id}&#x60; predicate (e.g. &#x60;metric.29Blkepvvx&lt;\&quot;0.9\&quot;&#x60;; &#x60;&gt;&#x60;/&#x60;&lt;&#x60;/&#x60;&gt;&#x3D;&#x60;/&#x60;&lt;&#x3D;&#x60;/&#x60;&#x3D;&#x60;/&#x60;!&#x3D;&#x60; for float metrics, &#x60;&#x3D;&#x60;/&#x60;!&#x3D;&#x60; for string metrics) returns only conversations whose metric matches, with every metric\&#39;s value embedded inline (&#x60;metric_values&#x60;). The metric type is inferred from the literal — a numeric literal is compared as a float metric. When a metric predicate is present the request is served with keyset pagination, ordered newest-first by creation time, and supports only &#x60;AND&#x60; alongside &#x60;create_time&#x60; (inclusive bounds), &#x60;agent_id&#x60;, and &#x60;metadata.{key}&#x60;; other filter fields (including &#x60;occurred_at&#x60;) and any non-default &#x60;order_by&#x60; are rejected with 400, and &#x60;page_size&#x60; is capped at 100.  **Examples:** - &#x60;status&#x3D;COMPLETED&#x60; - &#x60;create_time&gt;\&quot;2025-11-01T00:00:00Z\&quot;&#x60; - &#x60;status&#x3D;COMPLETED AND occurred_at&gt;&#x3D;\&quot;2025-11-01T00:00:00Z\&quot;&#x60; - &#x60;external_conversation_id&#x3D;external-call-abc&#x60; - &#x60;metric.29BlkepvvX19ebbLDB0y6Q&lt;\&quot;0.5\&quot;&#x60; 
+     * @param {string} [orderBy] Sort field with optional &#x60;-&#x60; prefix for descending order.  **Fields:** &#x60;create_time&#x60;, &#x60;occurred_at&#x60;, &#x60;status&#x60;  **Examples:** - &#x60;create_time&#x60; (ascending) - &#x60;-create_time&#x60; (descending, most recent first) - &#x60;-occurred_at&#x60; (most recent conversations first) 
+     * @param {'metric_breakdown'} [view] Set to &#x60;metric_breakdown&#x60; to return an aggregate of one metric\&#39;s scores grouped by a &#x60;customer_metadata&#x60; key (e.g. vendor), computed over the whole scored uploaded-conversation corpus, instead of the conversation list. Requires &#x60;metric_id&#x60; and &#x60;group_by_metadata&#x60;; the response is a metric-breakdown object (&#x60;{view, metric_id, group_by_metadata, aggregation, breakdown:[{metadata_value, value, count}], total_count}&#x60;). 
+     * @param {string} [metricId] Metric to aggregate when &#x60;view&#x3D;metric_breakdown&#x60;, or the metric whose full outputs should be embedded when &#x60;include&#x3D;metric_outputs&#x60;. 
+     * @param {'metric_outputs' | 'metric_values'} [include] Set to &#x60;metric_outputs&#x60; to embed full outputs for &#x60;metric_id&#x60; on every conversation in the returned page, or &#x60;metric_values&#x60; to embed every metric\&#39;s value inline on each conversation (keyset-paginated; &#x60;page_size&#x60; capped at 100). Omitted by default to keep list payloads small. 
+     * @param {string} [groupByMetadata] Required when &#x60;view&#x3D;metric_breakdown&#x60;: the customer_metadata key to group by (e.g. nlp_provider).
+     * @param {'success' | 'avg'} [aggregation] Aggregation for &#x60;view&#x3D;metric_breakdown&#x60;. Defaults to &#x60;success&#x60; (a YES/NO success rate) for binary/string metrics and &#x60;avg&#x60; (numeric mean) for float metrics. 
+     * @param {Date} [startDate] Optional ISO-8601 lower bound (occurred_at) for &#x60;view&#x3D;metric_breakdown&#x60;.
+     * @param {Date} [endDate] Optional ISO-8601 upper bound (occurred_at) for &#x60;view&#x3D;metric_breakdown&#x60;.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof UploadedConversationsApiInterface
+     */
+    listUploadedConversationsRaw(requestParameters: ListUploadedConversationsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ListUploadedConversations200Response>>;
+
+    /**
+     * List conversations with optional filtering, pagination, and ordering. 
+     * List conversations
+     */
+    listUploadedConversations(requestParameters: ListUploadedConversationsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ListUploadedConversations200Response>;
+
+    /**
+     * Creates request options for patchUploadedConversation without sending the request
+     * @param {string} conversationId Unique conversation identifier (22-26 characters)
+     * @param {CovalUploadedConversationsAPIPatchUploadedConversationRequest} covalUploadedConversationsAPIPatchUploadedConversationRequest 
+     * @throws {RequiredError}
+     * @memberof UploadedConversationsApiInterface
+     */
+    patchUploadedConversationRequestOpts(requestParameters: PatchUploadedConversationRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Attach an audio recording, or add metadata keys, to a conversation previously submitted via `POST /v1/conversations/uploaded:submit`.  **When to attach audio**  Use this endpoint when your recording URL is not available at the moment the call ends (for example, Twilio Programmable Voice recordings that are only fetchable after an asynchronous job completes ~60 seconds later). Submit the transcript immediately at call end to get a `conversation_id` for trace correlation, then PATCH the audio when the recording URL is ready. Attaching audio triggers audio-dependent metrics as a second wave.  **When to add metadata**  Use this endpoint when a value you want to filter or segment on is only known after the call was submitted (for example, an outcome produced by post-call analysis). Once added, the key is immediately available as a filter on the Uploaded Conversations page and in the `filter` parameter of `GET /v1/conversations/uploaded`.  **Two-wave metric timing**  - Text-only metrics fire immediately after `POST /v1/conversations/uploaded:submit`   and deliver their results via your configured webhook. - Audio-dependent metrics fire after an audio PATCH and deliver a separate,   later webhook. Configure your consumer to expect both waves.  Adding metadata does **not** run or re-run any metric. If a metric depends on a key you added, rerun it with `POST /v1/conversations/simulated:rerunMetrics`.  **One-shot**  Both patch targets are write-once. Audio can be attached only once per conversation; a second PATCH on a conversation that already has audio returns `409 ALREADY_EXISTS`. Metadata is additive only; patching a key that already has a value returns `409 ALREADY_EXISTS`.  **Body**  Exactly one of `audio`, `audio_url` or `metadata` is required. 
+     * @summary Attach audio or add metadata to a conversation
+     * @param {string} conversationId Unique conversation identifier (22-26 characters)
+     * @param {CovalUploadedConversationsAPIPatchUploadedConversationRequest} covalUploadedConversationsAPIPatchUploadedConversationRequest 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof UploadedConversationsApiInterface
+     */
+    patchUploadedConversationRaw(requestParameters: PatchUploadedConversationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CovalUploadedConversationsAPIGetUploadedConversationResponse>>;
+
+    /**
+     * Attach an audio recording, or add metadata keys, to a conversation previously submitted via `POST /v1/conversations/uploaded:submit`.  **When to attach audio**  Use this endpoint when your recording URL is not available at the moment the call ends (for example, Twilio Programmable Voice recordings that are only fetchable after an asynchronous job completes ~60 seconds later). Submit the transcript immediately at call end to get a `conversation_id` for trace correlation, then PATCH the audio when the recording URL is ready. Attaching audio triggers audio-dependent metrics as a second wave.  **When to add metadata**  Use this endpoint when a value you want to filter or segment on is only known after the call was submitted (for example, an outcome produced by post-call analysis). Once added, the key is immediately available as a filter on the Uploaded Conversations page and in the `filter` parameter of `GET /v1/conversations/uploaded`.  **Two-wave metric timing**  - Text-only metrics fire immediately after `POST /v1/conversations/uploaded:submit`   and deliver their results via your configured webhook. - Audio-dependent metrics fire after an audio PATCH and deliver a separate,   later webhook. Configure your consumer to expect both waves.  Adding metadata does **not** run or re-run any metric. If a metric depends on a key you added, rerun it with `POST /v1/conversations/simulated:rerunMetrics`.  **One-shot**  Both patch targets are write-once. Audio can be attached only once per conversation; a second PATCH on a conversation that already has audio returns `409 ALREADY_EXISTS`. Metadata is additive only; patching a key that already has a value returns `409 ALREADY_EXISTS`.  **Body**  Exactly one of `audio`, `audio_url` or `metadata` is required. 
+     * Attach audio or add metadata to a conversation
+     */
+    patchUploadedConversation(requestParameters: PatchUploadedConversationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CovalUploadedConversationsAPIGetUploadedConversationResponse>;
+
+    /**
+     * Creates request options for submitUploadedConversation without sending the request
+     * @param {CovalUploadedConversationsAPISubmitUploadedConversationRequest} covalUploadedConversationsAPISubmitUploadedConversationRequest 
+     * @throws {RequiredError}
+     * @memberof UploadedConversationsApiInterface
+     */
+    submitUploadedConversationRequestOpts(requestParameters: SubmitUploadedConversationRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Submit an uploaded conversation for evaluation. 
+     * @summary Submit conversation for evaluation
+     * @param {CovalUploadedConversationsAPISubmitUploadedConversationRequest} covalUploadedConversationsAPISubmitUploadedConversationRequest 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof UploadedConversationsApiInterface
+     */
+    submitUploadedConversationRaw(requestParameters: SubmitUploadedConversationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SubmitUploadedConversation200Response>>;
+
+    /**
+     * Submit an uploaded conversation for evaluation. 
+     * Submit conversation for evaluation
+     */
+    submitUploadedConversation(requestParameters: SubmitUploadedConversationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SubmitUploadedConversation200Response>;
+
+}
+
+/**
+ * 
+ */
+export class UploadedConversationsApi extends runtime.BaseAPI implements UploadedConversationsApiInterface {
+
+    /**
+     * Creates request options for deleteUploadedConversation without sending the request
+     */
+    async deleteUploadedConversationRequestOpts(requestParameters: DeleteUploadedConversationRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['conversationId'] == null) {
+            throw new runtime.RequiredError(
+                'conversationId',
+                'Required parameter "conversationId" was null or undefined when calling deleteUploadedConversation().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.apiKey) {
+            headerParameters["X-API-Key"] = await this.configuration.apiKey("X-API-Key"); // Coval_Uploaded_Conversations_API_ApiKeyAuth authentication
+        }
+
+
+        let urlPath = `/conversations/uploaded/{conversation_id}`;
+        urlPath = urlPath.replace('{conversation_id}', encodeURIComponent(String(requestParameters['conversationId'])));
+
+        return {
+            path: urlPath,
+            method: 'DELETE',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Delete or cancel a conversation evaluation. 
+     * Delete or cancel conversation
+     */
+    async deleteUploadedConversationRaw(requestParameters: DeleteUploadedConversationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<object>> {
+        const requestOptions = await this.deleteUploadedConversationRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse<any>(response);
+    }
+
+    /**
+     * Delete or cancel a conversation evaluation. 
+     * Delete or cancel conversation
+     */
+    async deleteUploadedConversation(requestParameters: DeleteUploadedConversationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<object> {
+        const response = await this.deleteUploadedConversationRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for getUploadedConversation without sending the request
+     */
+    async getUploadedConversationRequestOpts(requestParameters: GetUploadedConversationRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['conversationId'] == null) {
+            throw new runtime.RequiredError(
+                'conversationId',
+                'Required parameter "conversationId" was null or undefined when calling getUploadedConversation().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['includeProgress'] != null) {
+            queryParameters['include_progress'] = requestParameters['includeProgress'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.apiKey) {
+            headerParameters["X-API-Key"] = await this.configuration.apiKey("X-API-Key"); // Coval_Uploaded_Conversations_API_ApiKeyAuth authentication
+        }
+
+
+        let urlPath = `/conversations/uploaded/{conversation_id}`;
+        urlPath = urlPath.replace('{conversation_id}', encodeURIComponent(String(requestParameters['conversationId'])));
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Retrieve detailed information about a specific conversation. 
+     * Get conversation details
+     */
+    async getUploadedConversationRaw(requestParameters: GetUploadedConversationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CovalUploadedConversationsAPIGetUploadedConversationResponse>> {
+        const requestOptions = await this.getUploadedConversationRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => CovalUploadedConversationsAPIGetUploadedConversationResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Retrieve detailed information about a specific conversation. 
+     * Get conversation details
+     */
+    async getUploadedConversation(requestParameters: GetUploadedConversationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CovalUploadedConversationsAPIGetUploadedConversationResponse> {
+        const response = await this.getUploadedConversationRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for getUploadedConversationMetric without sending the request
+     */
+    async getUploadedConversationMetricRequestOpts(requestParameters: GetUploadedConversationMetricRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['conversationId'] == null) {
+            throw new runtime.RequiredError(
+                'conversationId',
+                'Required parameter "conversationId" was null or undefined when calling getUploadedConversationMetric().'
+            );
+        }
+
+        if (requestParameters['metricOutputId'] == null) {
+            throw new runtime.RequiredError(
+                'metricOutputId',
+                'Required parameter "metricOutputId" was null or undefined when calling getUploadedConversationMetric().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.apiKey) {
+            headerParameters["X-API-Key"] = await this.configuration.apiKey("X-API-Key"); // Coval_Uploaded_Conversations_API_ApiKeyAuth authentication
+        }
+
+
+        let urlPath = `/conversations/uploaded/{conversation_id}/metrics/{metric_output_id}`;
+        urlPath = urlPath.replace('{conversation_id}', encodeURIComponent(String(requestParameters['conversationId'])));
+        urlPath = urlPath.replace('{metric_output_id}', encodeURIComponent(String(requestParameters['metricOutputId'])));
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Retrieve metric output(s) for a conversation by ID. The path segment accepts two ID types and returns different response shapes:  - **26-char MetricOutput ULID** (e.g. `01JCQR8Z9PQSTNVWXY12345678`):   returns a single metric output as `{ \"metric\": {...} }`. - **22-char Metric definition ID** (e.g. `29BlkepvvX19ebbLDB0y6Q`):   returns every output for that metric on the conversation as   `{ \"metric_outputs\": [...] }`.  Clients should branch on the input ID length they passed.  This endpoint serves **uploaded conversations only**. To retrieve results for a simulation — including test-metric results from `POST /v1/metrics/{metric_id}/test` — use `GET /v1/conversations/simulated/{simulation_id}/metrics/{metric_output_id}` instead. 
+     * Get conversation metric output(s)
+     */
+    async getUploadedConversationMetricRaw(requestParameters: GetUploadedConversationMetricRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetUploadedConversationMetric200Response>> {
+        const requestOptions = await this.getUploadedConversationMetricRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => GetUploadedConversationMetric200ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Retrieve metric output(s) for a conversation by ID. The path segment accepts two ID types and returns different response shapes:  - **26-char MetricOutput ULID** (e.g. `01JCQR8Z9PQSTNVWXY12345678`):   returns a single metric output as `{ \"metric\": {...} }`. - **22-char Metric definition ID** (e.g. `29BlkepvvX19ebbLDB0y6Q`):   returns every output for that metric on the conversation as   `{ \"metric_outputs\": [...] }`.  Clients should branch on the input ID length they passed.  This endpoint serves **uploaded conversations only**. To retrieve results for a simulation — including test-metric results from `POST /v1/metrics/{metric_id}/test` — use `GET /v1/conversations/simulated/{simulation_id}/metrics/{metric_output_id}` instead. 
+     * Get conversation metric output(s)
+     */
+    async getUploadedConversationMetric(requestParameters: GetUploadedConversationMetricRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetUploadedConversationMetric200Response> {
+        const response = await this.getUploadedConversationMetricRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for listUploadedConversationMetrics without sending the request
+     */
+    async listUploadedConversationMetricsRequestOpts(requestParameters: ListUploadedConversationMetricsRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['conversationId'] == null) {
+            throw new runtime.RequiredError(
+                'conversationId',
+                'Required parameter "conversationId" was null or undefined when calling listUploadedConversationMetrics().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['filter'] != null) {
+            queryParameters['filter'] = requestParameters['filter'];
+        }
+
+        if (requestParameters['pageSize'] != null) {
+            queryParameters['page_size'] = requestParameters['pageSize'];
+        }
+
+        if (requestParameters['pageToken'] != null) {
+            queryParameters['page_token'] = requestParameters['pageToken'];
+        }
+
+        if (requestParameters['view'] != null) {
+            queryParameters['view'] = requestParameters['view'];
+        }
+
+        if (requestParameters['includeSuperseded'] != null) {
+            queryParameters['include_superseded'] = requestParameters['includeSuperseded'];
+        }
+
+        if (requestParameters['orderBy'] != null) {
+            queryParameters['order_by'] = requestParameters['orderBy'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.apiKey) {
+            headerParameters["X-API-Key"] = await this.configuration.apiKey("X-API-Key"); // Coval_Uploaded_Conversations_API_ApiKeyAuth authentication
+        }
+
+
+        let urlPath = `/conversations/uploaded/{conversation_id}/metrics`;
+        urlPath = urlPath.replace('{conversation_id}', encodeURIComponent(String(requestParameters['conversationId'])));
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * List the metrics computed for a specific conversation.  Re-scoring a metric on a conversation appends a new output rather than replacing the previous one. By default this endpoint returns only the most recent output for each metric, so a metric appears at most once. Pass `include_superseded=true` to get the full history, including outputs that a later re-score has replaced. 
+     * List conversation metrics
+     */
+    async listUploadedConversationMetricsRaw(requestParameters: ListUploadedConversationMetricsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CovalUploadedConversationsAPIListUploadedConversationMetricsResponse>> {
+        const requestOptions = await this.listUploadedConversationMetricsRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => CovalUploadedConversationsAPIListUploadedConversationMetricsResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * List the metrics computed for a specific conversation.  Re-scoring a metric on a conversation appends a new output rather than replacing the previous one. By default this endpoint returns only the most recent output for each metric, so a metric appears at most once. Pass `include_superseded=true` to get the full history, including outputs that a later re-score has replaced. 
+     * List conversation metrics
+     */
+    async listUploadedConversationMetrics(requestParameters: ListUploadedConversationMetricsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CovalUploadedConversationsAPIListUploadedConversationMetricsResponse> {
+        const response = await this.listUploadedConversationMetricsRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for listUploadedConversations without sending the request
+     */
+    async listUploadedConversationsRequestOpts(requestParameters: ListUploadedConversationsRequest): Promise<runtime.RequestOpts> {
+        const queryParameters: any = {};
+
+        if (requestParameters['pageSize'] != null) {
+            queryParameters['page_size'] = requestParameters['pageSize'];
+        }
+
+        if (requestParameters['pageToken'] != null) {
+            queryParameters['page_token'] = requestParameters['pageToken'];
+        }
+
+        if (requestParameters['consistency'] != null) {
+            queryParameters['consistency'] = requestParameters['consistency'];
+        }
+
+        if (requestParameters['filter'] != null) {
+            queryParameters['filter'] = requestParameters['filter'];
+        }
+
+        if (requestParameters['orderBy'] != null) {
+            queryParameters['order_by'] = requestParameters['orderBy'];
+        }
+
+        if (requestParameters['view'] != null) {
+            queryParameters['view'] = requestParameters['view'];
+        }
+
+        if (requestParameters['metricId'] != null) {
+            queryParameters['metric_id'] = requestParameters['metricId'];
+        }
+
+        if (requestParameters['include'] != null) {
+            queryParameters['include'] = requestParameters['include'];
+        }
+
+        if (requestParameters['groupByMetadata'] != null) {
+            queryParameters['group_by_metadata'] = requestParameters['groupByMetadata'];
+        }
+
+        if (requestParameters['aggregation'] != null) {
+            queryParameters['aggregation'] = requestParameters['aggregation'];
+        }
+
+        if (requestParameters['startDate'] != null) {
+            queryParameters['start_date'] = (requestParameters['startDate'] as any).toISOString();
+        }
+
+        if (requestParameters['endDate'] != null) {
+            queryParameters['end_date'] = (requestParameters['endDate'] as any).toISOString();
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.apiKey) {
+            headerParameters["X-API-Key"] = await this.configuration.apiKey("X-API-Key"); // Coval_Uploaded_Conversations_API_ApiKeyAuth authentication
+        }
+
+
+        let urlPath = `/conversations/uploaded`;
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * List conversations with optional filtering, pagination, and ordering. 
+     * List conversations
+     */
+    async listUploadedConversationsRaw(requestParameters: ListUploadedConversationsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ListUploadedConversations200Response>> {
+        const requestOptions = await this.listUploadedConversationsRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => ListUploadedConversations200ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * List conversations with optional filtering, pagination, and ordering. 
+     * List conversations
+     */
+    async listUploadedConversations(requestParameters: ListUploadedConversationsRequest = {}, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ListUploadedConversations200Response> {
+        const response = await this.listUploadedConversationsRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for patchUploadedConversation without sending the request
+     */
+    async patchUploadedConversationRequestOpts(requestParameters: PatchUploadedConversationRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['conversationId'] == null) {
+            throw new runtime.RequiredError(
+                'conversationId',
+                'Required parameter "conversationId" was null or undefined when calling patchUploadedConversation().'
+            );
+        }
+
+        if (requestParameters['covalUploadedConversationsAPIPatchUploadedConversationRequest'] == null) {
+            throw new runtime.RequiredError(
+                'covalUploadedConversationsAPIPatchUploadedConversationRequest',
+                'Required parameter "covalUploadedConversationsAPIPatchUploadedConversationRequest" was null or undefined when calling patchUploadedConversation().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/json';
+
+        if (this.configuration && this.configuration.apiKey) {
+            headerParameters["X-API-Key"] = await this.configuration.apiKey("X-API-Key"); // Coval_Uploaded_Conversations_API_ApiKeyAuth authentication
+        }
+
+
+        let urlPath = `/conversations/uploaded/{conversation_id}`;
+        urlPath = urlPath.replace('{conversation_id}', encodeURIComponent(String(requestParameters['conversationId'])));
+
+        return {
+            path: urlPath,
+            method: 'PATCH',
+            headers: headerParameters,
+            query: queryParameters,
+            body: CovalUploadedConversationsAPIPatchUploadedConversationRequestToJSON(requestParameters['covalUploadedConversationsAPIPatchUploadedConversationRequest']),
+        };
+    }
+
+    /**
+     * Attach an audio recording, or add metadata keys, to a conversation previously submitted via `POST /v1/conversations/uploaded:submit`.  **When to attach audio**  Use this endpoint when your recording URL is not available at the moment the call ends (for example, Twilio Programmable Voice recordings that are only fetchable after an asynchronous job completes ~60 seconds later). Submit the transcript immediately at call end to get a `conversation_id` for trace correlation, then PATCH the audio when the recording URL is ready. Attaching audio triggers audio-dependent metrics as a second wave.  **When to add metadata**  Use this endpoint when a value you want to filter or segment on is only known after the call was submitted (for example, an outcome produced by post-call analysis). Once added, the key is immediately available as a filter on the Uploaded Conversations page and in the `filter` parameter of `GET /v1/conversations/uploaded`.  **Two-wave metric timing**  - Text-only metrics fire immediately after `POST /v1/conversations/uploaded:submit`   and deliver their results via your configured webhook. - Audio-dependent metrics fire after an audio PATCH and deliver a separate,   later webhook. Configure your consumer to expect both waves.  Adding metadata does **not** run or re-run any metric. If a metric depends on a key you added, rerun it with `POST /v1/conversations/simulated:rerunMetrics`.  **One-shot**  Both patch targets are write-once. Audio can be attached only once per conversation; a second PATCH on a conversation that already has audio returns `409 ALREADY_EXISTS`. Metadata is additive only; patching a key that already has a value returns `409 ALREADY_EXISTS`.  **Body**  Exactly one of `audio`, `audio_url` or `metadata` is required. 
+     * Attach audio or add metadata to a conversation
+     */
+    async patchUploadedConversationRaw(requestParameters: PatchUploadedConversationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CovalUploadedConversationsAPIGetUploadedConversationResponse>> {
+        const requestOptions = await this.patchUploadedConversationRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => CovalUploadedConversationsAPIGetUploadedConversationResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Attach an audio recording, or add metadata keys, to a conversation previously submitted via `POST /v1/conversations/uploaded:submit`.  **When to attach audio**  Use this endpoint when your recording URL is not available at the moment the call ends (for example, Twilio Programmable Voice recordings that are only fetchable after an asynchronous job completes ~60 seconds later). Submit the transcript immediately at call end to get a `conversation_id` for trace correlation, then PATCH the audio when the recording URL is ready. Attaching audio triggers audio-dependent metrics as a second wave.  **When to add metadata**  Use this endpoint when a value you want to filter or segment on is only known after the call was submitted (for example, an outcome produced by post-call analysis). Once added, the key is immediately available as a filter on the Uploaded Conversations page and in the `filter` parameter of `GET /v1/conversations/uploaded`.  **Two-wave metric timing**  - Text-only metrics fire immediately after `POST /v1/conversations/uploaded:submit`   and deliver their results via your configured webhook. - Audio-dependent metrics fire after an audio PATCH and deliver a separate,   later webhook. Configure your consumer to expect both waves.  Adding metadata does **not** run or re-run any metric. If a metric depends on a key you added, rerun it with `POST /v1/conversations/simulated:rerunMetrics`.  **One-shot**  Both patch targets are write-once. Audio can be attached only once per conversation; a second PATCH on a conversation that already has audio returns `409 ALREADY_EXISTS`. Metadata is additive only; patching a key that already has a value returns `409 ALREADY_EXISTS`.  **Body**  Exactly one of `audio`, `audio_url` or `metadata` is required. 
+     * Attach audio or add metadata to a conversation
+     */
+    async patchUploadedConversation(requestParameters: PatchUploadedConversationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CovalUploadedConversationsAPIGetUploadedConversationResponse> {
+        const response = await this.patchUploadedConversationRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for submitUploadedConversation without sending the request
+     */
+    async submitUploadedConversationRequestOpts(requestParameters: SubmitUploadedConversationRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['covalUploadedConversationsAPISubmitUploadedConversationRequest'] == null) {
+            throw new runtime.RequiredError(
+                'covalUploadedConversationsAPISubmitUploadedConversationRequest',
+                'Required parameter "covalUploadedConversationsAPISubmitUploadedConversationRequest" was null or undefined when calling submitUploadedConversation().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/json';
+
+        if (this.configuration && this.configuration.apiKey) {
+            headerParameters["X-API-Key"] = await this.configuration.apiKey("X-API-Key"); // Coval_Uploaded_Conversations_API_ApiKeyAuth authentication
+        }
+
+
+        let urlPath = `/conversations/uploaded:submit`;
+
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: CovalUploadedConversationsAPISubmitUploadedConversationRequestToJSON(requestParameters['covalUploadedConversationsAPISubmitUploadedConversationRequest']),
+        };
+    }
+
+    /**
+     * Submit an uploaded conversation for evaluation. 
+     * Submit conversation for evaluation
+     */
+    async submitUploadedConversationRaw(requestParameters: SubmitUploadedConversationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SubmitUploadedConversation200Response>> {
+        const requestOptions = await this.submitUploadedConversationRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => SubmitUploadedConversation200ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Submit an uploaded conversation for evaluation. 
+     * Submit conversation for evaluation
+     */
+    async submitUploadedConversation(requestParameters: SubmitUploadedConversationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SubmitUploadedConversation200Response> {
+        const response = await this.submitUploadedConversationRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+}
+
+/**
+ * @export
+ */
+export const ListUploadedConversationMetricsViewEnum = {
+    Basic: 'BASIC',
+    Full: 'FULL'
+} as const;
+export type ListUploadedConversationMetricsViewEnum = typeof ListUploadedConversationMetricsViewEnum[keyof typeof ListUploadedConversationMetricsViewEnum];
+/**
+ * @export
+ */
+export const ListUploadedConversationsConsistencyEnum = {
+    Eventual: 'eventual',
+    Strong: 'strong'
+} as const;
+export type ListUploadedConversationsConsistencyEnum = typeof ListUploadedConversationsConsistencyEnum[keyof typeof ListUploadedConversationsConsistencyEnum];
+/**
+ * @export
+ */
+export const ListUploadedConversationsViewEnum = {
+    MetricBreakdown: 'metric_breakdown'
+} as const;
+export type ListUploadedConversationsViewEnum = typeof ListUploadedConversationsViewEnum[keyof typeof ListUploadedConversationsViewEnum];
+/**
+ * @export
+ */
+export const ListUploadedConversationsIncludeEnum = {
+    MetricOutputs: 'metric_outputs',
+    MetricValues: 'metric_values'
+} as const;
+export type ListUploadedConversationsIncludeEnum = typeof ListUploadedConversationsIncludeEnum[keyof typeof ListUploadedConversationsIncludeEnum];
+/**
+ * @export
+ */
+export const ListUploadedConversationsAggregationEnum = {
+    Success: 'success',
+    Avg: 'avg'
+} as const;
+export type ListUploadedConversationsAggregationEnum = typeof ListUploadedConversationsAggregationEnum[keyof typeof ListUploadedConversationsAggregationEnum];