retell-sdk 5.32.4 → 5.33.0

package/src/resources/phone-number.ts

@@ -20,6 +20,23 @@ export class PhoneNumber extends APIResource {
     return this._client.post('/create-phone-number', { body, ...options });
   }
 
+  /**
+   * Import a phone number from custom telephony & Bind agents
+   *
+   * @example
+   * ```ts
+   * const phoneNumberResponse = await client.phoneNumber.import(
+   *   {
+   *     phone_number: '+14157774444',
+   *     termination_uri: 'someuri.pstn.twilio.com',
+   *   },
+   * );
+   * ```
+   */
+  import(body: PhoneNumberImportParams, options?: RequestOptions): APIPromise<PhoneNumberResponse> {
+    return this._client.post('/import-phone-number', { body, ...options });
+  }
+
   /**
    * Retrieve details of a specific phone number
    *
@@ -33,6 +50,21 @@ export class PhoneNumber extends APIResource {
     return this._client.get(path`/get-phone-number/${phoneNumber}`, options);
   }
 
+  /**
+   * List phone numbers with pagination
+   *
+   * @example
+   * ```ts
+   * const phoneNumbers = await client.phoneNumber.list();
+   * ```
+   */
+  list(
+    query: PhoneNumberListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<PhoneNumberListResponse> {
+    return this._client.get('/v2/list-phone-numbers', { query, ...options });
+  }
+
   /**
    * Update agent bound to a purchased phone number
    *
@@ -68,21 +100,6 @@ export class PhoneNumber extends APIResource {
     return this._client.patch(path`/update-phone-number/${phoneNumber}`, { body, ...options });
   }
 
-  /**
-   * List phone numbers with pagination
-   *
-   * @example
-   * ```ts
-   * const phoneNumbers = await client.phoneNumber.list();
-   * ```
-   */
-  list(
-    query: PhoneNumberListParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<PhoneNumberListResponse> {
-    return this._client.get('/v2/list-phone-numbers', { query, ...options });
-  }
-
   /**
    * Delete an existing phone number
    *
@@ -97,23 +114,6 @@ export class PhoneNumber extends APIResource {
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
     });
   }
-
-  /**
-   * Import a phone number from custom telephony & Bind agents
-   *
-   * @example
-   * ```ts
-   * const phoneNumberResponse = await client.phoneNumber.import(
-   *   {
-   *     phone_number: '+14157774444',
-   *     termination_uri: 'someuri.pstn.twilio.com',
-   *   },
-   * );
-   * ```
-   */
-  import(body: PhoneNumberImportParams, options?: RequestOptions): APIPromise<PhoneNumberResponse> {
-    return this._client.post('/import-phone-number', { body, ...options });
-  }
 }
 
 export interface PhoneNumberResponse {
@@ -153,11 +153,11 @@ export interface PhoneNumberResponse {
   area_code?: number;
 
   /**
-   * Enterprise only. Phone number to transfer inbound calls to when organization is
-   * in outage mode or when an inbound call cannot get a concurrency slot before the
-   * fallback timeout. Can be either a Retell phone number or an external number.
-   * Cannot be the same as this phone number, and cannot be a number that already has
-   * its own fallback configured (prevents nested forwarding).
+   * When inbound call concurrency is reached and a slot does not free up after
+   * extended ringing, the call will fall back to this number. Can be either a Retell
+   * phone number or an external number. Cannot be the same as this phone number, and
+   * cannot be a number that already has its own fallback configured (prevents nested
+   * forwarding).
    */
   fallback_number?: string | null;
 
@@ -177,8 +177,9 @@ export interface PhoneNumberResponse {
   inbound_sms_agents?: Array<PhoneNumberResponse.InboundSMSAgent> | null;
 
   /**
-   * If set, will send a webhook for inbound SMS, where you can override agent id,
-   * set dynamic variables and other fields specific to that chat.
+   * If set, Retell will send a webhook for inbound SMS, where you can override the
+   * agent ID, set dynamic variables, and configure other fields specific to that
+   * chat.
    */
   inbound_sms_webhook_url?: string | null;
 
@@ -369,11 +370,11 @@ export interface PhoneNumberCreateParams {
   country_code?: 'US' | 'CA';
 
   /**
-   * Enterprise only. Phone number to transfer inbound calls to when organization is
-   * in outage mode or when an inbound call cannot get a concurrency slot before the
-   * fallback timeout. Can be either a Retell phone number or an external number.
-   * Cannot be the same as this phone number, and cannot be a number that already has
-   * its own fallback configured (prevents nested forwarding).
+   * When inbound call concurrency is reached and a slot does not free up after
+   * extended ringing, the call will fall back to this number. Can be either a Retell
+   * phone number or an external number. Cannot be the same as this phone number, and
+   * cannot be a number that already has its own fallback configured (prevents nested
+   * forwarding).
    */
   fallback_number?: string | null;
 
@@ -385,8 +386,9 @@ export interface PhoneNumberCreateParams {
   inbound_agents?: Array<PhoneNumberCreateParams.InboundAgent> | null;
 
   /**
-   * If set, will send a webhook for inbound calls, where you can override agent id,
-   * set dynamic variables and other fields specific to that call.
+   * If set, Retell will send a webhook for inbound calls, where you can override the
+   * agent ID, set dynamic variables, and configure other fields specific to that
+   * call.
    */
   inbound_webhook_url?: string | null;
 
@@ -473,93 +475,76 @@ export namespace PhoneNumberCreateParams {
   }
 }
 
-export interface PhoneNumberUpdateParams {
+export interface PhoneNumberImportParams {
   /**
-   * List of ISO 3166-1 alpha-2 country codes from which inbound calls are allowed.
-   * If not set or empty, calls from all countries are allowed.
+   * The number you are trying to import in E.164 format of the number (+country
+   * code, then number with no space, no special characters), used as the unique
+   * identifier for phone number APIs.
    */
-  allowed_inbound_country_list?: Array<string> | null;
+  phone_number: string;
 
   /**
-   * List of ISO 3166-1 alpha-2 country codes to which outbound calls are allowed. If
-   * not set or empty, calls to all countries are allowed.
+   * The termination uri to uniquely identify your elastic SIP trunk. This is used
+   * for outbound calls. For Twilio elastic SIP trunks it always end with
+   * ".pstn.twilio.com".
    */
-  allowed_outbound_country_list?: Array<string> | null;
+  termination_uri: string;
 
   /**
-   * The password used for authentication for the SIP trunk to update for the phone
-   * number.
+   * List of ISO 3166-1 alpha-2 country codes from which inbound calls are allowed.
+   * If not set or empty, calls from all countries are allowed.
    */
-  auth_password?: string;
+  allowed_inbound_country_list?: Array<string> | null;
 
   /**
-   * The username used for authentication for the SIP trunk to update for the phone
-   * number.
+   * List of ISO 3166-1 alpha-2 country codes to which outbound calls are allowed. If
+   * not set or empty, calls to all countries are allowed.
    */
-  auth_username?: string;
+  allowed_outbound_country_list?: Array<string> | null;
 
   /**
-   * Enterprise only. Phone number to transfer inbound calls to when organization is
-   * in outage mode or when an inbound call cannot get a concurrency slot before the
-   * fallback timeout. Can be either a Retell phone number or an external number. Set
-   * to null to remove. Cannot be the same as this phone number, and cannot be a
-   * number that already has its own fallback configured (prevents nested
-   * forwarding).
+   * If true, E.164 validation for phone_number is skipped. This is useful for
+   * internal pseudo numbers when using custom telephony. If omitted, default is
+   * true. Must be a boolean literal; string values like "true" or "false" are
+   * invalid.
    */
-  fallback_number?: string | null;
+  ignore_e164_validation?: boolean;
 
   /**
    * Inbound agents to bind to the number with weights. If set and non-empty, one
    * agent will be picked randomly for each inbound call, with probability
    * proportional to the weight. Total weights must add up to 1.
    */
-  inbound_agents?: Array<PhoneNumberUpdateParams.InboundAgent> | null;
-
-  /**
-   * Inbound SMS agents to bind to the number with weights. If set and non-empty, one
-   * agent will be picked randomly for each inbound SMS, with probability
-   * proportional to the weight. Total weights must add up to 1. If not set or empty,
-   * fallback to inbound_sms_agent_id.
-   */
-  inbound_sms_agents?: Array<PhoneNumberUpdateParams.InboundSMSAgent> | null;
-
-  /**
-   * If set, will send a webhook for inbound SMS, where you can override agent id,
-   * set dynamic variables and other fields specific to that chat.
-   */
-  inbound_sms_webhook_url?: string | null;
+  inbound_agents?: Array<PhoneNumberImportParams.InboundAgent> | null;
 
   /**
-   * If set, will send a webhook for inbound calls, where you can override agent id,
-   * set dynamic variables and other fields specific to that call.
+   * If set, Retell will send a webhook for inbound calls, where you can override the
+   * agent ID, set dynamic variables, and configure other fields specific to that
+   * call.
    */
   inbound_webhook_url?: string | null;
 
   /**
    * Nickname of the number. This is for your reference only.
    */
-  nickname?: string | null;
+  nickname?: string;
 
   /**
    * Outbound agents to bind to the number with weights. If set and non-empty, one
    * agent will be picked randomly for each outbound call, with probability
    * proportional to the weight. Total weights must add up to 1.
    */
-  outbound_agents?: Array<PhoneNumberUpdateParams.OutboundAgent> | null;
+  outbound_agents?: Array<PhoneNumberImportParams.OutboundAgent> | null;
 
   /**
-   * Outbound SMS agents to bind to the number with weights. If set and non-empty,
-   * one agent will be picked randomly for each outbound SMS, with probability
-   * proportional to the weight. Total weights must add up to 1. If not set or empty,
-   * fallback to outbound_sms_agent_id.
+   * The password used for authentication for the SIP trunk.
    */
-  outbound_sms_agents?: Array<PhoneNumberUpdateParams.OutboundSMSAgent> | null;
+  sip_trunk_auth_password?: string;
 
   /**
-   * The termination uri to update for the phone number. This is used for outbound
-   * calls.
+   * The username used for authentication for the SIP trunk.
    */
-  termination_uri?: string;
+  sip_trunk_auth_username?: string;
 
   /**
    * Outbound transport protocol to update for the phone number. Valid values are
@@ -568,7 +553,7 @@ export interface PhoneNumberUpdateParams {
   transport?: string | null;
 }
 
-export namespace PhoneNumberUpdateParams {
+export namespace PhoneNumberImportParams {
   export interface InboundAgent {
     agent_id: string;
 
@@ -592,29 +577,6 @@ export namespace PhoneNumberUpdateParams {
     agent_version?: number | string;
   }
 
-  export interface InboundSMSAgent {
-    agent_id: string;
-
-    /**
-     * The weight of the agent. When used in a list of agents, the total weights must
-     * add up to 1.
-     */
-    weight: number;
-
-    /**
-     * Agent version reference. Supports a numeric version (for example 3) or a
-     * tag/environment name (for example "prod"). The string "latest" resolves to the
-     * most recently created version (the largest version number), and
-     * "latest_published" resolves to the most recently published version. When a tag
-     * is provided, resolution uses that exact tag assignment (including its dynamic
-     * variables). If the tag exists but is currently unassigned, it resolves to
-     * latest. When a numeric version, latest, or latest_published is provided,
-     * resolution applies dynamic variables from the preferred tag for that resolved
-     * version (most recently assigned), if any.
-     */
-    agent_version?: number | string;
-  }
-
   export interface OutboundAgent {
     agent_id: string;
 
@@ -637,29 +599,6 @@ export namespace PhoneNumberUpdateParams {
      */
     agent_version?: number | string;
   }
-
-  export interface OutboundSMSAgent {
-    agent_id: string;
-
-    /**
-     * The weight of the agent. When used in a list of agents, the total weights must
-     * add up to 1.
-     */
-    weight: number;
-
-    /**
-     * Agent version reference. Supports a numeric version (for example 3) or a
-     * tag/environment name (for example "prod"). The string "latest" resolves to the
-     * most recently created version (the largest version number), and
-     * "latest_published" resolves to the most recently published version. When a tag
-     * is provided, resolution uses that exact tag assignment (including its dynamic
-     * variables). If the tag exists but is currently unassigned, it resolves to
-     * latest. When a numeric version, latest, or latest_published is provided,
-     * resolution applies dynamic variables from the preferred tag for that resolved
-     * version (most recently assigned), if any.
-     */
-    agent_version?: number | string;
-  }
 }
 
 export interface PhoneNumberListParams {
@@ -679,21 +618,7 @@ export interface PhoneNumberListParams {
   sort_order?: 'ascending' | 'descending';
 }
 
-export interface PhoneNumberImportParams {
-  /**
-   * The number you are trying to import in E.164 format of the number (+country
-   * code, then number with no space, no special characters), used as the unique
-   * identifier for phone number APIs.
-   */
-  phone_number: string;
-
-  /**
-   * The termination uri to uniquely identify your elastic SIP trunk. This is used
-   * for outbound calls. For Twilio elastic SIP trunks it always end with
-   * ".pstn.twilio.com".
-   */
-  termination_uri: string;
-
+export interface PhoneNumberUpdateParams {
   /**
    * List of ISO 3166-1 alpha-2 country codes from which inbound calls are allowed.
    * If not set or empty, calls from all countries are allowed.
@@ -707,47 +632,80 @@ export interface PhoneNumberImportParams {
   allowed_outbound_country_list?: Array<string> | null;
 
   /**
-   * If true, E.164 validation for phone_number is skipped. This is useful for
-   * internal pseudo numbers when using custom telephony. If omitted, default is
-   * true. Must be a boolean literal; string values like "true" or "false" are
-   * invalid.
+   * The password used for authentication for the SIP trunk to update for the phone
+   * number.
    */
-  ignore_e164_validation?: boolean;
+  auth_password?: string;
+
+  /**
+   * The username used for authentication for the SIP trunk to update for the phone
+   * number.
+   */
+  auth_username?: string;
+
+  /**
+   * When inbound call concurrency is reached and a slot does not free up after
+   * extended ringing, the call will fall back to this number. Can be either a Retell
+   * phone number or an external number. Set to null to remove. Cannot be the same as
+   * this phone number, and cannot be a number that already has its own fallback
+   * configured (prevents nested forwarding).
+   */
+  fallback_number?: string | null;
 
   /**
    * Inbound agents to bind to the number with weights. If set and non-empty, one
    * agent will be picked randomly for each inbound call, with probability
    * proportional to the weight. Total weights must add up to 1.
    */
-  inbound_agents?: Array<PhoneNumberImportParams.InboundAgent> | null;
+  inbound_agents?: Array<PhoneNumberUpdateParams.InboundAgent> | null;
 
   /**
-   * If set, will send a webhook for inbound calls, where you can override agent id,
-   * set dynamic variables and other fields specific to that call.
+   * Inbound SMS agents to bind to the number with weights. If set and non-empty, one
+   * agent will be picked randomly for each inbound SMS, with probability
+   * proportional to the weight. Total weights must add up to 1. If not set or empty,
+   * fallback to inbound_sms_agent_id.
+   */
+  inbound_sms_agents?: Array<PhoneNumberUpdateParams.InboundSMSAgent> | null;
+
+  /**
+   * If set, Retell will send a webhook for inbound SMS, where you can override the
+   * agent ID, set dynamic variables, and configure other fields specific to that
+   * chat.
+   */
+  inbound_sms_webhook_url?: string | null;
+
+  /**
+   * If set, Retell will send a webhook for inbound calls, where you can override the
+   * agent ID, set dynamic variables, and configure other fields specific to that
+   * call.
    */
   inbound_webhook_url?: string | null;
 
   /**
    * Nickname of the number. This is for your reference only.
    */
-  nickname?: string;
+  nickname?: string | null;
 
   /**
    * Outbound agents to bind to the number with weights. If set and non-empty, one
    * agent will be picked randomly for each outbound call, with probability
    * proportional to the weight. Total weights must add up to 1.
    */
-  outbound_agents?: Array<PhoneNumberImportParams.OutboundAgent> | null;
+  outbound_agents?: Array<PhoneNumberUpdateParams.OutboundAgent> | null;
 
   /**
-   * The password used for authentication for the SIP trunk.
+   * Outbound SMS agents to bind to the number with weights. If set and non-empty,
+   * one agent will be picked randomly for each outbound SMS, with probability
+   * proportional to the weight. Total weights must add up to 1. If not set or empty,
+   * fallback to outbound_sms_agent_id.
    */
-  sip_trunk_auth_password?: string;
+  outbound_sms_agents?: Array<PhoneNumberUpdateParams.OutboundSMSAgent> | null;
 
   /**
-   * The username used for authentication for the SIP trunk.
+   * The termination uri to update for the phone number. This is used for outbound
+   * calls.
    */
-  sip_trunk_auth_username?: string;
+  termination_uri?: string;
 
   /**
    * Outbound transport protocol to update for the phone number. Valid values are
@@ -756,7 +714,7 @@ export interface PhoneNumberImportParams {
   transport?: string | null;
 }
 
-export namespace PhoneNumberImportParams {
+export namespace PhoneNumberUpdateParams {
   export interface InboundAgent {
     agent_id: string;
 
@@ -780,6 +738,29 @@ export namespace PhoneNumberImportParams {
     agent_version?: number | string;
   }
 
+  export interface InboundSMSAgent {
+    agent_id: string;
+
+    /**
+     * The weight of the agent. When used in a list of agents, the total weights must
+     * add up to 1.
+     */
+    weight: number;
+
+    /**
+     * Agent version reference. Supports a numeric version (for example 3) or a
+     * tag/environment name (for example "prod"). The string "latest" resolves to the
+     * most recently created version (the largest version number), and
+     * "latest_published" resolves to the most recently published version. When a tag
+     * is provided, resolution uses that exact tag assignment (including its dynamic
+     * variables). If the tag exists but is currently unassigned, it resolves to
+     * latest. When a numeric version, latest, or latest_published is provided,
+     * resolution applies dynamic variables from the preferred tag for that resolved
+     * version (most recently assigned), if any.
+     */
+    agent_version?: number | string;
+  }
+
   export interface OutboundAgent {
     agent_id: string;
 
@@ -802,6 +783,29 @@ export namespace PhoneNumberImportParams {
      */
     agent_version?: number | string;
   }
+
+  export interface OutboundSMSAgent {
+    agent_id: string;
+
+    /**
+     * The weight of the agent. When used in a list of agents, the total weights must
+     * add up to 1.
+     */
+    weight: number;
+
+    /**
+     * Agent version reference. Supports a numeric version (for example 3) or a
+     * tag/environment name (for example "prod"). The string "latest" resolves to the
+     * most recently created version (the largest version number), and
+     * "latest_published" resolves to the most recently published version. When a tag
+     * is provided, resolution uses that exact tag assignment (including its dynamic
+     * variables). If the tag exists but is currently unassigned, it resolves to
+     * latest. When a numeric version, latest, or latest_published is provided,
+     * resolution applies dynamic variables from the preferred tag for that resolved
+     * version (most recently assigned), if any.
+     */
+    agent_version?: number | string;
+  }
 }
 
 export declare namespace PhoneNumber {
@@ -809,8 +813,8 @@ export declare namespace PhoneNumber {
     type PhoneNumberResponse as PhoneNumberResponse,
     type PhoneNumberListResponse as PhoneNumberListResponse,
     type PhoneNumberCreateParams as PhoneNumberCreateParams,
-    type PhoneNumberUpdateParams as PhoneNumberUpdateParams,
-    type PhoneNumberListParams as PhoneNumberListParams,
     type PhoneNumberImportParams as PhoneNumberImportParams,
+    type PhoneNumberListParams as PhoneNumberListParams,
+    type PhoneNumberUpdateParams as PhoneNumberUpdateParams,
   };
 }

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '5.32.4'; // x-release-please-version
+export const VERSION = '5.33.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "5.32.4";
+export declare const VERSION = "5.33.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "5.32.4";
+export declare const VERSION = "5.33.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '5.32.4'; // x-release-please-version
+exports.VERSION = '5.33.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '5.32.4'; // x-release-please-version
+export const VERSION = '5.33.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map