telnyx 7.26.0 → 7.27.0

package/src/resources/dir/dir.ts

@@ -248,8 +248,7 @@ export class DirResource extends APIResource {
    * existing registration stays live throughout the new vetting cycle.
    *
    * Returns `400` from `submitted`/`in_review`/`permanently_rejected`. Returns `400`
-   * if the DIR's business and financial references have not been submitted. Returns
-   * `400` if the DIR has an unresolved infringement claim.
+   * if the DIR has an unresolved infringement claim.
    *
    * @example
    * ```ts
@@ -533,6 +532,7 @@ export interface Document {
     | 'letter_of_authorization'
     | 'business_registration'
     | 'articles_of_incorporation'
+    | 'certificate_of_good_standing'
     | 'tax_document'
     | 'ein_letter'
     | 'trademark_registration'
@@ -542,6 +542,8 @@ export interface Document {
     | 'government_id'
     | 'utility_bill'
     | 'bank_statement'
+    | 'business_credit_report'
+    | 'bank_reference_letter'
     | 'other';
 
   /**

package/src/resources/dir/references.ts

@@ -7,6 +7,8 @@ import { path } from '../../internal/utils/path';
 
 /**
  * Submit and manage the two business references and one financial reference that vouch for a DIR. References are contacted to confirm the business identity during vetting.
+ *
+ * References (two business references and one financial reference) are needed only if the documents uploaded with the DIR don't already prove the business is legitimate and financially stable. Any one of these is enough proof: audited or certified financial statements (uploaded as `other`, with a description), a commercial credit report (uploaded as `business_credit_report`), or references. Telnyx reviewers decide during vetting whether your documents are enough.
  */
 export class References extends APIResource {
   /**
@@ -33,21 +35,25 @@ export class References extends APIResource {
   /**
    * Submit the two business references and one financial reference for a DIR.
    *
-   * The DIR's authorizer email must be verified first (see the email-verification
-   * endpoint). Until it is, this returns `409` and no references are stored.
+   * References (two business references and one financial reference) are needed only
+   * if the documents uploaded with the DIR don't already prove the business is
+   * legitimate and financially stable. Any one of these is enough proof: audited or
+   * certified financial statements (uploaded as `other`, with a description), a
+   * commercial credit report (uploaded as `business_credit_report`), or references.
+   * Telnyx reviewers decide during vetting whether your documents are enough.
+   *
+   * References can't be changed while the DIR is `verified`. Update the DIR first,
+   * which returns it to draft.
    *
    * The request body carries exactly two business references plus one financial
    * reference. The first submission stores them and returns `201`. Resubmitting
    * returns `200`: identical values are simply confirmed and nothing is written,
    * while changed values replace those references.
    *
-   * Replacing a reference is allowed only while the DIR itself is still editable,
-   * the same window in which a single reference may be updated; once the DIR has
-   * been submitted for vetting this returns `400`. A replaced reference's pending
-   * verification call is cancelled and its dial-in code stops working, and the
-   * replacement contact is emailed fresh scheduling details. References whose
-   * details did not change keep their existing call, code, and the notice already
-   * sent to them.
+   * A replaced reference's pending verification call is cancelled and its dial-in
+   * code stops working, and the replacement contact is emailed fresh scheduling
+   * details. References whose details did not change keep their existing call, code,
+   * and the notice already sent to them.
    *
    * The response always echoes the stored references in the same shape as the GET.
    *

package/src/resources/dir/verify-email.ts

@@ -6,7 +6,7 @@ import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
 /**
- * Verify ownership of a DIR's authorizer email. A short code is emailed and confirmed; the email must be verified before references can be submitted.
+ * Verify ownership of a DIR's authorizer email. A short code is emailed and confirmed.
  */
 export class VerifyEmail extends APIResource {
   /**
@@ -26,11 +26,23 @@ export class VerifyEmail extends APIResource {
 
   /**
    * Email a 6-digit code to the DIR's authorizer email to confirm ownership of that
-   * address.
+   * address. The code goes to the authorizer, not to the caller. If the authorizer
+   * is someone else (for example a client's executive), that person has to share the
+   * code with whoever is completing setup.
    *
-   * The code expires in 15 minutes. Requesting a new code invalidates any previous
-   * one. Resends are rate limited (a short cooldown plus a daily cap). Submit the
-   * code to `POST /dir/{dir_id}/verify_email/confirm`.
+   * How long the code lasts: 15 minutes by default. 8 hours when the DIR has a call
+   * center (BPO) linked through `bpo_authorizations` whose authorization is pending
+   * review or approved (a rejected authorization does not count). Link the call
+   * center before you send the code: a code sent before the link keeps the 15-minute
+   * window, and a code sent after the link lasts 8 hours. The email states the
+   * window, and `expires_at` in the response always shows the exact expiry.
+   *
+   * To resend, call this endpoint again. Each send issues a fresh code and
+   * invalidates the previous one. Sends are limited to one every 60 seconds and 10
+   * per DIR per UTC day. A throttled send returns `429` with `retry_after_secs` and
+   * `sends_remaining_today` in the error `meta`.
+   *
+   * Submit the code to `POST /dir/{dir_id}/verify_email/confirm`.
    *
    * @example
    * ```ts

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

@@ -565,7 +565,7 @@ export interface EmailDomainListParams extends DefaultFlatPaginationParams {
   /**
    * Field to sort by. Prefix with `-` for descending order.
    */
-  sort?: 'created_at' | '-created_at' | 'domain' | '-domain';
+  sort?: 'created_at' | '-created_at' | 'domain' | '-domain' | 'updated_at' | '-updated_at';
 }
 
 export interface EmailDomainCreateParams {

package/src/resources/enterprises/verify-email.ts

@@ -6,7 +6,7 @@ import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
 /**
- * Verify ownership of a DIR's authorizer email. A short code is emailed and confirmed; the email must be verified before references can be submitted.
+ * Verify ownership of a DIR's authorizer email. A short code is emailed and confirmed.
  */
 export class VerifyEmail extends APIResource {
   /**

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

@@ -145,6 +145,17 @@ export interface FqdnConnection {
    */
   android_push_credential_id?: string | null;
 
+  /**
+   * Stores the connection preference for generating silent RTP toward the opposite
+   * call leg when comfort-noise packets (CN, payload type 13) are received during
+   * hold. Defaults to false and returns the saved value. Only JSON true and false
+   * are accepted; null and non-boolean values are rejected. This preference is
+   * independent of default_on_hold_comfort_noise_enabled and does not modify that
+   * setting. This API provisions the preference; call-processing behavior is
+   * implemented separately.
+   */
+  bridge_generate_comfort_noise_on_cn?: boolean;
+
   /**
    * Indicates whether call cost calculation is enabled.
    */
@@ -187,8 +198,8 @@ export interface FqdnConnection {
   encode_contact_header_enabled?: boolean;
 
   /**
-   * Enable use of SRTP for encryption. Cannot be set if the transport_portocol is
-   * TLS.
+   * Enable use of SRTP for encryption. Can only be set when the SIP signaling
+   * transport protocol is TLS.
    */
   encrypted_media?: CredentialConnectionsAPI.EncryptedMedia | null;
 
@@ -476,8 +487,8 @@ export interface OutboundFqdn {
   channel_limit?: number;
 
   /**
-   * Enable use of SRTP for encryption. Cannot be set if the transport_portocol is
-   * TLS.
+   * Enable use of SRTP for encryption. Can only be set when the SIP signaling
+   * transport protocol is TLS.
    */
   encrypted_media?: CredentialConnectionsAPI.EncryptedMedia | null;
 
@@ -655,6 +666,17 @@ export interface FqdnConnectionCreateParams {
    */
   android_push_credential_id?: string | null;
 
+  /**
+   * Stores the connection preference for generating silent RTP toward the opposite
+   * call leg when comfort-noise packets (CN, payload type 13) are received during
+   * hold. Optional; defaults to false when omitted on creation. Only JSON true and
+   * false are accepted; null and non-boolean values are rejected. This preference is
+   * independent of default_on_hold_comfort_noise_enabled and does not modify that
+   * setting. This API provisions the preference; call-processing behavior is
+   * implemented separately.
+   */
+  bridge_generate_comfort_noise_on_cn?: boolean;
+
   /**
    * Specifies if call cost webhooks should be sent for this connection.
    */
@@ -680,8 +702,8 @@ export interface FqdnConnectionCreateParams {
   encode_contact_header_enabled?: boolean;
 
   /**
-   * Enable use of SRTP for encryption. Cannot be set if the transport_portocol is
-   * TLS.
+   * Enable use of SRTP for encryption. Can only be set when the SIP signaling
+   * transport protocol is TLS.
    */
   encrypted_media?: CredentialConnectionsAPI.EncryptedMedia | null;
 
@@ -786,6 +808,17 @@ export interface FqdnConnectionUpdateParams {
    */
   android_push_credential_id?: string | null;
 
+  /**
+   * Stores the connection preference for generating silent RTP toward the opposite
+   * call leg when comfort-noise packets (CN, payload type 13) are received during
+   * hold. Optional; omitting this field preserves the saved value. Only JSON true
+   * and false are accepted; null and non-boolean values are rejected. This
+   * preference is independent of default_on_hold_comfort_noise_enabled and does not
+   * modify that setting. This API provisions the preference; call-processing
+   * behavior is implemented separately.
+   */
+  bridge_generate_comfort_noise_on_cn?: boolean;
+
   /**
    * Specifies if call cost webhooks should be sent for this connection.
    */
@@ -823,8 +856,8 @@ export interface FqdnConnectionUpdateParams {
   encode_contact_header_enabled?: boolean;
 
   /**
-   * Enable use of SRTP for encryption. Cannot be set if the transport_portocol is
-   * TLS.
+   * Enable use of SRTP for encryption. Can only be set when the SIP signaling
+   * transport protocol is TLS.
    */
   encrypted_media?: CredentialConnectionsAPI.EncryptedMedia | null;
 

package/src/resources/index.ts

@@ -279,6 +279,12 @@ export {
   type DetailRecordListParams,
   type DetailRecordListResponsesDefaultFlatPagination,
 } from './detail-records';
+export {
+  DialMetrics,
+  type DialMetricListResponse,
+  type DialMetricListParams,
+  type DialMetricListResponsesCloudfsCursorPagination,
+} from './dial-metrics';
 export {
   DialogflowConnections,
   type DialogflowConnectionResponse,
@@ -710,7 +716,6 @@ export {
   type MeetingSessionListResponse,
   type MeetingSessionDeleteRecordingMediaResponse,
   type MeetingSessionRetrieveEventsResponse,
-  type MeetingSessionRetrieveRecordingsResponse,
   type MeetingSessionRetrieveTranscriptResponse,
   type MeetingSessionListParams,
   type MeetingSessionCreateParams,
@@ -1060,6 +1065,7 @@ export {
 export { PhoneNumberBlocks } from './phone-number-blocks/phone-number-blocks';
 export {
   PhoneNumbers,
+  type NumbersError73c9788e53,
   type NumbersPhoneNumberDetailed,
   type PhoneNumberDetailed,
   type PhoneNumberRetrieveResponse,
@@ -1416,6 +1422,7 @@ export {
   type TelephonyCredentialListParams,
   type TelephonyCredentialCreateParams,
   type TelephonyCredentialUpdateParams,
+  type TelephonyCredentialCreateTokenParams,
   type TelephonyCredentialsDefaultFlatPagination,
 } from './telephony-credentials';
 export {
@@ -1469,6 +1476,7 @@ export {
   type TrafficPolicyProfilesDefaultFlatPagination,
   type TrafficPolicyProfileListServicesResponsesDefaultFlatPagination,
 } from './traffic-policy-profiles';
+export { TtsIntegrations } from './tts-integrations/tts-integrations';
 export {
   UacConnections,
   type UacConnection,
@@ -1681,6 +1689,7 @@ export {
   type CallAIGatherPartialResultsWebhookEvent,
   type ArtifactCompletedWebhookEvent,
   type ArtifactFailedWebhookEvent,
+  type CallAnalyzedWebhookEvent,
   type CallAnsweredWebhookEvent,
   type CallBridgedWebhookEvent,
   type CallConversationCreatedWebhookEvent,
@@ -1744,7 +1753,6 @@ export {
   type NumberReputationExternalVerificationStatusChangedWebhookEvent,
   type NumberReputationNumberFlaggedWebhookEvent,
   type NumberReputationNumberRemovedWebhookEvent,
-  type RecordingAvailableWebhookEvent,
   type ReplacedLinkClickWebhookEvent,
   type SessionStatusChangedWebhookEvent,
   type TranscriptCompletedWebhookEvent,

package/src/resources/ip-connections.ts

@@ -232,6 +232,17 @@ export interface IPConnection {
    */
   android_push_credential_id?: string | null;
 
+  /**
+   * Stores the connection preference for generating silent RTP toward the opposite
+   * call leg when comfort-noise packets (CN, payload type 13) are received during
+   * hold. Defaults to false and returns the saved value. Only JSON true and false
+   * are accepted; null and non-boolean values are rejected. This preference is
+   * independent of default_on_hold_comfort_noise_enabled and does not modify that
+   * setting. This API provisions the preference; call-processing behavior is
+   * implemented separately.
+   */
+  bridge_generate_comfort_noise_on_cn?: boolean;
+
   /**
    * Specifies if call cost webhooks should be sent for this connection.
    */
@@ -271,8 +282,8 @@ export interface IPConnection {
   encode_contact_header_enabled?: boolean;
 
   /**
-   * Enable use of SRTP for encryption. Cannot be set if the transport_portocol is
-   * TLS.
+   * Enable use of SRTP for encryption. Can only be set when the SIP signaling
+   * transport protocol is TLS.
    */
   encrypted_media?: CredentialConnectionsAPI.EncryptedMedia | null;
 
@@ -538,6 +549,17 @@ export interface IPConnectionCreateParams {
    */
   android_push_credential_id?: string | null;
 
+  /**
+   * Stores the connection preference for generating silent RTP toward the opposite
+   * call leg when comfort-noise packets (CN, payload type 13) are received during
+   * hold. Optional; defaults to false when omitted on creation. Only JSON true and
+   * false are accepted; null and non-boolean values are rejected. This preference is
+   * independent of default_on_hold_comfort_noise_enabled and does not modify that
+   * setting. This API provisions the preference; call-processing behavior is
+   * implemented separately.
+   */
+  bridge_generate_comfort_noise_on_cn?: boolean;
+
   /**
    * Specifies if call cost webhooks should be sent for this connection.
    */
@@ -565,8 +587,8 @@ export interface IPConnectionCreateParams {
   encode_contact_header_enabled?: boolean;
 
   /**
-   * Enable use of SRTP for encryption. Cannot be set if the transport_portocol is
-   * TLS.
+   * Enable use of SRTP for encryption. Can only be set when the SIP signaling
+   * transport protocol is TLS.
    */
   encrypted_media?: CredentialConnectionsAPI.EncryptedMedia | null;
 
@@ -759,6 +781,17 @@ export interface IPConnectionUpdateParams {
    */
   android_push_credential_id?: string | null;
 
+  /**
+   * Stores the connection preference for generating silent RTP toward the opposite
+   * call leg when comfort-noise packets (CN, payload type 13) are received during
+   * hold. Optional; omitting this field preserves the saved value. Only JSON true
+   * and false are accepted; null and non-boolean values are rejected. This
+   * preference is independent of default_on_hold_comfort_noise_enabled and does not
+   * modify that setting. This API provisions the preference; call-processing
+   * behavior is implemented separately.
+   */
+  bridge_generate_comfort_noise_on_cn?: boolean;
+
   /**
    * Specifies if call cost webhooks should be sent for this connection.
    */
@@ -793,8 +826,8 @@ export interface IPConnectionUpdateParams {
   encode_contact_header_enabled?: boolean;
 
   /**
-   * Enable use of SRTP for encryption. Cannot be set if the transport_portocol is
-   * TLS.
+   * Enable use of SRTP for encryption. Can only be set when the SIP signaling
+   * transport protocol is TLS.
    */
   encrypted_media?: CredentialConnectionsAPI.EncryptedMedia | null;
 

package/src/resources/meeting-sessions/actions.ts

@@ -31,12 +31,15 @@ export class Actions extends APIResource {
 
   /**
    * Sends audio / text-to-speech into a meeting session. With a Telnyx AI Assistant
-   * (or avatar) attached, the bot is a webpage-output bot: the speak audio routes
-   * through the assistant's output page rather than the bot mic and plays once the
-   * assistant is connected -- it is not refused. If that page cannot be reached,
-   * delivery fails with the 502 below, which may arrive without an error envelope,
-   * so branch on the status code before parsing a body. The assistant is designed to
-   * own the conversation, so prefer letting it speak or use `send_chat`.
+   * attached, the bot is a webpage-output bot: the speak audio routes through the
+   * assistant's output page rather than the bot mic and plays once the assistant is
+   * connected -- it is not refused. If that page cannot be reached, delivery fails
+   * with the 502 below, which may arrive without an error envelope, so branch on the
+   * status code before parsing a body. The assistant is designed to own the
+   * conversation, so prefer letting it speak or use `send_chat`. With a digital
+   * avatar (`assistant.avatar: true`), speak is refused with 409 `invalid_state`
+   * (message prefix `avatar_requires_assistant_speech:`): the avatar renders only
+   * the assistant's own speech.
    *
    * @example
    * ```ts
@@ -54,7 +57,10 @@ export class Actions extends APIResource {
   }
 
   /**
-   * Stops any active text-to-speech playback in a meeting session.
+   * Stops any active text-to-speech playback in a meeting session. Sessions with a
+   * digital avatar (`assistant.avatar: true`) return 409 `invalid_state` (message
+   * prefix `avatar_requires_assistant_speech:`): the avatar renders only the
+   * assistant's own speech.
    *
    * @example
    * ```ts

package/src/resources/meeting-sessions/index.ts

@@ -21,7 +21,6 @@ export {
   type MeetingSessionListResponse,
   type MeetingSessionDeleteRecordingMediaResponse,
   type MeetingSessionRetrieveEventsResponse,
-  type MeetingSessionRetrieveRecordingsResponse,
   type MeetingSessionRetrieveTranscriptResponse,
   type MeetingSessionListParams,
   type MeetingSessionCreateParams,

package/src/resources/meeting-sessions/meeting-sessions.ts

@@ -40,13 +40,18 @@ export class MeetingSessions extends APIResource {
    * request body, replay lookup is scoped to the authenticated account and compares
    * only the key; the request payload is not fingerprinted or compared. If a session
    * with that key already exists for the account, the existing session is replayed
-   * (200); otherwise a new session is created (201). Supports bring-your-own-key
-   * (BYOK) configuration. The session may enter asynchronous states (e.g. joining,
-   * waiting_for_admission) before becoming active. Optional `camera_image` input is
-   * write-only and applies only when no Avatar or Assistant webpage output takes
-   * precedence. An ignored URL is not fetched. An effective URL source is resolved
-   * before bot creation; neither the source URL nor image bytes are persisted,
-   * returned, or logged. Treat signed URLs as credentials.
+   * (200); otherwise a new session is created (201). The session may enter
+   * asynchronous states (e.g. joining, waiting_for_admission) before becoming
+   * active. Optional `camera_image` input is write-only and applies only when no
+   * avatar or Assistant webpage output takes precedence. An ignored URL is not
+   * fetched. An effective URL source is resolved before bot creation; neither the
+   * source URL nor image bytes are persisted, returned, or logged. Treat signed URLs
+   * as credentials. With `assistant.avatar: true`, the assistant is read before the
+   * bot is created: an assistant without a Telnyx avatar configured is rejected with
+   * 400 `invalid_request` (message prefix `assistant_avatar_not_configured:`), an
+   * unknown assistant with 400 `invalid_request` (prefix `assistant_not_found:`),
+   * and a failed lookup with 503 `assistant_lookup_unavailable`; no bot is created
+   * in any of these cases.
    *
    * @example
    * ```ts
@@ -143,8 +148,8 @@ export class MeetingSessions extends APIResource {
    * The operation retains the Telnyx-local Meeting session, transcript segments,
    * events, artifacts, and usage records. It is separate from
    * `DELETE /meeting_sessions/{id}`, which stops or cancels participation without
-   * deleting the persisted session. A missing/foreign session returns 404; provider
-   * deletion failures return 502.
+   * deleting the persisted session. A missing/foreign session returns 404; a
+   * deletion request whose outcome is unknown returns 502.
    *
    * @example
    * ```ts
@@ -161,24 +166,6 @@ export class MeetingSessions extends APIResource {
     return this._client.delete(path`/meeting_sessions/${id}/recording_media`, options);
   }
 
-  /**
-   * Returns recordings for a meeting session.
-   *
-   * @example
-   * ```ts
-   * const response =
-   *   await client.meetingSessions.retrieveRecordings(
-   *     'mtgsess_a1b2c3d4-e5f6-7890-abcd-ef1234567890',
-   *   );
-   * ```
-   */
-  retrieveRecordings(
-    id: string,
-    options?: RequestOptions,
-  ): APIPromise<MeetingSessionRetrieveRecordingsResponse> {
-    return this._client.get(path`/meeting_sessions/${id}/recordings`, options);
-  }
-
   /**
    * Returns transcript segments ordered by ascending `seq`. Default `limit` is 100
    * and maximum is 1,000. Continue with `after=meta.next_after`. A long-poll timeout
@@ -234,12 +221,16 @@ export interface MeetingSession {
   assistant_state_changed_at: string | null;
 
   /**
-   * Avatar configuration if an avatar is attached, otherwise null.
+   * The assistant's avatar, captured from its `avatar_settings` when the session was
+   * created. For display only; later changes to the assistant do not update it.
    */
   avatar: MeetingSession.Avatar | null;
 
   /**
-   * Current state of the avatar connection, or null if no avatar is attached.
+   * Current state of the avatar, or null if the session has no avatar. `starting`
+   * until the avatar's video is playing, then `connected`; `degraded` when the
+   * session has fallen back to voice-only (the `avatar.degraded` event carries the
+   * reason); `disconnected` when the avatar has ended.
    */
   avatar_state: 'starting' | 'connected' | 'degraded' | 'disconnected' | null;
 
@@ -368,7 +359,8 @@ export namespace MeetingSession {
   }
 
   /**
-   * Avatar configuration if an avatar is attached, otherwise null.
+   * The assistant's avatar, captured from its `avatar_settings` when the session was
+   * created. For display only; later changes to the assistant do not update it.
    */
   export interface Avatar {
     /**
@@ -376,10 +368,20 @@ export namespace MeetingSession {
      */
     avatar_id: string;
 
+    /**
+     * Identifier of the avatar's background.
+     */
+    background_id: string;
+
+    /**
+     * Avatar rendering model, for example `foxtrot-1`.
+     */
+    model: string;
+
     /**
      * Avatar provider identifier.
      */
-    provider: 'anam';
+    provider: 'telnyx';
   }
 
   export interface Config {
@@ -460,27 +462,6 @@ export namespace MeetingSessionRetrieveEventsResponse {
   }
 }
 
-export interface MeetingSessionRetrieveRecordingsResponse {
-  data: Array<MeetingSessionRetrieveRecordingsResponse.Data>;
-}
-
-export namespace MeetingSessionRetrieveRecordingsResponse {
-  export interface Data {
-    /**
-     * Expiry timestamp when available, or null. Currently returns null.
-     */
-    expires_at: string | null;
-
-    type: string;
-
-    /**
-     * Current provider download URL. The API does not guarantee URL lifetime or
-     * refresh behavior.
-     */
-    url: string;
-  }
-}
-
 export interface MeetingSessionRetrieveTranscriptResponse {
   data: Array<MeetingSessionRetrieveTranscriptResponse.Data>;
 
@@ -540,11 +521,6 @@ export interface MeetingSessionCreateParams {
    */
   assistant?: MeetingSessionCreateParams.Assistant;
 
-  /**
-   * Request options for attaching a bring-your-own-key avatar to the session.
-   */
-  avatar?: MeetingSessionCreateParams.Avatar;
-
   /**
    * When enabled, a human participant `speech_on` event interrupts and stops the
    * current bot audio; it does not bypass admission or initiate speech. Assistant
@@ -602,6 +578,7 @@ export interface MeetingSessionCreateParams {
    * is attached**: the value is accepted and echoed back on the session, but the
    * assistant owns the voice and the line is never delivered, with no event
    * reporting the omission. Use `chat_on_enter` to announce an assistant-backed bot.
+   * Rejected with 400 `invalid_request` when `assistant.avatar` is `true`.
    */
   speak_on_enter?: string;
 
@@ -648,6 +625,20 @@ export namespace MeetingSessionCreateParams {
      */
     audio_gate?: 'half_duplex' | 'full_duplex';
 
+    /**
+     * Beta. Show the avatar configured on the assistant (its `avatar_settings`; see
+     * [AI Assistant avatars](/docs/inference/ai-assistants/avatars)) as the bot's
+     * camera, lip-synced to the assistant's own speech. The request carries no avatar
+     * ID or key: the assistant is read at creation and the request is rejected with
+     * 400 `invalid_request` if it has no Telnyx avatar configured. Supported on Google
+     * Meet, Zoom, Microsoft Teams and Webex; other platforms return 422
+     * `unsupported_capability`. REST-only. Not echoed back on `assistant`; the
+     * session's top-level `avatar` and `avatar_state` fields report it instead. If the
+     * avatar fails, the session continues voice-only and `avatar_state` becomes
+     * `degraded`.
+     */
+    avatar?: boolean;
+
     /**
      * Per-conversation values for the
      * [dynamic variables](/docs/inference/ai-assistants/dynamic-variables) used in the
@@ -672,27 +663,6 @@ export namespace MeetingSessionCreateParams {
     leave_on_end?: boolean;
   }
 
-  /**
-   * Request options for attaching a bring-your-own-key avatar to the session.
-   */
-  export interface Avatar {
-    /**
-     * Bring-your-own-key API key for the avatar provider. The key is never stored or
-     * returned by the API.
-     */
-    api_key: string;
-
-    /**
-     * Identifier of the avatar to use.
-     */
-    avatar_id: string;
-
-    /**
-     * Avatar provider identifier. Currently only "anam" is supported.
-     */
-    provider: 'anam';
-  }
-
   export interface MeetingSessionCameraImageBase64Source {
     /**
      * Canonical plain RFC 4648 Base64 for a valid decoded JPEG. Data URIs, whitespace,
@@ -782,7 +752,6 @@ export declare namespace MeetingSessions {
     type MeetingSessionListResponse as MeetingSessionListResponse,
     type MeetingSessionDeleteRecordingMediaResponse as MeetingSessionDeleteRecordingMediaResponse,
     type MeetingSessionRetrieveEventsResponse as MeetingSessionRetrieveEventsResponse,
-    type MeetingSessionRetrieveRecordingsResponse as MeetingSessionRetrieveRecordingsResponse,
     type MeetingSessionRetrieveTranscriptResponse as MeetingSessionRetrieveTranscriptResponse,
     type MeetingSessionListParams as MeetingSessionListParams,
     type MeetingSessionCreateParams as MeetingSessionCreateParams,