telnyx 7.25.0 → 7.26.0

package/src/resources/global-ip-assignment-health.ts

@@ -109,19 +109,19 @@ export namespace GlobalIPAssignmentHealthRetrieveParams {
     /**
      * Filter by exact Global IP Assignment ID
      */
-    global_ip_assignment_id?: string | Filter.In;
+    global_ip_assignment_id?: string | Filter.GlobalIPAssignmentIDIn;
 
     /**
      * Filter by exact Global IP ID
      */
-    global_ip_id?: string | Filter.In;
+    global_ip_id?: string | Filter.GlobalIPIDIn;
   }
 
   export namespace Filter {
     /**
      * Filtering operations
      */
-    export interface In {
+    export interface GlobalIPAssignmentIDIn {
       /**
        * Filter by Global IP Assignment ID(s) separated by commas
        */
@@ -131,7 +131,7 @@ export namespace GlobalIPAssignmentHealthRetrieveParams {
     /**
      * Filtering operations
      */
-    export interface In {
+    export interface GlobalIPIDIn {
       /**
        * Filter by Global IP ID(s) separated by commas
        */

package/src/resources/global-ip-assignments-usage.ts

@@ -123,19 +123,19 @@ export namespace GlobalIPAssignmentsUsageRetrieveParams {
     /**
      * Filter by exact Global IP Assignment ID
      */
-    global_ip_assignment_id?: string | Filter.In;
+    global_ip_assignment_id?: string | Filter.GlobalIPAssignmentIDIn;
 
     /**
      * Filter by exact Global IP ID
      */
-    global_ip_id?: string | Filter.In;
+    global_ip_id?: string | Filter.GlobalIPIDIn;
   }
 
   export namespace Filter {
     /**
      * Filtering operations
      */
-    export interface In {
+    export interface GlobalIPAssignmentIDIn {
       /**
        * Filter by Global IP Assignment ID(s) separated by commas
        */
@@ -145,7 +145,7 @@ export namespace GlobalIPAssignmentsUsageRetrieveParams {
     /**
      * Filtering operations
      */
-    export interface In {
+    export interface GlobalIPIDIn {
       /**
        * Filter by Global IP ID(s) separated by commas
        */

package/src/resources/index.ts

@@ -419,6 +419,7 @@ export {
 export {
   EmailTemplates,
   type EmailTemplate,
+  type EmailTemplateCommon,
   type EmailTemplateResponse,
   type UpdateEmailTemplateRequest,
   type EmailTemplateRenderResponse,
@@ -1350,6 +1351,11 @@ export {
   type SimCardListWirelessConnectivityLogsParams,
   type SimCardListWirelessConnectivityLogsResponsesDefaultFlatPagination,
 } from './sim-cards/sim-cards';
+export {
+  SipRegistrationStatus,
+  type SipRegistrationStatusListResponse,
+  type SipRegistrationStatusListParams,
+} from './sip-registration-status';
 export {
   SiprecConnectors,
   type SiprecConnectorResponse,
@@ -1680,6 +1686,7 @@ export {
   type CallConversationCreatedWebhookEvent,
   type CallConversationEndedWebhookEvent,
   type CallConversationInsightsGeneratedWebhookEvent,
+  type CallConversationStartFailedWebhookEvent,
   type CallCostWebhookEvent,
   type CallDeepfakeDetectionErrorWebhookEvent,
   type CallDeepfakeDetectionResultWebhookEvent,
@@ -1734,11 +1741,15 @@ export {
   type HostedNumberOrderEventWebhookEvent,
   type InboundMessageWebhookEvent,
   type NumberOrderStatusUpdateWebhookEvent,
+  type NumberReputationExternalVerificationStatusChangedWebhookEvent,
+  type NumberReputationNumberFlaggedWebhookEvent,
+  type NumberReputationNumberRemovedWebhookEvent,
   type RecordingAvailableWebhookEvent,
   type ReplacedLinkClickWebhookEvent,
   type SessionStatusChangedWebhookEvent,
   type TranscriptCompletedWebhookEvent,
   type TranscriptionWebhookEvent,
+  type WhatsappWabaAddedWebhookEvent,
   type UnsafeUnwrapWebhookEvent,
   type UnwrapWebhookEvent,
   type InboundMessagesEmailBracketCursorPagination,

package/src/resources/llm-token-gateway/index.ts

@@ -1,4 +1,41 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 export { LlmTokenGateway } from './llm-token-gateway';
-export { Usage, type UsageRetrieveSummaryResponse, type UsageRetrieveSummaryParams } from './usage';
+export {
+  Spend,
+  type SpendGroupBy,
+  type SpendRetrieveEventsResponse,
+  type SpendRetrieveSummaryResponse,
+  type SpendRetrieveEventsParams,
+  type SpendRetrieveSummaryParams,
+} from './spend';
+export {
+  TokenGroups,
+  type AIGatewayResourcesPageMeta,
+  type BudgetDuration,
+  type TokenGroup,
+  type TokenGroupResponse,
+  type TokenGroupListParams,
+  type TokenGroupCreateParams,
+  type TokenGroupDeleteParams,
+  type TokenGroupUpdateParams,
+  type TokenGroupsDefaultFlatPagination,
+} from './token-groups';
+export {
+  TokenKeys,
+  type TokenKey,
+  type TokenKeyResponse,
+  type TokenKeyListParams,
+  type TokenKeyCreateParams,
+  type TokenKeyDeleteParams,
+  type TokenKeyUpdateParams,
+  type TokenKeysDefaultFlatPagination,
+} from './token-keys';
+export {
+  Usage,
+  type GuardrailFinding,
+  type UsageRetrieveExportResponse,
+  type UsageRetrieveSummaryResponse,
+  type UsageRetrieveSummaryParams,
+  type UsageRetrieveExportParams,
+} from './usage';

package/src/resources/llm-token-gateway/llm-token-gateway.ts

@@ -1,19 +1,101 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../core/resource';
+import * as SpendAPI from './spend';
+import {
+  Spend,
+  SpendGroupBy,
+  SpendRetrieveEventsParams,
+  SpendRetrieveEventsResponse,
+  SpendRetrieveSummaryParams,
+  SpendRetrieveSummaryResponse,
+} from './spend';
+import * as TokenGroupsAPI from './token-groups';
+import {
+  AIGatewayResourcesPageMeta,
+  BudgetDuration,
+  TokenGroup,
+  TokenGroupCreateParams,
+  TokenGroupDeleteParams,
+  TokenGroupListParams,
+  TokenGroupResponse,
+  TokenGroupUpdateParams,
+  TokenGroups,
+  TokenGroupsDefaultFlatPagination,
+} from './token-groups';
+import * as TokenKeysAPI from './token-keys';
+import {
+  TokenKey,
+  TokenKeyCreateParams,
+  TokenKeyDeleteParams,
+  TokenKeyListParams,
+  TokenKeyResponse,
+  TokenKeyUpdateParams,
+  TokenKeys,
+  TokenKeysDefaultFlatPagination,
+} from './token-keys';
 import * as UsageAPI from './usage';
-import { Usage, UsageRetrieveSummaryParams, UsageRetrieveSummaryResponse } from './usage';
+import {
+  GuardrailFinding,
+  Usage,
+  UsageRetrieveExportParams,
+  UsageRetrieveExportResponse,
+  UsageRetrieveSummaryParams,
+  UsageRetrieveSummaryResponse,
+} from './usage';
 
 export class LlmTokenGateway extends APIResource {
   usage: UsageAPI.Usage = new UsageAPI.Usage(this._client);
+  spend: SpendAPI.Spend = new SpendAPI.Spend(this._client);
+  tokenGroups: TokenGroupsAPI.TokenGroups = new TokenGroupsAPI.TokenGroups(this._client);
+  tokenKeys: TokenKeysAPI.TokenKeys = new TokenKeysAPI.TokenKeys(this._client);
 }
 
 LlmTokenGateway.Usage = Usage;
+LlmTokenGateway.Spend = Spend;
+LlmTokenGateway.TokenGroups = TokenGroups;
+LlmTokenGateway.TokenKeys = TokenKeys;
 
 export declare namespace LlmTokenGateway {
   export {
     Usage as Usage,
+    type GuardrailFinding as GuardrailFinding,
+    type UsageRetrieveExportResponse as UsageRetrieveExportResponse,
     type UsageRetrieveSummaryResponse as UsageRetrieveSummaryResponse,
     type UsageRetrieveSummaryParams as UsageRetrieveSummaryParams,
+    type UsageRetrieveExportParams as UsageRetrieveExportParams,
+  };
+
+  export {
+    Spend as Spend,
+    type SpendGroupBy as SpendGroupBy,
+    type SpendRetrieveEventsResponse as SpendRetrieveEventsResponse,
+    type SpendRetrieveSummaryResponse as SpendRetrieveSummaryResponse,
+    type SpendRetrieveEventsParams as SpendRetrieveEventsParams,
+    type SpendRetrieveSummaryParams as SpendRetrieveSummaryParams,
+  };
+
+  export {
+    TokenGroups as TokenGroups,
+    type AIGatewayResourcesPageMeta as AIGatewayResourcesPageMeta,
+    type BudgetDuration as BudgetDuration,
+    type TokenGroup as TokenGroup,
+    type TokenGroupResponse as TokenGroupResponse,
+    type TokenGroupsDefaultFlatPagination as TokenGroupsDefaultFlatPagination,
+    type TokenGroupListParams as TokenGroupListParams,
+    type TokenGroupCreateParams as TokenGroupCreateParams,
+    type TokenGroupDeleteParams as TokenGroupDeleteParams,
+    type TokenGroupUpdateParams as TokenGroupUpdateParams,
+  };
+
+  export {
+    TokenKeys as TokenKeys,
+    type TokenKey as TokenKey,
+    type TokenKeyResponse as TokenKeyResponse,
+    type TokenKeysDefaultFlatPagination as TokenKeysDefaultFlatPagination,
+    type TokenKeyListParams as TokenKeyListParams,
+    type TokenKeyCreateParams as TokenKeyCreateParams,
+    type TokenKeyDeleteParams as TokenKeyDeleteParams,
+    type TokenKeyUpdateParams as TokenKeyUpdateParams,
   };
 }

package/src/resources/llm-token-gateway/spend.ts

@@ -0,0 +1,309 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as SpendAPI from './spend';
+import { APIPromise } from '../../core/api-promise';
+import { RequestOptions } from '../../internal/request-options';
+
+/**
+ * Manage and report AI Gateway usage.
+ */
+export class Spend extends APIResource {
+  /**
+   * Return request-level usage history for the authenticated account. Supply both
+   * UTC dates or neither; omitting both returns the previous full UTC day. Dates use
+   * a half-open range [start_date, end_date) of at most 31 days. Cost reflects
+   * budget reference rates, not invoice charges. Unknown spend is excluded and
+   * reported separately. The report snapshot supports at most 10,000 matching
+   * requests, independently of page size. Exceeding this bound returns HTTP 503
+   * without partial results. Narrow the date range or resource filters before
+   * retrying. A failed report must not be interpreted as zero usage. Request tags
+   * can filter either report and metadata:<key> can group the summary.
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await client.llmTokenGateway.spend.retrieveEvents();
+   * ```
+   */
+  retrieveEvents(
+    query: SpendRetrieveEventsParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<SpendRetrieveEventsResponse> {
+    return this._client.get('/llm_token_gateway/spend/events', { query, ...options });
+  }
+
+  /**
+   * Return request counts, token counts and reference spend grouped by one
+   * attribution dimension. Both UTC dates and group_by are required. Dates use a
+   * half-open range [start_date, end_date) of at most 31 days. Cost reflects budget
+   * reference rates, not invoice charges. Unknown spend is excluded and reported
+   * separately. The report snapshot supports at most 10,000 matching requests,
+   * independently of page size. Exceeding this bound returns HTTP 503 without
+   * partial results. Narrow the date range or resource filters before retrying. A
+   * failed report must not be interpreted as zero usage. Request tags can filter
+   * either report and metadata:<key> can group the summary.
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await client.llmTokenGateway.spend.retrieveSummary({
+   *     end_date: '2019-12-27',
+   *     group_by: 'token_group',
+   *     start_date: '2019-12-27',
+   *   });
+   * ```
+   */
+  retrieveSummary(
+    query: SpendRetrieveSummaryParams,
+    options?: RequestOptions,
+  ): APIPromise<SpendRetrieveSummaryResponse> {
+    return this._client.get('/llm_token_gateway/spend/summary', { query, ...options });
+  }
+}
+
+/**
+ * Group by one request tag key. Keys starting with ltg*, telnyx*, litellm* or cf*
+ * (any case) are rejected.
+ */
+export type SpendGroupBy = 'token_group' | 'token_user' | 'token_key' | 'end_user' | (string & {});
+
+export interface SpendRetrieveEventsResponse {
+  data: Array<SpendRetrieveEventsResponse.Data>;
+
+  meta: SpendRetrieveEventsResponse.Meta;
+}
+
+export namespace SpendRetrieveEventsResponse {
+  export interface Data {
+    id: string;
+
+    /**
+     * Provider attempts begun for the request (fallbacks included); 0 for a cache hit.
+     * Token and cost totals sum every attempt.
+     */
+    attempts: number;
+
+    biller: 'telnyx' | 'provider' | 'none';
+
+    cache_hit: boolean;
+
+    configuration_version: number;
+
+    /**
+     * USD, decimal precision at most 6 places; parse exactly to integer micro-USD,
+     * never binary float accounting.
+     */
+    cost: number | null;
+
+    created_at: string;
+
+    end_user_id: string | null;
+
+    input_tokens: number | null;
+
+    /**
+     * Customer request tags from the x-ltg-metadata header: up to 5 entries. Keys are
+     * case-sensitive; keys starting with ltg*, telnyx*, litellm* or cf* (any case) are
+     * reserved. Values are strings (1-256 characters, no control or format
+     * characters), integers within +/-9007199254740991, or booleans; floats, null,
+     * objects and arrays are rejected. Values that look like credentials are rejected.
+     * Tags are attribution only: never forwarded upstream, never part of the response
+     * cache key, never used for budgets or routing. An untagged request reports {}.
+     */
+    metadata: { [key: string]: string | number | boolean };
+
+    /**
+     * Public alias that served (the last attempt); rate_version, biller and
+     * provider_key_id follow it.
+     */
+    model: string;
+
+    output_tokens: number | null;
+
+    provider_key_id: string | null;
+
+    rate_version: string;
+
+    request_id: string;
+
+    /**
+     * Public alias the caller requested; differs from model only when a group fallback
+     * served.
+     */
+    requested_model: string;
+
+    reservation_micro_usd: number;
+
+    status: 'succeeded' | 'failed' | 'partial' | 'unknown';
+
+    token_group_id: string;
+
+    token_key_id: string;
+
+    token_user_id: string | null;
+
+    usage_status: 'known' | 'unknown' | 'reconciled';
+  }
+
+  export interface Meta {
+    has_more: boolean;
+
+    page_number: number;
+
+    page_size: number;
+
+    snapshot: string;
+  }
+}
+
+export interface SpendRetrieveSummaryResponse {
+  data: Array<SpendRetrieveSummaryResponse.Data>;
+
+  meta: SpendRetrieveSummaryResponse.Meta;
+}
+
+export namespace SpendRetrieveSummaryResponse {
+  export interface Data {
+    dimension_id: string | null;
+
+    input_tokens: number;
+
+    name: string | null;
+
+    output_tokens: number;
+
+    requests: number;
+
+    /**
+     * USD, decimal precision at most 6 places; parse exactly to integer micro-USD,
+     * never binary float accounting.
+     */
+    reserved_spend: number;
+
+    /**
+     * USD, decimal precision at most 6 places; parse exactly to integer micro-USD,
+     * never binary float accounting.
+     */
+    spend: number;
+
+    unknown_requests: number;
+
+    end_user_id?: string | null;
+
+    /**
+     * Present only for group_by=metadata:<key>: the tag key. dimension_id is then the
+     * tag value in text form (booleans as true/false, integers in decimal), or null
+     * for requests without the key; name is null.
+     */
+    metadata_key?: string;
+
+    token_group_id?: string | null;
+
+    token_key_id?: string | null;
+
+    token_user_id?: string | null;
+  }
+
+  export interface Meta {
+    end_date: string;
+
+    /**
+     * Group by one request tag key. Keys starting with ltg*, telnyx*, litellm* or cf*
+     * (any case) are rejected.
+     */
+    group_by: SpendAPI.SpendGroupBy;
+
+    has_more: boolean;
+
+    page_number: number;
+
+    page_size: number;
+
+    snapshot: string;
+
+    start_date: string;
+  }
+}
+
+export interface SpendRetrieveEventsParams {
+  end_date?: string;
+
+  end_user_id?: string;
+
+  /**
+   * Request tag filters as metadata[<key>]=<value>, at most 5, combined with AND. A
+   * value matches the tag's text form exactly (booleans as true/false, integers in
+   * decimal), so metadata[flag]=true matches both boolean true and the string
+   * "true". Keys are case-sensitive; reserved-prefix keys are rejected. Unindexed:
+   * bounded by the account, the date range and the report timeout.
+   */
+  metadata?: { [key: string]: string };
+
+  'page[number]'?: number;
+
+  'page[size]'?: number;
+
+  /**
+   * Required after page 1; account/filter-bound 15-minute stable snapshot;
+   * expired/mismatch 409.
+   */
+  'page[snapshot]'?: string;
+
+  start_date?: string;
+
+  token_group_id?: string;
+
+  token_key_id?: string;
+
+  token_user_id?: string;
+}
+
+export interface SpendRetrieveSummaryParams {
+  end_date: string;
+
+  /**
+   * A scope, or metadata:<key> to group by one request tag's text-form value;
+   * requests without the key form one group with a null dimension_id.
+   */
+  group_by: SpendGroupBy;
+
+  start_date: string;
+
+  end_user_id?: string;
+
+  /**
+   * Request tag filters as metadata[<key>]=<value>, at most 5, combined with AND. A
+   * value matches the tag's text form exactly (booleans as true/false, integers in
+   * decimal), so metadata[flag]=true matches both boolean true and the string
+   * "true". Keys are case-sensitive; reserved-prefix keys are rejected. Unindexed:
+   * bounded by the account, the date range and the report timeout.
+   */
+  metadata?: { [key: string]: string };
+
+  'page[number]'?: number;
+
+  'page[size]'?: number;
+
+  /**
+   * Required after page 1; account/filter-bound 15-minute stable snapshot;
+   * expired/mismatch 409.
+   */
+  'page[snapshot]'?: string;
+
+  token_group_id?: string;
+
+  token_key_id?: string;
+
+  token_user_id?: string;
+}
+
+export declare namespace Spend {
+  export {
+    type SpendGroupBy as SpendGroupBy,
+    type SpendRetrieveEventsResponse as SpendRetrieveEventsResponse,
+    type SpendRetrieveSummaryResponse as SpendRetrieveSummaryResponse,
+    type SpendRetrieveEventsParams as SpendRetrieveEventsParams,
+    type SpendRetrieveSummaryParams as SpendRetrieveSummaryParams,
+  };
+}