telnyx 7.22.0 → 7.24.0

package/src/resources/compute/funcs.ts

@@ -1,298 +1,3 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { APIResource } from '../../core/resource';
-import * as FuncsAPI from './funcs';
-import { APIPromise } from '../../core/api-promise';
-import { RequestOptions } from '../../internal/request-options';
-import { path } from '../../internal/utils/path';
-
-export class Funcs extends APIResource {
-  /**
-   * Returns logs oldest first. `type=runtime` (default) returns function
-   * stdout/stderr. `type=invocations` returns one platform-generated record per HTTP
-   * request served.
-   */
-  retrieveLogs(
-    id: string,
-    query: FuncRetrieveLogsParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<FuncRetrieveLogsResponse> {
-    return this._client.get(path`/compute/funcs/${id}/logs`, { query, ...options });
-  }
-
-  /**
-   * Returns aggregate request, latency, CPU, memory, and resource-limit metrics for
-   * a function over the requested window.
-   */
-  retrieveMetricAggregates(
-    id: string,
-    query: FuncRetrieveMetricAggregatesParams,
-    options?: RequestOptions,
-  ): APIPromise<FuncRetrieveMetricAggregatesResponse> {
-    return this._client.get(path`/compute/funcs/${id}/metric_aggregates`, { query, ...options });
-  }
-
-  /**
-   * Lists a function's ship history newest first, including per-ship failure stage
-   * and reason when recorded.
-   */
-  retrieveRevisions(
-    id: string,
-    query: FuncRetrieveRevisionsParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<FuncRetrieveRevisionsResponse> {
-    return this._client.get(path`/compute/funcs/${id}/revisions`, { query, ...options });
-  }
-
-  /**
-   * Returns the latest ship outcome. The stage is `none` on success, `pending` while
-   * building, or a failure stage such as `build`, `platform`, `pre_build`, `deploy`,
-   * or `security_review`. This stage-neutral customer-facing path is an alias over
-   * the same inspection resource as `build_log_inspection`.
-   */
-  retrieveShipInspection(
-    id: string,
-    options?: RequestOptions,
-  ): APIPromise<FuncRetrieveShipInspectionResponse> {
-    return this._client.get(path`/compute/funcs/${id}/ship_inspection`, options);
-  }
-}
-
-export interface FunctionsObservabilityPaginationMeta {
-  page_number?: number;
-
-  page_size?: number;
-
-  total_pages?: number;
-
-  total_results?: number;
-}
-
-export interface LogsMeta {
-  has_more?: boolean;
-
-  partial?: boolean;
-}
-
-export type FuncRetrieveLogsResponse =
-  | FuncRetrieveLogsResponse.FuncRuntimeLogsResponse
-  | FuncRetrieveLogsResponse.FuncInvocationLogsResponse;
-
-export namespace FuncRetrieveLogsResponse {
-  export interface FuncRuntimeLogsResponse {
-    data?: Array<FuncRuntimeLogsResponse.Data>;
-
-    meta?: FuncsAPI.LogsMeta;
-  }
-
-  export namespace FuncRuntimeLogsResponse {
-    export interface Data {
-      level?: string;
-
-      message?: string;
-
-      record_type?: 'compute_func_runtime_log';
-
-      timestamp?: string;
-    }
-  }
-
-  export interface FuncInvocationLogsResponse {
-    data?: Array<FuncInvocationLogsResponse.Data>;
-
-    meta?: FuncsAPI.LogsMeta;
-  }
-
-  export namespace FuncInvocationLogsResponse {
-    export interface Data {
-      duration_ms?: number;
-
-      method?: string;
-
-      path?: string;
-
-      record_type?: 'compute_func_invocation_log';
-
-      region?: string;
-
-      request_size_bytes?: number;
-
-      response_size_bytes?: number;
-
-      status_code?: number;
-
-      timestamp?: string;
-    }
-  }
-}
-
-export interface FuncRetrieveMetricAggregatesResponse {
-  data?: Array<FuncRetrieveMetricAggregatesResponse.Data>;
-
-  meta?: FunctionsObservabilityPaginationMeta;
-}
-
-export namespace FuncRetrieveMetricAggregatesResponse {
-  export interface Data {
-    cpu_used_cores_avg?: number | null;
-
-    cpu_used_cores_max?: number | null;
-
-    end_time?: string;
-
-    function_id?: string;
-
-    function_name?: string;
-
-    memory_used_bytes_avg?: number | null;
-
-    memory_used_bytes_max?: number | null;
-
-    product?: string;
-
-    record_type?: string;
-
-    request_client_error_rate?: number | null;
-
-    request_count?: number | null;
-
-    request_error_rate?: number | null;
-
-    request_latency_avg_ms?: number | null;
-
-    request_latency_p50_ms?: number | null;
-
-    request_latency_p95_ms?: number | null;
-
-    request_latency_p99_ms?: number | null;
-
-    request_success_rate?: number | null;
-
-    start_time?: string;
-  }
-}
-
-export interface FuncRetrieveRevisionsResponse {
-  data?: Array<FuncRetrieveRevisionsResponse.Data>;
-
-  meta?: FunctionsObservabilityPaginationMeta;
-}
-
-export namespace FuncRetrieveRevisionsResponse {
-  export interface Data {
-    active?: boolean;
-
-    build_ok_at?: string;
-
-    build_status?: string;
-
-    commit_sha?: string;
-
-    deploy_status?: string;
-
-    failure_reason?: string;
-
-    failure_stage?: string;
-
-    image?: string;
-
-    record_type?: string;
-
-    revision_id?: string;
-
-    shipped_at?: string;
-
-    shipped_by?: string;
-  }
-}
-
-export interface FuncRetrieveShipInspectionResponse {
-  data?: FuncRetrieveShipInspectionResponse.Data;
-}
-
-export namespace FuncRetrieveShipInspectionResponse {
-  export interface Data {
-    created_at?: string;
-
-    reason?: string;
-
-    /**
-     * Stable record type retained by both inspection path aliases.
-     */
-    record_type?: 'build_log_inspection';
-
-    runtime?: string;
-
-    snippet?: string;
-
-    stage?: 'build' | 'platform' | 'pre_build' | 'deploy' | 'security_review' | 'none' | 'pending';
-  }
-}
-
-export interface FuncRetrieveLogsParams {
-  /**
-   * Return records at or before this RFC 3339 timestamp.
-   */
-  end_time?: string;
-
-  /**
-   * Maximum records to return.
-   */
-  limit?: number;
-
-  /**
-   * Return records at or after this RFC 3339 timestamp.
-   */
-  start_time?: string;
-
-  /**
-   * Log stream to return.
-   */
-  type?: 'runtime' | 'invocations';
-}
-
-export interface FuncRetrieveMetricAggregatesParams {
-  /**
-   * Exclusive window end, UTC ISO 8601 with milliseconds
-   */
-  end_time: string;
-
-  /**
-   * Inclusive window start, UTC ISO 8601 with milliseconds
-   */
-  start_time: string;
-
-  /**
-   * Edge site filter
-   */
-  'filter[edge_site]'?: string;
-
-  /**
-   * Kubernetes namespace filter
-   */
-  'filter[namespace]'?: string;
-
-  'page[number]'?: number;
-
-  'page[size]'?: number;
-}
-
-export interface FuncRetrieveRevisionsParams {
-  'page[number]'?: number;
-
-  'page[size]'?: number;
-}
-
-export declare namespace Funcs {
-  export {
-    type FunctionsObservabilityPaginationMeta as FunctionsObservabilityPaginationMeta,
-    type LogsMeta as LogsMeta,
-    type FuncRetrieveLogsResponse as FuncRetrieveLogsResponse,
-    type FuncRetrieveMetricAggregatesResponse as FuncRetrieveMetricAggregatesResponse,
-    type FuncRetrieveRevisionsResponse as FuncRetrieveRevisionsResponse,
-    type FuncRetrieveShipInspectionResponse as FuncRetrieveShipInspectionResponse,
-    type FuncRetrieveLogsParams as FuncRetrieveLogsParams,
-    type FuncRetrieveMetricAggregatesParams as FuncRetrieveMetricAggregatesParams,
-    type FuncRetrieveRevisionsParams as FuncRetrieveRevisionsParams,
-  };
-}
+export * from './funcs/index';

package/src/resources/compute/index.ts

@@ -12,4 +12,4 @@ export {
   type FuncRetrieveLogsParams,
   type FuncRetrieveMetricAggregatesParams,
   type FuncRetrieveRevisionsParams,
-} from './funcs';
+} from './funcs/index';

package/src/resources/conferences/actions.ts

@@ -797,6 +797,12 @@ export interface ActionSpeakParams {
    * - **Fish Audio:** Use `FishAudio.<ModelId>.<VoiceId>` (e.g.,
    *   `FishAudio.s2.1-pro.<reference_id>`). Supported models: `s2.1-pro`, `s2-pro`,
    *   `s1`. `VoiceId` is a Fish Voice-Library reference ID.
+   * - **Soniox:** Use `Soniox.<ModelId>.<VoiceId>` (e.g., `Soniox.tts-rt-v2.Emma`).
+   *   Supported model: `tts-rt-v2`. Browse the catalog via the
+   *   [Voices API](https://developers.telnyx.com/api-reference/text-to-speech-commands/list-available-voices).
+   *   Every voice speaks all supported languages; set `language` to the two-letter
+   *   ISO 639-1 code of the text, for example `it`. SSML is not supported. Use
+   *   `voice_settings` to configure `speed` (0.7 to 1.3) and `reduce_silence`.
    * - **xAI:** Use `xAI.<VoiceId>` (e.g., `xAI.eve`). Available voices: `eve`,
    *   `ara`, `rex`, `sal`, `leo`.
    * - **Humain:** Use `Humain.<VoiceId>` (e.g., `Humain.sara-ar`). Available voices:
@@ -880,7 +886,8 @@ export interface ActionSpeakParams {
     | Shared.AzureVoiceSettings
     | Shared.ResembleVoiceSettings
     | Shared.InworldVoiceSettings
-    | Shared.XaiVoiceSettings;
+    | Shared.XaiVoiceSettings
+    | ActionsAPI.SonioxVoiceSettings;
 }
 
 export interface ActionStopParams {

package/src/resources/connections.ts

@@ -42,6 +42,15 @@ export class Connections extends APIResource {
   retrieve(id: string, options?: RequestOptions): APIPromise<ConnectionRetrieveResponse> {
     return this._client.get(path`/connections/${id}`, options);
   }
+
+  /**
+   * Returns the number of connections associated with the authenticated user,
+   * grouped by connection type, together with the connection limits that apply to
+   * the user. Forward-only connections are excluded from the counts.
+   */
+  retrieveCount(options?: RequestOptions): APIPromise<ConnectionRetrieveCountResponse> {
+    return this._client.get('/connections/count', options);
+  }
 }
 
 export type ConnectionsDefaultFlatPagination = DefaultFlatPagination<Connection>;
@@ -146,6 +155,129 @@ export interface ConnectionListActiveCallsResponse {
   record_type: 'call';
 }
 
+export interface ConnectionRetrieveCountResponse {
+  data: ConnectionRetrieveCountResponse.Data;
+}
+
+export namespace ConnectionRetrieveCountResponse {
+  export interface Data {
+    /**
+     * Counts of the authenticated user's connections, grouped by connection type.
+     * Forward-only connections are excluded.
+     */
+    counts: Data.Counts;
+
+    /**
+     * Connection limits that apply to the user. Contains a single global_limit when a
+     * global connection limit applies, or per-type limits (standard_limit, texml_limit
+     * and uac_limit) when the user has per-type connection count capabilities.
+     */
+    limits: Data.GlobalConnectionLimit | Data.PerTypeConnectionLimits;
+
+    /**
+     * Identifies the type of the resource.
+     */
+    record_type: string;
+  }
+
+  export namespace Data {
+    /**
+     * Counts of the authenticated user's connections, grouped by connection type.
+     * Forward-only connections are excluded.
+     */
+    export interface Counts {
+      /**
+       * Number of Call Control applications.
+       */
+      call_control_applications: number;
+
+      /**
+       * Number of credential connections.
+       */
+      credential_connections: number;
+
+      /**
+       * Number of external connections.
+       */
+      external_connections: number;
+
+      /**
+       * Number of Fax applications.
+       */
+      fax_connections: number;
+
+      /**
+       * Number of FQDN connections.
+       */
+      fqdn_connections: number;
+
+      /**
+       * Number of IP connections.
+       */
+      ip_connections: number;
+
+      /**
+       * Number of Microsoft Teams SBC (direct routing) connections.
+       */
+      microsoft_teams_sbc_connections: number;
+
+      /**
+       * Number of mobile voice (IMS) connections.
+       */
+      mobile_voice_connections: number;
+
+      /**
+       * Number of Microsoft Operator Connect connections.
+       */
+      operator_connect_connections: number;
+
+      /**
+       * Number of TeXML applications.
+       */
+      texml_applications: number;
+
+      /**
+       * Number of third-party provider connections.
+       */
+      third_party_provider_connections: number;
+
+      /**
+       * Number of UAC connections.
+       */
+      uac_connections: number;
+
+      /**
+       * Number of Zoom SBC connections.
+       */
+      zoom_sbc_connections: number;
+    }
+
+    export interface GlobalConnectionLimit {
+      /**
+       * Maximum total number of connections allowed, when a global limit applies.
+       */
+      global_limit: number;
+    }
+
+    export interface PerTypeConnectionLimits {
+      /**
+       * Maximum number of standard connections allowed, when per-type limits apply.
+       */
+      standard_limit: number;
+
+      /**
+       * Maximum number of TeXML applications allowed, when per-type limits apply.
+       */
+      texml_limit: number;
+
+      /**
+       * Maximum number of UAC connections allowed, when per-type limits apply.
+       */
+      uac_limit: number;
+    }
+  }
+}
+
 export interface ConnectionListParams extends DefaultFlatPaginationParams {
   /**
    * Consolidated filter parameter (deepObject style). Originally:
@@ -219,6 +351,7 @@ export declare namespace Connections {
     type Connection as Connection,
     type ConnectionRetrieveResponse as ConnectionRetrieveResponse,
     type ConnectionListActiveCallsResponse as ConnectionListActiveCallsResponse,
+    type ConnectionRetrieveCountResponse as ConnectionRetrieveCountResponse,
     type ConnectionsDefaultFlatPagination as ConnectionsDefaultFlatPagination,
     type ConnectionListActiveCallsResponsesDefaultFlatPagination as ConnectionListActiveCallsResponsesDefaultFlatPagination,
     type ConnectionListParams as ConnectionListParams,

package/src/resources/detail-records.ts

@@ -684,11 +684,22 @@ export interface DetailRecordListParams extends DefaultFlatPaginationParams {
   /**
    * Filter records on a given record attribute and value. <br/>Example:
    * filter[status]=delivered. <br/>Required: filter[record_type] must be specified.
+   * <br/>The valid filter fields depend on the record_type: filtering by a field
+   * that does not exist for the selected record_type is rejected with a 400 error.
+   * Call-control and sip-trunking records use started_at, finished_at and
+   * answered_at (they have no created_at); messaging records use created_at. To list
+   * the fields available for a record_type, use the /v2/detail_records/options
+   * endpoint.
    */
   filter?: DetailRecordListParams.Filter;
 
   /**
-   * Specifies the sort order for results. <br/>Example: sort=-created_at
+   * Specifies the sort order for results. <br/>Example: sort=-created_at <br/>The
+   * valid sort fields depend on the record_type: sort by a field that does not exist
+   * for the selected record_type is rejected with a 400 error. Call-control and
+   * sip-trunking records use started_at, finished_at and answered_at (they have no
+   * created_at); messaging records use created_at. To list the fields available for
+   * a record_type, use the /v2/detail_records/options endpoint.
    */
   sort?: Array<string>;
 }
@@ -697,6 +708,12 @@ export namespace DetailRecordListParams {
   /**
    * Filter records on a given record attribute and value. <br/>Example:
    * filter[status]=delivered. <br/>Required: filter[record_type] must be specified.
+   * <br/>The valid filter fields depend on the record_type: filtering by a field
+   * that does not exist for the selected record_type is rejected with a 400 error.
+   * Call-control and sip-trunking records use started_at, finished_at and
+   * answered_at (they have no created_at); messaging records use created_at. To list
+   * the fields available for a record_type, use the /v2/detail_records/options
+   * endpoint.
    */
   export interface Filter {
     /**

package/src/resources/email-blocks/email-blocks.ts

@@ -78,9 +78,11 @@ export class EmailBlocks extends APIResource {
    * stream `ORDER BY created_at ASC, id ASC` with no pagination.
    *
    * CSV columns:
-   * `id,to,from,reason,source,scope,status,domain_id, created_at,updated_at,expires_at,group_id`.
-   * The CSV carries the `group_id` column so group-scoped suppressions' group link
-   * survives the export (empty for account-scope rows).
+   * `id,to,from,reason,source,scope,status,domain_id, created_at,updated_at,expires_at,group_id,bounce_category,dsn_code, meta`
+   * (15 columns). The first 12 columns are the stable native signature;
+   * `bounce_category`, `dsn_code`, and `meta` are optional backup fields (empty when
+   * unset). The CSV carries the `group_id` column so group-scoped suppressions'
+   * group link survives the export (empty for account-scope rows).
    *
    * @example
    * ```ts
@@ -201,6 +203,12 @@ export interface EmailBlock {
    */
   domain_id?: string | null;
 
+  /**
+   * Optional expiration time. An active row stops matching send-time suppression
+   * checks as soon as `expires_at <= now()`. A maintenance worker later transitions
+   * the row to `status: expired` and appends an `expired` audit event (normally
+   * within 15 minutes).
+   */
   expires_at?: string | null;
 
   /**
@@ -267,7 +275,7 @@ export interface EmailBlockRetrieveEventsResponse {
 
 /**
  * CSV with header row
- * `id,to,from,reason,source,scope,status,domain_id,created_at,updated_at,expires_at,group_id`.
+ * `id,to,from,reason,source,scope,status,domain_id,created_at,updated_at,expires_at,group_id,bounce_category,dsn_code,meta`.
  */
 export type EmailBlockRetrieveExportResponse = string;
 

package/src/resources/email-blocks/imports.ts

@@ -20,9 +20,23 @@ export class Imports extends APIResource {
    * - header-only / all-blank / undetectable provider → `400` Returns `202` with the
    *   import record (status `pending`); an Oban worker (`EmailBlockImportWorker`,
    *   max_attempts 3) transitions `pending → processing → completed | failed`.
-   *   `block_ttl_days` applies only to imported `manual_block` rows; other reasons
-   *   get `expires_at: nil`. Provider is auto-detected from the CSV header
-   *   (`sendgrid` / `mailgun` / `ses` / `generic`).
+   *
+   * Native Telnyx exports are detected by the stable first-12-column header
+   * signature (`id` … `group_id`) and are restored with their original `from`,
+   * `domain_id`, `group_id`, `source`, `status`, `expires_at`, plus
+   * `bounce_category`, `dsn_code`, and `meta` when present (`scope` is re-derived
+   * from `domain_id`/`from`; the exported `scope` cell must be a valid enum value).
+   * Lifecycle changes reconcile through the same create path as the API: a row
+   * already in the requested state restores its mutable backup fields without a new
+   * audit event, and a real transition (e.g. tombstone → active) appends the
+   * matching lifecycle event. `block_ttl_days` is not applied to native rows — their
+   * exported `expires_at` is preserved verbatim.
+   *
+   * Competitor and generic imports (SendGrid / Mailgun / SES / generic) remain
+   * account-scoped (`from`, `domain_id`, `group_id`, `scope` are not read) and
+   * `block_ttl_days` applies only to imported `manual_block` rows; other reasons get
+   * `expires_at: nil`. Provider is auto-detected from the CSV header (`sendgrid` /
+   * `mailgun` / `ses` / `generic`).
    *
    * @example
    * ```ts
@@ -94,7 +108,9 @@ export interface EmailBlockImport {
   created_count?: number;
 
   /**
-   * Only when `status == completed`.
+   * Rows that passed CSV parsing but failed suppression creation. This is the
+   * creation-failure subset of `skipped_count`; parser-rejected rows equal
+   * `skipped_count - error_count`. Only when `status == completed`.
    */
   error_count?: number;