telnyx 7.21.0 → 7.23.0

package/src/resources/compute/funcs/funcs.ts

@@ -0,0 +1,341 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import * as FuncsAPI from './funcs';
+import * as ExportAPI from './export';
+import { Export, ExportCreateParams, FuncLogExportConfigResponse } from './export';
+import { APIPromise } from '../../../core/api-promise';
+import { RequestOptions } from '../../../internal/request-options';
+import { path } from '../../../internal/utils/path';
+
+export class Funcs extends APIResource {
+  export: ExportAPI.Export = new ExportAPI.Export(this._client);
+
+  /**
+   * Returns logs oldest first. `type=runtime` (default) returns function
+   * stdout/stderr. `type=invocations` returns one platform-generated record per HTTP
+   * request served.
+   *
+   * @example
+   * ```ts
+   * const response = await client.compute.funcs.retrieveLogs(
+   *   'id',
+   * );
+   * ```
+   */
+  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.
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await client.compute.funcs.retrieveMetricAggregates(
+   *     'id',
+   *     {
+   *       end_time: '2019-12-27T18:11:19.117Z',
+   *       start_time: '2019-12-27T18:11:19.117Z',
+   *     },
+   *   );
+   * ```
+   */
+  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.
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await client.compute.funcs.retrieveRevisions('id');
+   * ```
+   */
+  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`.
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await client.compute.funcs.retrieveShipInspection('id');
+   * ```
+   */
+  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;
+}
+
+Funcs.Export = Export;
+
+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 {
+    Export as Export,
+    type FuncLogExportConfigResponse as FuncLogExportConfigResponse,
+    type ExportCreateParams as ExportCreateParams,
+  };
+}

package/src/resources/compute/funcs/index.ts

@@ -0,0 +1,15 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { Export, type FuncLogExportConfigResponse, type ExportCreateParams } from './export';
+export {
+  Funcs,
+  type FunctionsObservabilityPaginationMeta,
+  type LogsMeta,
+  type FuncRetrieveLogsResponse,
+  type FuncRetrieveMetricAggregatesResponse,
+  type FuncRetrieveRevisionsResponse,
+  type FuncRetrieveShipInspectionResponse,
+  type FuncRetrieveLogsParams,
+  type FuncRetrieveMetricAggregatesParams,
+  type FuncRetrieveRevisionsParams,
+} from './funcs';

package/src/resources/compute/funcs.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './funcs/index';

package/src/resources/compute/index.ts

@@ -0,0 +1,15 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { Compute } from './compute';
+export {
+  Funcs,
+  type FunctionsObservabilityPaginationMeta,
+  type LogsMeta,
+  type FuncRetrieveLogsResponse,
+  type FuncRetrieveMetricAggregatesResponse,
+  type FuncRetrieveRevisionsResponse,
+  type FuncRetrieveShipInspectionResponse,
+  type FuncRetrieveLogsParams,
+  type FuncRetrieveMetricAggregatesParams,
+  type FuncRetrieveRevisionsParams,
+} from './funcs/index';

package/src/resources/compute.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './compute/index';

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/credential-connections/credential-connections.ts

@@ -257,7 +257,10 @@ export interface CredentialConnection {
 
   /**
    * The password to be used as part of the credentials. Must be 8 to 128 characters
-   * long.
+   * long. For primary accounts created on or after September 8, 2026, this password
+   * is returned as `********`. The password is returned in full on create, and on
+   * update only when that update changed the password. Accounts created before
+   * September 8, 2026 are unaffected.
    */
   password?: string;
 

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-inboxes/drafts.ts

@@ -415,6 +415,14 @@ export interface EmailMessage {
    * send has been processed or cancelled.
    */
   scheduled_at?: string;
+
+  /**
+   * Recipients excluded from delivery by suppression checks, with reasons. On batch
+   * items, present when that item had suppressed recipients; all other recipients of
+   * the item still receive the message. For single sends this information appears at
+   * the top level of the response instead (see EmailMessageResponse.suppressed).
+   */
+  suppressed?: Array<EmailMessagesAPI.SuppressedRecipient>;
 }
 
 export namespace EmailMessage {

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

@@ -109,7 +109,11 @@ export class EmailMessages extends APIResource {
   }
 
   /**
-   * Creates up to 50 email messages in a single request.
+   * Creates up to 1,000 email messages in a single request. Request-wide admission
+   * checks run first and can reject the whole batch before message creation. After
+   * those checks pass, each message is validated and sent independently; item-level
+   * failures do not affect other messages, and the processed batch returns 207
+   * Multi-Status.
    *
    * @example
    * ```ts
@@ -336,6 +340,7 @@ export namespace EmailMessageBatchResponse {
       | 'not_found'
       | 'forbidden'
       | 'service_unavailable'
+      | 'unprocessable_entity'
       | 'validation_error'
       | 'recipient_suppressed'
       | 'reputation_suspended';
@@ -548,7 +553,9 @@ export interface EmailMessageCreateParams {
 
 export interface EmailMessageBatchParams {
   /**
-   * Body param
+   * Body param: Array of email messages to send. Up to 1,000 messages per batch
+   * request. Each message is validated and sent independently; per-message failures
+   * do not affect other messages in the batch.
    */
   messages: Array<EmailMessageBatchParams.Message>;
 

package/src/resources/fqdn-connections/fqdn-authentication.ts

@@ -80,7 +80,10 @@ export interface FqdnAuthentication {
   microsoft_teams_sbc?: boolean;
 
   /**
-   * The password for authentication.
+   * The password for authentication. For primary accounts created on or after
+   * September 8, 2026, this password is returned as `********`. The password is
+   * returned in full on create, and on update only when that update changed the
+   * password. Accounts created before September 8, 2026 are unaffected.
    */
   password?: string;
 

package/src/resources/fqdn-connections/fqdn-connections.ts

@@ -249,7 +249,10 @@ export interface FqdnConnection {
   outbound?: OutboundFqdn;
 
   /**
-   * The password for the FQDN connection.
+   * The password for the FQDN connection. For primary accounts created on or after
+   * September 8, 2026, this password is returned as `********`. The password is
+   * returned in full on create, and on update only when that update changed the
+   * password. Accounts created before September 8, 2026 are unaffected.
    */
   password?: string;