telnyx 7.8.0 → 7.9.0

package/src/resources/ai/conversations/conversation-insights.ts

@@ -0,0 +1,125 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import { APIPromise } from '../../../core/api-promise';
+import { RequestOptions } from '../../../internal/request-options';
+
+/**
+ * Manage historical AI assistant conversations
+ */
+export class ConversationInsights extends APIResource {
+  /**
+   * Aggregate conversation insights by specified fields
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await client.ai.conversations.conversationInsights.retrieveAggregates();
+   * ```
+   */
+  retrieveAggregates(
+    query: ConversationInsightRetrieveAggregatesParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<ConversationInsightRetrieveAggregatesResponse> {
+    return this._client.get('/ai/conversations/conversation-insights/aggregates', { query, ...options });
+  }
+}
+
+/**
+ * Aggregated conversation insight counts grouped by the specified fields. Each
+ * item in `data` contains the grouped field values and a `record_count` indicating
+ * how many conversation insights match that combination.
+ */
+export interface ConversationInsightRetrieveAggregatesResponse {
+  /**
+   * Aggregation result rows. Each row contains the grouped field values and a
+   * `record_count`.
+   */
+  data: Array<ConversationInsightRetrieveAggregatesResponse.Data>;
+}
+
+export namespace ConversationInsightRetrieveAggregatesResponse {
+  /**
+   * An aggregation row. Contains the grouped field values (keyed by the group_by
+   * field names) and a `record_count` integer. For example, when grouping by
+   * `score`, each row has a `score` value and a `record_count` of conversations with
+   * that score. When also splitting by `metadata.assistant_version_id`, each row
+   * includes both `score` and `metadata.assistant_version_id` plus their combined
+   * `record_count`.
+   */
+  export interface Data {
+    /**
+     * Number of conversation insights that match this combination of grouped field
+     * values.
+     */
+    record_count: number;
+
+    [k: string]: unknown;
+  }
+}
+
+export interface ConversationInsightRetrieveAggregatesParams {
+  /**
+   * Filter by creation datetime to scope the aggregation window. Supports range
+   * operators (e.g., `created_at=gte.2025-01-01T00:00:00Z` for the start of the
+   * range, `created_at=lt.2025-01-02T00:00:00Z` for the end). To build per-day time
+   * series (as the portal does for the 'Insights Over Time' chart), issue one
+   * request per day bounded by `created_at=gte.<day_start>` and
+   * `created_at=lt.<next_day_start>`.
+   */
+  created_at?: string;
+
+  /**
+   * Fields to group by (can be comma-separated or multiple parameters). Prefix a
+   * field with 'metadata.' (e.g. 'metadata.assistant_id') to group by the
+   * conversation's metadata instead of the insight result.
+   *
+   * Common fields used for over-time charts:
+   *
+   * - `score` — Group by the insight's score value (e.g. for Agent Instruction
+   *   Following, User Satisfaction).
+   * - `metadata.assistant_id` — Group by the assistant that handled the
+   *   conversation.
+   * - `metadata.assistant_version_id` — Group by the assistant version, useful for
+   *   comparing performance across versions in the portal's 'Insights Over Time'
+   *   chart.
+   * - `metadata.telnyx_conversation_channel` — Group by conversation channel
+   *   (phone_call, web_chat, etc.).
+   */
+  group_by?: Array<string>;
+
+  /**
+   * Optional insight ID to filter conversation insights. Only insights matching this
+   * ID will be included in the aggregation.
+   */
+  insight_id?: string;
+
+  metadata?: ConversationInsightRetrieveAggregatesParams.Metadata;
+
+  /**
+   * Fields to include in the result (can be comma-separated or multiple parameters).
+   * Supports the same 'metadata.<key>' prefix as group_by. Each returned row will
+   * contain the grouped field values plus a `record_count` indicating how many
+   * conversation insights match that combination.
+   */
+  show?: Array<string>;
+}
+
+export namespace ConversationInsightRetrieveAggregatesParams {
+  export interface Metadata {
+    /**
+     * Filter by assistant ID (e.g., `metadata.assistant_id=eq.<assistant_id>`). When
+     * provided, only conversation insights for the specified assistant are aggregated.
+     * Used by the portal to scope the 'Insights Over Time' chart to a single
+     * assistant.
+     */
+    assistant_id?: string;
+  }
+}
+
+export declare namespace ConversationInsights {
+  export {
+    type ConversationInsightRetrieveAggregatesResponse as ConversationInsightRetrieveAggregatesResponse,
+    type ConversationInsightRetrieveAggregatesParams as ConversationInsightRetrieveAggregatesParams,
+  };
+}

package/src/resources/ai/conversations/conversations.ts

@@ -1,6 +1,12 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../../core/resource';
+import * as ConversationInsightsAPI from './conversation-insights';
+import {
+  ConversationInsightRetrieveAggregatesParams,
+  ConversationInsightRetrieveAggregatesResponse,
+  ConversationInsights,
+} from './conversation-insights';
 import * as InsightsAPI from './insights';
 import {
   InsightCreateParams,
@@ -41,6 +47,8 @@ export class Conversations extends APIResource {
   insightGroups: InsightGroupsAPI.InsightGroups = new InsightGroupsAPI.InsightGroups(this._client);
   insights: InsightsAPI.Insights = new InsightsAPI.Insights(this._client);
   messages: MessagesAPI.Messages = new MessagesAPI.Messages(this._client);
+  conversationInsights: ConversationInsightsAPI.ConversationInsights =
+    new ConversationInsightsAPI.ConversationInsights(this._client);
 
   /**
    * Retrieve a list of all AI conversations configured by the user. Supports
@@ -354,6 +362,7 @@ export interface ConversationAddMessageParams {
 Conversations.InsightGroups = InsightGroups;
 Conversations.Insights = Insights;
 Conversations.Messages = Messages;
+Conversations.ConversationInsights = ConversationInsights;
 
 export declare namespace Conversations {
   export {
@@ -394,4 +403,10 @@ export declare namespace Conversations {
     type MessageListResponsesDefaultFlatPagination as MessageListResponsesDefaultFlatPagination,
     type MessageListParams as MessageListParams,
   };
+
+  export {
+    ConversationInsights as ConversationInsights,
+    type ConversationInsightRetrieveAggregatesResponse as ConversationInsightRetrieveAggregatesResponse,
+    type ConversationInsightRetrieveAggregatesParams as ConversationInsightRetrieveAggregatesParams,
+  };
 }

package/src/resources/ai/conversations/index.ts

@@ -1,5 +1,10 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+export {
+  ConversationInsights,
+  type ConversationInsightRetrieveAggregatesResponse,
+  type ConversationInsightRetrieveAggregatesParams,
+} from './conversation-insights';
 export {
   Conversations,
   type Conversation,

package/src/resources/ai/index.ts

@@ -9,6 +9,7 @@ export {
   type AISummarizeParams,
   type AIRetrieveConversationHistoriesParams,
 } from './ai';
+export { Anthropic } from './anthropic/index';
 export {
   Assistants,
   type ArithmeticExpression,
@@ -130,6 +131,7 @@ export {
 export { OpenAI, type OpenAICreateResponseResponse, type OpenAICreateResponseParams } from './openai/index';
 export {
   Tools,
+  type PayToolParams,
   type SharedToolResponse,
   type ToolDeleteResponse,
   type ToolListParams,

package/src/resources/ai/tools.ts

@@ -89,6 +89,29 @@ export class Tools extends APIResource {
 
 export type SharedToolResponsesDefaultFlatPagination = DefaultFlatPagination<SharedToolResponse>;
 
+export interface PayToolParams {
+  /**
+   * The name of the pay connector configured in the Telnyx API. Must reference an
+   * existing pay connector for this organization.
+   */
+  connector_name: string;
+
+  /**
+   * Default currency for payments processed by this tool.
+   */
+  currency?: string;
+
+  /**
+   * Optional description of the pay tool that will be passed to the assistant.
+   */
+  description?: string | null;
+
+  /**
+   * Default payment method for payments processed by this tool.
+   */
+  payment_method?: string;
+}
+
 export interface SharedToolResponse {
   id: string;
 
@@ -130,6 +153,8 @@ export interface ToolCreateParams {
 
   invite?: { [key: string]: unknown };
 
+  pay?: PayToolParams;
+
   retrieval?: { [key: string]: unknown };
 
   timeout_ms?: number;
@@ -150,6 +175,8 @@ export interface ToolUpdateParams {
 
   invite?: { [key: string]: unknown };
 
+  pay?: PayToolParams;
+
   retrieval?: { [key: string]: unknown };
 
   timeout_ms?: number;
@@ -163,6 +190,7 @@ export interface ToolUpdateParams {
 
 export declare namespace Tools {
   export {
+    type PayToolParams as PayToolParams,
     type SharedToolResponse as SharedToolResponse,
     type ToolDeleteResponse as ToolDeleteResponse,
     type SharedToolResponsesDefaultFlatPagination as SharedToolResponsesDefaultFlatPagination,

package/src/resources/calls/actions.ts

@@ -1589,7 +1589,11 @@ export interface TranscriptionConfig {
    * controls the language hint), `multi` (no language hint), and language-specific
    * hints `en`, `es`, `fr`, `de`, `hi`, `ru`, `pt`, `ja`, `it`, and `nl`. For
    * `soniox/stt-rt-v4`, `auto` omits the language hint and lets Soniox auto-detect;
-   * ISO 639-1 codes (e.g. `en`, `es`) bias detection toward that language.
+   * ISO 639-1 codes (e.g. `en`, `es`) bias detection toward that language. For
+   * `assemblyai/universal-streaming`, `auto` (or unset) enables native multilingual
+   * code-switching; ISO 639-1 codes (`en`, `es`, `de`, `fr`, `pt`, `it`, `tr`, `nl`,
+   * `sv`, `no`, `da`, `fi`, `hi`, `vi`, `ar`, `he`, `ja`, `zh`) bias the session to
+   * that language.
    */
   language?: string;
 
@@ -1605,7 +1609,7 @@ export interface TranscriptionConfig {
    * - `xai/grok-stt` for live streaming transcription.
    * - `soniox/stt-rt-v4` for live streaming multilingual transcription with
    *   automatic language detection.
-   * - `parakeet/tdt-0.6b-v3` for multilingual transcription with automatic language
+   * - `nvidia/parakeet-v3` for multilingual transcription with automatic language
    *   detection.
    * - `azure/fast` and `azure/realtime`; Azure models require `region`, and
    *   unsupported regions require `api_key_ref`.
@@ -1625,7 +1629,7 @@ export interface TranscriptionConfig {
     | 'assemblyai/universal-streaming'
     | 'xai/grok-stt'
     | 'soniox/stt-rt-v4'
-    | 'parakeet/tdt-0.6b-v3'
+    | 'nvidia/parakeet-v3'
     | 'azure/fast'
     | 'azure/realtime'
     | 'google/latest_long'
@@ -1939,7 +1943,7 @@ export interface TranscriptionEngineParakeetConfig {
   /**
    * The model to use for transcription.
    */
-  transcription_model?: 'parakeet/tdt-0.6b-v3';
+  transcription_model?: 'nvidia/parakeet-v3';
 }
 
 export interface TranscriptionEngineSonioxConfig {

package/src/resources/calls/calls.ts

@@ -1108,6 +1108,15 @@ export interface CallDialParams {
    */
   record_trim?: 'trim-silence';
 
+  /**
+   * Whether to keep trying the remaining routing paths (e.g. alternate
+   * providers/gateways) for the same destination after `timeout_secs` is reached for
+   * the current attempt. When set to `false`, reaching `timeout_secs` aborts the
+   * entire dial attempt and the `call.hangup` webhook reports a `hangup_cause` of
+   * `no_answer` instead of `timeout`.
+   */
+  retry_on_timeout?: boolean;
+
   /**
    * DTMF digits to send automatically after the called party answers. Useful for
    * reaching an extension behind an IVR (e.g. `"200"` to dial extension 200 once the

package/src/resources/index.ts

@@ -1072,6 +1072,7 @@ export {
   type DocReqsRequirement,
   type RequirementRetrieveResponse,
   type RequirementListParams,
+  type RequirementRetrieveParams,
   type DocReqsRequirementsDefaultFlatPagination,
 } from './requirements';
 export {

package/src/resources/managed-accounts/managed-accounts.ts

@@ -374,7 +374,7 @@ export interface ManagedAccountListParams extends DefaultFlatPaginationParams {
   /**
    * Consolidated filter parameter (deepObject style). Originally:
    * filter[email][contains], filter[email][eq], filter[organization_name][contains],
-   * filter[organization_name][eq]
+   * filter[organization_name][eq], filter[status][eq]
    */
   filter?: ManagedAccountListParams.Filter;
 
@@ -406,12 +406,14 @@ export namespace ManagedAccountListParams {
   /**
    * Consolidated filter parameter (deepObject style). Originally:
    * filter[email][contains], filter[email][eq], filter[organization_name][contains],
-   * filter[organization_name][eq]
+   * filter[organization_name][eq], filter[status][eq]
    */
   export interface Filter {
     email?: Filter.Email;
 
     organization_name?: Filter.OrganizationName;
+
+    status?: Filter.Status;
   }
 
   export namespace Filter {
@@ -443,6 +445,15 @@ export namespace ManagedAccountListParams {
        */
       eq?: string;
     }
+
+    export interface Status {
+      /**
+       * If present, only returns managed accounts with the <code>status</code> matching
+       * exactly the value given. Use <code>enabled</code> or <code>disabled</code> to
+       * filter accounts by whether they are currently able to use Telnyx services.
+       */
+      eq?: 'all' | 'active' | 'enabled' | 'cancelled' | 'disabled' | 'blocked';
+    }
   }
 }
 

package/src/resources/requirements.ts

@@ -42,8 +42,12 @@ export class Requirements extends APIResource {
    * );
    * ```
    */
-  retrieve(id: string, options?: RequestOptions): APIPromise<RequirementRetrieveResponse> {
-    return this._client.get(path`/requirements/${id}`, options);
+  retrieve(
+    id: string,
+    query: RequirementRetrieveParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<RequirementRetrieveResponse> {
+    return this._client.get(path`/requirements/${id}`, { query, ...options });
   }
 }
 
@@ -71,6 +75,17 @@ export interface DocReqsRequirement {
    */
   created_at?: string;
 
+  /**
+   * When this version was superseded. NULL means this is the active or pending
+   * version.
+   */
+  effective_end_at?: string | null;
+
+  /**
+   * When this version became (or will become) active.
+   */
+  effective_start_at?: string | null;
+
   /**
    * The locality where this requirement applies
    */
@@ -90,12 +105,17 @@ export interface DocReqsRequirement {
   /**
    * Lists the requirement types necessary to fulfill this requirement
    */
-  requirements_types?: Array<Shared.DocReqsRequirementType>;
+  requirement_types?: Array<Shared.DocReqsRequirementType>;
 
   /**
    * ISO 8601 formatted date-time indicating when the resource was last updated.
    */
   updated_at?: string;
+
+  /**
+   * Version number. Increments with each new version. Defaults to 1.
+   */
+  version?: number;
 }
 
 export interface RequirementRetrieveResponse {
@@ -123,6 +143,12 @@ export interface RequirementListParams extends DefaultFlatPaginationParams {
     | '-country_code'
     | '-phone_number_type'
   >;
+
+  /**
+   * Filter by requirement version number. When omitted, returns the currently-active
+   * version.
+   */
+  version?: number;
 }
 
 export namespace RequirementListParams {
@@ -149,11 +175,20 @@ export namespace RequirementListParams {
   }
 }
 
+export interface RequirementRetrieveParams {
+  /**
+   * Filter by requirement version number. When omitted, returns the currently-active
+   * version.
+   */
+  version?: number;
+}
+
 export declare namespace Requirements {
   export {
     type DocReqsRequirement as DocReqsRequirement,
     type RequirementRetrieveResponse as RequirementRetrieveResponse,
     type DocReqsRequirementsDefaultFlatPagination as DocReqsRequirementsDefaultFlatPagination,
     type RequirementListParams as RequirementListParams,
+    type RequirementRetrieveParams as RequirementRetrieveParams,
   };
 }

package/src/resources/speech-to-text/speech-to-text.ts

@@ -300,7 +300,7 @@ export interface SpeechToTextRetrieveTranscriptionParams {
     | 'xai/grok-stt'
     | 'speechmatics/standard'
     | 'soniox/stt-rt-v4'
-    | 'parakeet/tdt-0.6b-v3';
+    | 'nvidia/parakeet-v3';
 
   /**
    * Enable redaction of sensitive information (e.g., PCI data, SSN) from

package/src/resources/storage/cloudfs/actions.ts

@@ -0,0 +1,59 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import * as CloudfsAPI from './cloudfs';
+import { APIPromise } from '../../../core/api-promise';
+import { buildHeaders } from '../../../internal/headers';
+import { RequestOptions } from '../../../internal/request-options';
+import { path } from '../../../internal/utils/path';
+
+/**
+ * Manage CloudFS filesystems — JuiceFS-compatible filesystems backed by Telnyx Cloud Storage
+ */
+export class Actions extends APIResource {
+  /**
+   * Issues a new metadata access token for the filesystem and returns the full
+   * filesystem, including the new `meta_token` and credential-bearing `meta_url`.
+   * The previous token stops authenticating immediately; the metadata database and
+   * S3 bucket are unchanged. The request takes no body. Allowed while the filesystem
+   * is `ready` or `needs_format`; otherwise returns a `409`. Retrying with the same
+   * `Idempotency-Key` within 24 hours replays the original response — including the
+   * same token — instead of rotating again.
+   *
+   * @example
+   * ```ts
+   * const cloudfsFilesystemResponseWrapper =
+   *   await client.storage.cloudfs.actions.rotateMetaToken(
+   *     '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+   *     { 'Idempotency-Key': 'Idempotency-Key' },
+   *   );
+   * ```
+   */
+  rotateMetaToken(
+    id: string,
+    params: ActionRotateMetaTokenParams,
+    options?: RequestOptions,
+  ): APIPromise<CloudfsAPI.CloudfsFilesystemResponseWrapper> {
+    const { 'Idempotency-Key': idempotencyKey } = params;
+    return this._client.post(path`/storage/cloudfs/${id}/actions/rotate-meta-token`, {
+      ...options,
+      headers: buildHeaders([{ 'Idempotency-Key': idempotencyKey }, options?.headers]),
+    });
+  }
+}
+
+export interface ActionRotateMetaTokenParams {
+  /**
+   * Unique key that makes the request idempotent (1-255 characters: letters,
+   * numbers, `_`, and `-`). Retrying with the same key within 24 hours replays the
+   * original response (marked with an `Idempotent-Replayed: true` header) instead of
+   * repeating the action. Reusing a key with a different request returns a `422`;
+   * sending a key while the original request is still being processed returns a
+   * `409`.
+   */
+  'Idempotency-Key': string;
+}
+
+export declare namespace Actions {
+  export { type ActionRotateMetaTokenParams as ActionRotateMetaTokenParams };
+}