telnyx 7.24.0 → 7.25.0

package/src/resources/ai/assistants/deleted.ts

@@ -0,0 +1,86 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import * as AssistantsAPI from './assistants';
+import { APIPromise } from '../../../core/api-promise';
+import {
+  DefaultFlatPagination,
+  type DefaultFlatPaginationParams,
+  PagePromise,
+} from '../../../core/pagination';
+import { RequestOptions } from '../../../internal/request-options';
+import { path } from '../../../internal/utils/path';
+
+/**
+ * Configure AI assistant specifications
+ */
+export class Deleted extends APIResource {
+  /**
+   * List the organization's soft-deleted assistants in the Recently Deleted list.
+   *
+   * Each entry includes `deleted_at` and `permanently_deleted_at`, the point after
+   * which the assistant is erased automatically and can no longer be restored.
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const deletedAssistant of client.ai.assistants.deleted.list()) {
+   *   // ...
+   * }
+   * ```
+   */
+  list(
+    query: DeletedListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<DeletedAssistantsDefaultFlatPagination, DeletedAssistant> {
+    return this._client.getAPIList('/ai/assistants/deleted', DefaultFlatPagination<DeletedAssistant>, {
+      query,
+      ...options,
+    });
+  }
+
+  /**
+   * Retrieve a soft-deleted assistant from the Recently Deleted list by
+   * `assistant_id`, including its `deleted_at` and `permanently_deleted_at`
+   * timestamps. This is a read-only view; the assistant cannot be modified while it
+   * remains deleted.
+   *
+   * @example
+   * ```ts
+   * const deletedAssistant =
+   *   await client.ai.assistants.deleted.get('assistant_id');
+   * ```
+   */
+  get(assistantID: string, options?: RequestOptions): APIPromise<DeletedAssistant> {
+    return this._client.get(path`/ai/assistants/${assistantID}/deleted`, options);
+  }
+}
+
+export type DeletedAssistantsDefaultFlatPagination = DefaultFlatPagination<DeletedAssistant>;
+
+/**
+ * A soft-deleted assistant in the Recently Deleted list: the full assistant
+ * configuration plus deletion metadata.
+ */
+export interface DeletedAssistant extends AssistantsAPI.InferenceEmbedding {
+  /**
+   * Timestamp of the soft delete.
+   */
+  deleted_at: string;
+
+  /**
+   * Point after which the assistant is permanently deleted automatically and can no
+   * longer be restored.
+   */
+  permanently_deleted_at: string;
+}
+
+export interface DeletedListParams extends DefaultFlatPaginationParams {}
+
+export declare namespace Deleted {
+  export {
+    type DeletedAssistant as DeletedAssistant,
+    type DeletedAssistantsDefaultFlatPagination as DeletedAssistantsDefaultFlatPagination,
+    type DeletedListParams as DeletedListParams,
+  };
+}

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

@@ -15,6 +15,7 @@ export {
   type ComparisonExpression,
   type ConversationFlow,
   type ConversationFlowReq,
+  type DelegationSettings,
   type EnabledFeatures,
   type Expression,
   type ExternalLlm,
@@ -54,18 +55,22 @@ export {
   type TransferTool,
   type VoiceSettings,
   type WebhookTool,
+  type WebsocketSettings,
   type WidgetSettings,
   type AssistantDeleteResponse,
   type AssistantChatResponse,
   type AssistantGetTexmlResponse,
   type AssistantSendSMSResponse,
+  type AssistantWhatsappResponse,
   type AssistantCreateParams,
   type AssistantImportsParams,
+  type AssistantDeleteParams,
   type AssistantRetrieveParams,
   type AssistantUpdateParams,
   type AssistantChatParams,
   type AssistantCloneParams,
   type AssistantSendSMSParams,
+  type AssistantWhatsappParams,
 } from './assistants';
 export {
   CanaryDeploys,
@@ -79,6 +84,12 @@ export {
   type CanaryDeployCreateParams,
   type CanaryDeployUpdateParams,
 } from './canary-deploys';
+export {
+  Deleted,
+  type DeletedAssistant,
+  type DeletedListParams,
+  type DeletedAssistantsDefaultFlatPagination,
+} from './deleted';
 export { Instructions, type InstructionEnhanceResponse, type InstructionEnhanceParams } from './instructions';
 export {
   ScheduledEvents,

package/src/resources/ai/assistants/versions.ts

@@ -139,6 +139,17 @@ export interface UpdateAssistant {
    */
   conversation_flow?: AssistantsAPI.ConversationFlowReq;
 
+  /**
+   * Splits the conversation between a frontend model that talks to the caller and a
+   * backend model that does the work. On the GPT-Live route the frontend model
+   * cannot call tools at all — when it needs something done it raises a delegation
+   * and waits. On the chat completion route the frontend keeps a single `delegate`
+   * tool that returns immediately, so the conversation carries on while the backend
+   * works. Either way the backend's answer is spoken as commentary or kept as silent
+   * context, depending on `speak_results`. Beta feature.
+   */
+  delegation_settings?: AssistantsAPI.DelegationSettings;
+
   description?: string;
 
   /**
@@ -292,6 +303,15 @@ export interface UpdateAssistant {
 
   voice_settings?: AssistantsAPI.InferenceEmbeddingVoiceSettings;
 
+  /**
+   * Streams conversation and telephony events to a WebSocket server you host, and
+   * accepts messages injected back into the conversation. Telnyx opens the
+   * connection as a client, once per conversation. Delivery is best effort
+   * throughout: while the connection is down events are dropped rather than queued,
+   * and no socket failure is ever allowed to affect the call. Beta feature.
+   */
+  websocket_settings?: AssistantsAPI.WebsocketSettings;
+
   /**
    * Configuration settings for the assistant's web widget.
    */
@@ -346,6 +366,17 @@ export interface VersionUpdateParams {
    */
   conversation_flow?: AssistantsAPI.ConversationFlowReq;
 
+  /**
+   * Body param: Splits the conversation between a frontend model that talks to the
+   * caller and a backend model that does the work. On the GPT-Live route the
+   * frontend model cannot call tools at all — when it needs something done it raises
+   * a delegation and waits. On the chat completion route the frontend keeps a single
+   * `delegate` tool that returns immediately, so the conversation carries on while
+   * the backend works. Either way the backend's answer is spoken as commentary or
+   * kept as silent context, depending on `speak_results`. Beta feature.
+   */
+  delegation_settings?: AssistantsAPI.DelegationSettings;
+
   /**
    * Body param
    */
@@ -536,6 +567,15 @@ export interface VersionUpdateParams {
    */
   voice_settings?: AssistantsAPI.InferenceEmbeddingVoiceSettings;
 
+  /**
+   * Body param: Streams conversation and telephony events to a WebSocket server you
+   * host, and accepts messages injected back into the conversation. Telnyx opens the
+   * connection as a client, once per conversation. Delivery is best effort
+   * throughout: while the connection is down events are dropped rather than queued,
+   * and no socket failure is ever allowed to affect the call. Beta feature.
+   */
+  websocket_settings?: AssistantsAPI.WebsocketSettings;
+
   /**
    * Body param: Configuration settings for the assistant's web widget.
    */

package/src/resources/ai/chat.ts

@@ -72,9 +72,14 @@ export interface ChatCompletionRequest {
   logprobs?: boolean;
 
   /**
-   * Maximum number of completion tokens the model should generate.
+   * Maximum number of completion (output) tokens the model may generate per request.
+   * Defaults to 8192 when omitted or `null`. Set a higher value to allow longer
+   * completions. The model's `max_completion_tokens` metadata (see
+   * `GET /ai/models`), when set, caps both the default and any larger explicit
+   * value. Reasoning models consume this budget across reasoning and answer tokens
+   * combined.
    */
-  max_tokens?: number;
+  max_tokens?: number | null;
 
   /**
    * This is an alternative to `top_p` that

package/src/resources/ai/embeddings/embeddings.ts

@@ -70,7 +70,7 @@ export class Embeddings extends APIResource {
    *     bucket_name: 'Bucket Name',
    *     document_chunk_overlap_size: 512,
    *     document_chunk_size: 1024,
-   *     embedding_model: 'thenlper/gte-large',
+   *     embedding_model: 'intfloat/multilingual-e5-large',
    *     loader: 'default',
    *   },
    * );

package/src/resources/ai/index.ts

@@ -26,6 +26,7 @@ export {
   type ComparisonExpression,
   type ConversationFlow,
   type ConversationFlowReq,
+  type DelegationSettings,
   type EnabledFeatures,
   type Expression,
   type ExternalLlm,
@@ -65,18 +66,22 @@ export {
   type TransferTool,
   type VoiceSettings,
   type WebhookTool,
+  type WebsocketSettings,
   type WidgetSettings,
   type AssistantDeleteResponse,
   type AssistantChatResponse,
   type AssistantGetTexmlResponse,
   type AssistantSendSMSResponse,
+  type AssistantWhatsappResponse,
   type AssistantCreateParams,
   type AssistantImportsParams,
+  type AssistantDeleteParams,
   type AssistantRetrieveParams,
   type AssistantUpdateParams,
   type AssistantChatParams,
   type AssistantCloneParams,
   type AssistantSendSMSParams,
+  type AssistantWhatsappParams,
 } from './assistants/index';
 export {
   Audio,
@@ -161,7 +166,6 @@ export {
   type PayToolParams,
   type SharedToolResponse,
   type UpdateDynamicVariablesToolParams,
-  type ToolDeleteResponse,
   type ToolListParams,
   type ToolCreateParams,
   type ToolUpdateParams,

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

@@ -1,4 +1,12 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 export { Memory } from './memory';
-export { Namespaces, type NamespaceRetrieveResponse, type NamespaceRetrieveParams } from './namespaces/index';
+export {
+  Namespaces,
+  type Namespace,
+  type NamespaceCreateResponse,
+  type NamespaceRetrieveResponse,
+  type NamespaceListResponse,
+  type NamespaceRetrieveParams,
+  type NamespaceCreateParams,
+} from './namespaces/index';

package/src/resources/ai/memory/memory.ts

@@ -2,7 +2,15 @@
 
 import { APIResource } from '../../../core/resource';
 import * as NamespacesAPI from './namespaces/namespaces';
-import { NamespaceRetrieveParams, NamespaceRetrieveResponse, Namespaces } from './namespaces/namespaces';
+import {
+  Namespace,
+  NamespaceCreateParams,
+  NamespaceCreateResponse,
+  NamespaceListResponse,
+  NamespaceRetrieveParams,
+  NamespaceRetrieveResponse,
+  Namespaces,
+} from './namespaces/namespaces';
 
 export class Memory extends APIResource {
   namespaces: NamespacesAPI.Namespaces = new NamespacesAPI.Namespaces(this._client);
@@ -13,7 +21,11 @@ Memory.Namespaces = Namespaces;
 export declare namespace Memory {
   export {
     Namespaces as Namespaces,
+    type Namespace as Namespace,
+    type NamespaceCreateResponse as NamespaceCreateResponse,
     type NamespaceRetrieveResponse as NamespaceRetrieveResponse,
+    type NamespaceListResponse as NamespaceListResponse,
     type NamespaceRetrieveParams as NamespaceRetrieveParams,
+    type NamespaceCreateParams as NamespaceCreateParams,
   };
 }

package/src/resources/ai/memory/namespaces/index.ts

@@ -1,6 +1,14 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export { Namespaces, type NamespaceRetrieveResponse, type NamespaceRetrieveParams } from './namespaces';
+export {
+  Namespaces,
+  type Namespace,
+  type NamespaceCreateResponse,
+  type NamespaceRetrieveResponse,
+  type NamespaceListResponse,
+  type NamespaceRetrieveParams,
+  type NamespaceCreateParams,
+} from './namespaces';
 export {
   Profiles,
   type PageMeta,

package/src/resources/ai/memory/namespaces/namespaces.ts

@@ -22,12 +22,10 @@ import {
   Profiles,
 } from './profiles/profiles';
 import { APIPromise } from '../../../../core/api-promise';
+import { buildHeaders } from '../../../../internal/headers';
 import { RequestOptions } from '../../../../internal/request-options';
 import { path } from '../../../../internal/utils/path';
 
-/**
- * Whether a write has finished.
- */
 export class Namespaces extends APIResource {
   profiles: ProfilesAPI.Profiles = new ProfilesAPI.Profiles(this._client);
   settings: SettingsAPI.Settings = new SettingsAPI.Settings(this._client);
@@ -54,6 +52,71 @@ export class Namespaces extends APIResource {
     const { namespace } = params;
     return this._client.get(path`/ai/memory/namespaces/${namespace}/operations/${operationID}`, options);
   }
+
+  /**
+   * Every namespace in your organization, `default` among them.
+   *
+   * @example
+   * ```ts
+   * const namespaces = await client.ai.memory.namespaces.list();
+   * ```
+   */
+  list(options?: RequestOptions): APIPromise<NamespaceListResponse> {
+    return this._client.get('/ai/memory/namespaces', options);
+  }
+
+  /**
+   * Create a namespace. An organization can have at most five, `default` among them
+   * — a sixth returns `403`.
+   *
+   * @example
+   * ```ts
+   * const namespace = await client.ai.memory.namespaces.create({
+   *   name: 'staging',
+   * });
+   * ```
+   */
+  create(body: NamespaceCreateParams, options?: RequestOptions): APIPromise<NamespaceCreateResponse> {
+    return this._client.post('/ai/memory/namespaces', { body, ...options });
+  }
+
+  /**
+   * Delete a namespace and every profile and memory in it. `default` cannot be
+   * deleted. This cannot be undone.
+   *
+   * @example
+   * ```ts
+   * await client.ai.memory.namespaces.delete('namespace');
+   * ```
+   */
+  delete(namespace: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.delete(path`/ai/memory/namespaces/${namespace}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+}
+
+/**
+ * An isolated memory store within your organization.
+ */
+export interface Namespace {
+  /**
+   * The namespace's unique identifier.
+   */
+  id: string;
+
+  /**
+   * The namespace's name, used in the path. `default` exists for every organization.
+   */
+  name: string;
+}
+
+export interface NamespaceCreateResponse {
+  /**
+   * An isolated memory store within your organization.
+   */
+  data: Namespace;
 }
 
 export interface NamespaceRetrieveResponse {
@@ -77,17 +140,32 @@ export namespace NamespaceRetrieveResponse {
   }
 }
 
+export interface NamespaceListResponse {
+  data: Array<Namespace>;
+}
+
 export interface NamespaceRetrieveParams {
   namespace: string;
 }
 
+export interface NamespaceCreateParams {
+  /**
+   * A name for the new namespace, unique within your organization.
+   */
+  name: string;
+}
+
 Namespaces.Profiles = Profiles;
 Namespaces.Settings = Settings;
 
 export declare namespace Namespaces {
   export {
+    type Namespace as Namespace,
+    type NamespaceCreateResponse as NamespaceCreateResponse,
     type NamespaceRetrieveResponse as NamespaceRetrieveResponse,
+    type NamespaceListResponse as NamespaceListResponse,
     type NamespaceRetrieveParams as NamespaceRetrieveParams,
+    type NamespaceCreateParams as NamespaceCreateParams,
   };
 
   export {

package/src/resources/ai/openai/chat.ts

@@ -97,9 +97,14 @@ export interface ChatCreateCompletionParams {
   logprobs?: boolean;
 
   /**
-   * Maximum number of completion tokens the model should generate.
+   * Maximum number of completion (output) tokens the model may generate per request.
+   * Defaults to 8192 when omitted or `null`. Set a higher value to allow longer
+   * completions. The model's `max_completion_tokens` metadata (see
+   * `GET /ai/models`), when set, caps both the default and any larger explicit
+   * value. Reasoning models consume this budget across reasoning and answer tokens
+   * combined.
    */
-  max_tokens?: number;
+  max_tokens?: number | null;
 
   /**
    * This is an alternative to `top_p` that

package/src/resources/ai/tools.ts

@@ -60,11 +60,14 @@ export class Tools extends APIResource {
    *
    * @example
    * ```ts
-   * const tool = await client.ai.tools.delete('tool_id');
+   * await client.ai.tools.delete('tool_id');
    * ```
    */
-  delete(toolID: string, options?: RequestOptions): APIPromise<unknown> {
-    return this._client.delete(path`/ai/tools/${toolID}`, options);
+  delete(toolID: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.delete(path`/ai/tools/${toolID}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
   }
 
   /**
@@ -181,8 +184,6 @@ export namespace UpdateDynamicVariablesToolParams {
   }
 }
 
-export type ToolDeleteResponse = unknown;
-
 export interface ToolListParams extends DefaultFlatPaginationParams {
   /**
    * Filter results by filter name.
@@ -300,7 +301,6 @@ export declare namespace Tools {
     type PayToolParams as PayToolParams,
     type SharedToolResponse as SharedToolResponse,
     type UpdateDynamicVariablesToolParams as UpdateDynamicVariablesToolParams,
-    type ToolDeleteResponse as ToolDeleteResponse,
     type SharedToolResponsesDefaultFlatPagination as SharedToolResponsesDefaultFlatPagination,
     type ToolListParams as ToolListParams,
     type ToolCreateParams as ToolCreateParams,

package/src/resources/calls/actions.ts

@@ -18,6 +18,8 @@ export class Actions extends APIResource {
    *
    * **Expected Webhooks:**
    *
+   * - [`call.conversation.created`](/api-reference/callbacks/call-conversation-created)
+   *   includes `conversation_id` during startup
    * - `call.conversation.ended`
    * - `call.conversation_insights.generated`
    *
@@ -60,9 +62,33 @@ export class Actions extends APIResource {
    * Answer an incoming call. You must issue this command before executing subsequent
    * commands on an incoming call.
    *
+   * To answer with an AI assistant, include `assistant.id` and any per-call
+   * overrides in the `assistant` object. Telnyx attempts to warm up the assistant
+   * before answering the call, then starts the assistant automatically when the call
+   * is answered. Do not also send `ai_assistant_start` for this flow. The HTTP
+   * success response can arrive before the call is answered; use the `call.answered`
+   * webhook to track the answer. If warm-up fails, Telnyx falls back to starting the
+   * assistant after answering.
+   *
+   * When `assistant.id` is supplied, obtain the conversation ID from
+   * `data.payload.conversation_id` in the
+   * [call.conversation.created](/api-reference/callbacks/call-conversation-created)
+   * webhook and correlate it using `data.payload.call_control_id`. The `answer` HTTP
+   * response does not include `conversation_id`. The created event is emitted during
+   * assistant startup and does not indicate that the assistant is ready to speak.
+   *
+   * Set the assistant voice with `assistant.voice_settings.voice` and speech-to-text
+   * settings with `assistant.transcription`. You can reuse one stored assistant with
+   * different per-call settings. Warm-up prepares assistant configuration and
+   * dependencies; it does not wait for the greeting audio to be ready or guarantee
+   * zero silence after answer. A plain `answer` followed by `ai_assistant_start`
+   * performs assistant startup after the call has already been answered.
+   *
    * **Expected Webhooks:**
    *
    * - `call.answered`
+   * - `call.conversation.created` when the requested assistant conversation is
+   *   created
    * - `call.hold` and `call.unhold` if the call is held/unheld
    * - `call.deepfake_detection.result` if `deepfake_detection` was enabled
    * - `call.deepfake_detection.error` if `deepfake_detection` was enabled and an
@@ -266,6 +292,8 @@ export class Actions extends APIResource {
    *
    * **Expected Webhooks:**
    *
+   * - [`call.conversation.created`](/api-reference/callbacks/call-conversation-created)
+   *   includes `conversation_id` during startup
    * - `call.ai_gather.ended`
    * - `call.conversation.ended`
    * - `call.ai_gather.partial_results` (if `send_partial_results` is set to `true`)
@@ -888,6 +916,9 @@ export class Actions extends APIResource {
    *   `answering_machine_detection=premium` was requested
    * - `call.machine.premium.greeting.ended` if `answering_machine_detection=premium`
    *   was requested and a beep was detected
+   * - `call.machine.premium.call_screening.detected` if
+   *   `answering_machine_detection=premium_ios_call_screening_detection` was
+   *   requested and an Apple Call Screening tone was detected
    *
    * @example
    * ```ts
@@ -1652,9 +1683,10 @@ export interface TelnyxVoiceSettings {
   type: 'telnyx';
 
   /**
-   * The voice speed to be used for the voice. The voice speed must be between 0.1
-   * and 2.0. Default value is 1.0. Not supported for `Telnyx.Bayan.*` or
-   * `Telnyx.Sukhan.*` voices.
+   * The voice speed to be used for the voice. Telnyx `Ultra` voices accept values
+   * from 0.6 to 1.5; values outside that range are rejected by the synthesis engine.
+   * `Qwen3TTS` and `KokoroTTS` accept the field but do not apply it. Default value
+   * is 1.0. Not supported for `Telnyx.Bayan.*` or `Telnyx.Sukhan.*` voices.
    */
   voice_speed?: number;
 }
@@ -2539,9 +2571,11 @@ export interface ActionUpdateClientStateResponse {
 
 export interface ActionStartAIAssistantParams {
   /**
-   * AI Assistant configuration. All fields except `id` are optional — the
-   * assistant's stored configuration will be used as fallback for any omitted
-   * fields.
+   * AI Assistant configuration and per-call overrides. All fields except `id` are
+   * optional. Omitted assistant fields use the stored configuration. Supplied
+   * `voice_settings` and `transcription` objects replace their stored objects rather
+   * than merging individual settings; include every setting you want to retain.
+   * `dynamic_variables` are merged, with request values taking precedence.
    */
   assistant?: CallsAPI.CallAssistantRequest;
 
@@ -2613,9 +2647,11 @@ export interface ActionStopAIAssistantParams {
 
 export interface ActionAnswerParams {
   /**
-   * AI Assistant configuration. All fields except `id` are optional — the
-   * assistant's stored configuration will be used as fallback for any omitted
-   * fields.
+   * AI Assistant configuration and per-call overrides. All fields except `id` are
+   * optional. Omitted assistant fields use the stored configuration. Supplied
+   * `voice_settings` and `transcription` objects replace their stored objects rather
+   * than merging individual settings; include every setting you want to retain.
+   * `dynamic_variables` are merged, with request values taking precedence.
    */
   assistant?: CallsAPI.CallAssistantRequest;
 
@@ -2766,7 +2802,9 @@ export interface ActionAnswerParams {
   stream_url?: string;
 
   /**
-   * Enable transcription upon call answer. The default value is false.
+   * Enable standalone call transcription upon call answer. The default value is
+   * false. Configure this feature with `transcription_config`. To configure speech
+   * recognition for an AI assistant, use `assistant.transcription` instead.
    */
   transcription?: boolean;
 
@@ -4192,9 +4230,12 @@ export interface ActionReferParams {
 
 export interface ActionRejectParams {
   /**
-   * Cause for call rejection.
+   * Cause for call rejection. The cause sets the SIP response the caller receives:
+   * `USER_BUSY` sends 486 User Busy, `CALL_REJECTED` sends 603 Decline, `NOT_FOUND`
+   * sends 404 Not Found, and `TEMPORARILY_UNAVAILABLE` sends 480 Temporarily
+   * Unavailable.
    */
-  cause: 'CALL_REJECTED' | 'USER_BUSY';
+  cause: 'CALL_REJECTED' | 'NOT_FOUND' | 'TEMPORARILY_UNAVAILABLE' | 'USER_BUSY';
 
   /**
    * Use this field to add state to every subsequent webhook. It must be a valid
@@ -4795,10 +4836,20 @@ export interface ActionTransferParams {
    * 'greeting_end' or 'detect_words' is used and a 'machine' is detected, you will
    * receive another 'call.machine.greeting.ended' webhook when the answering machine
    * greeting ends with a beep or silence. If `detect_beep` is used, you will only
-   * receive 'call.machine.greeting.ended' if a beep is detected.
+   * receive 'call.machine.greeting.ended' if a beep is detected. If
+   * `answering_machine_detection` is set to `premium_ios_call_screening_detection`,
+   * Premium AMD runs with iOS Call Screening support: after an initial `machine`
+   * result, Telnyx listens for the iOS call-screening prompt to end or for an Apple
+   * Call Screening tone, sends `call.machine.premium.greeting.ended` with
+   * `result=prompt_ended` or `call.machine.premium.call_screening.detected` with
+   * `result=screening` respectively. When the Apple Call Screening tone is detected,
+   * Premium AMD is restarted on the screened call and a
+   * `call.machine.premium.detection.ended` webhook with the post-screening
+   * classification follows.
    */
   answering_machine_detection?:
     | 'premium'
+    | 'premium_ios_call_screening_detection'
     | 'detect'
     | 'detect_beep'
     | 'detect_words'
@@ -4809,7 +4860,8 @@ export interface ActionTransferParams {
    * Optional configuration parameters to modify 'answering_machine_detection'
    * performance. Only `total_analysis_time_millis` and `greeting_duration_millis`
    * parameters are applicable when `premium` is selected as
-   * answering_machine_detection.
+   * answering_machine_detection. `prompt_end_timeout_millis` is additionally
+   * applicable when `premium_ios_call_screening_detection` is selected.
    */
   answering_machine_detection_config?: ActionTransferParams.AnsweringMachineDetectionConfig;
 
@@ -5077,7 +5129,8 @@ export namespace ActionTransferParams {
    * Optional configuration parameters to modify 'answering_machine_detection'
    * performance. Only `total_analysis_time_millis` and `greeting_duration_millis`
    * parameters are applicable when `premium` is selected as
-   * answering_machine_detection.
+   * answering_machine_detection. `prompt_end_timeout_millis` is additionally
+   * applicable when `premium_ios_call_screening_detection` is selected.
    */
   export interface AnsweringMachineDetectionConfig {
     /**
@@ -5177,6 +5230,14 @@ export namespace ActionTransferParams {
      */
     maximum_word_length_millis?: number;
 
+    /**
+     * Maximum time Telnyx waits, in milliseconds, for the iOS call-screening prompt to
+     * end after Premium AMD initially detects a `machine`. Used when
+     * `answering_machine_detection` is `premium_ios_call_screening_detection`.
+     * Defaults to 5000 milliseconds.
+     */
+    prompt_end_timeout_millis?: number;
+
     /**
      * Minimum noise threshold for any analysis.
      */