telnyx 7.14.0 → 7.16.0

package/src/resources/meeting-sessions.ts

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

package/src/resources/messaging-profiles/messaging-profiles.ts

@@ -35,7 +35,7 @@ export class MessagingProfiles extends APIResource {
   actions: ActionsAPI.Actions = new ActionsAPI.Actions(this._client);
 
   /**
-   * Returns messaging profiles owned by the authenticated account. Apply the
+   * Lists messaging profiles owned by the authenticated account. Apply the
    * documented filters and pagination parameters to narrow the result set.
    *
    * @example

package/src/resources/phone-numbers/voicemail.ts

@@ -25,7 +25,10 @@ export class Voicemail extends APIResource {
   }
 
   /**
-   * Update voicemail settings for a phone number
+   * Update voicemail settings for a phone number. You can also configure a custom
+   * greeting by setting the `greeting` object: use `mode` `custom_greeting` together
+   * with a `media_name` that points to an audio file uploaded through the Media
+   * Storage API, or `mode` `default` to use the standard system greeting.
    *
    * @example
    * ```ts
@@ -44,7 +47,10 @@ export class Voicemail extends APIResource {
   }
 
   /**
-   * Create voicemail settings for a phone number
+   * Create voicemail settings for a phone number. You can also configure a custom
+   * greeting by setting the `greeting` object: use `mode` `custom_greeting` together
+   * with a `media_name` that points to an audio file uploaded through the Media
+   * Storage API, or `mode` `default` to use the standard system greeting.
    *
    * @example
    * ```ts
@@ -69,24 +75,92 @@ export interface VoicemailPrefResponse {
    */
   enabled?: boolean;
 
+  /**
+   * Controls the greeting a caller hears before leaving a voicemail. Set `mode` to
+   * `default` to play the standard system greeting, or to `custom_greeting` to play
+   * your own audio. When `mode` is `custom_greeting`, `media_name` is required and
+   * must reference an audio file already uploaded to your account through the Media
+   * Storage API.
+   */
+  greeting?: VoicemailPrefResponse.Greeting;
+
   /**
    * The pin used for the voicemail.
    */
   pin?: string;
 }
 
+export namespace VoicemailPrefResponse {
+  /**
+   * Controls the greeting a caller hears before leaving a voicemail. Set `mode` to
+   * `default` to play the standard system greeting, or to `custom_greeting` to play
+   * your own audio. When `mode` is `custom_greeting`, `media_name` is required and
+   * must reference an audio file already uploaded to your account through the Media
+   * Storage API.
+   */
+  export interface Greeting {
+    /**
+     * The name of the media file to play as the greeting. Required when `mode` is
+     * `custom_greeting`; ignored when `mode` is `default`. The value must match the
+     * `media_name` of a file you previously uploaded with the Media Storage API
+     * (`POST /v2/media`).
+     */
+    media_name?: string | null;
+
+    /**
+     * The greeting mode. `default` plays the standard system greeting.
+     * `custom_greeting` plays the audio referenced by `media_name`.
+     */
+    mode?: 'default' | 'custom_greeting';
+  }
+}
+
 export interface VoicemailRequest {
   /**
    * Whether voicemail is enabled.
    */
   enabled?: boolean;
 
+  /**
+   * Controls the greeting a caller hears before leaving a voicemail. Set `mode` to
+   * `default` to play the standard system greeting, or to `custom_greeting` to play
+   * your own audio. When `mode` is `custom_greeting`, `media_name` is required and
+   * must reference an audio file already uploaded to your account through the Media
+   * Storage API.
+   */
+  greeting?: VoicemailRequest.Greeting;
+
   /**
    * The pin used for voicemail
    */
   pin?: string;
 }
 
+export namespace VoicemailRequest {
+  /**
+   * Controls the greeting a caller hears before leaving a voicemail. Set `mode` to
+   * `default` to play the standard system greeting, or to `custom_greeting` to play
+   * your own audio. When `mode` is `custom_greeting`, `media_name` is required and
+   * must reference an audio file already uploaded to your account through the Media
+   * Storage API.
+   */
+  export interface Greeting {
+    /**
+     * The name of the media file to play as the greeting. Required when `mode` is
+     * `custom_greeting`; ignored when `mode` is `default`. The value must match the
+     * `media_name` of a file you previously uploaded with the Media Storage API
+     * (`POST /v2/media`).
+     */
+    media_name?: string | null;
+
+    /**
+     * The greeting mode. `default` plays the standard system greeting.
+     * `custom_greeting` plays the audio referenced by `media_name`.
+     */
+    mode?: 'default' | 'custom_greeting';
+  }
+}
+
 export interface VoicemailCreateResponse {
   data?: VoicemailPrefResponse;
 }
@@ -105,24 +179,92 @@ export interface VoicemailUpdateParams {
    */
   enabled?: boolean;
 
+  /**
+   * Controls the greeting a caller hears before leaving a voicemail. Set `mode` to
+   * `default` to play the standard system greeting, or to `custom_greeting` to play
+   * your own audio. When `mode` is `custom_greeting`, `media_name` is required and
+   * must reference an audio file already uploaded to your account through the Media
+   * Storage API.
+   */
+  greeting?: VoicemailUpdateParams.Greeting;
+
   /**
    * The pin used for voicemail
    */
   pin?: string;
 }
 
+export namespace VoicemailUpdateParams {
+  /**
+   * Controls the greeting a caller hears before leaving a voicemail. Set `mode` to
+   * `default` to play the standard system greeting, or to `custom_greeting` to play
+   * your own audio. When `mode` is `custom_greeting`, `media_name` is required and
+   * must reference an audio file already uploaded to your account through the Media
+   * Storage API.
+   */
+  export interface Greeting {
+    /**
+     * The name of the media file to play as the greeting. Required when `mode` is
+     * `custom_greeting`; ignored when `mode` is `default`. The value must match the
+     * `media_name` of a file you previously uploaded with the Media Storage API
+     * (`POST /v2/media`).
+     */
+    media_name?: string | null;
+
+    /**
+     * The greeting mode. `default` plays the standard system greeting.
+     * `custom_greeting` plays the audio referenced by `media_name`.
+     */
+    mode?: 'default' | 'custom_greeting';
+  }
+}
+
 export interface VoicemailCreateParams {
   /**
    * Whether voicemail is enabled.
    */
   enabled?: boolean;
 
+  /**
+   * Controls the greeting a caller hears before leaving a voicemail. Set `mode` to
+   * `default` to play the standard system greeting, or to `custom_greeting` to play
+   * your own audio. When `mode` is `custom_greeting`, `media_name` is required and
+   * must reference an audio file already uploaded to your account through the Media
+   * Storage API.
+   */
+  greeting?: VoicemailCreateParams.Greeting;
+
   /**
    * The pin used for voicemail
    */
   pin?: string;
 }
 
+export namespace VoicemailCreateParams {
+  /**
+   * Controls the greeting a caller hears before leaving a voicemail. Set `mode` to
+   * `default` to play the standard system greeting, or to `custom_greeting` to play
+   * your own audio. When `mode` is `custom_greeting`, `media_name` is required and
+   * must reference an audio file already uploaded to your account through the Media
+   * Storage API.
+   */
+  export interface Greeting {
+    /**
+     * The name of the media file to play as the greeting. Required when `mode` is
+     * `custom_greeting`; ignored when `mode` is `default`. The value must match the
+     * `media_name` of a file you previously uploaded with the Media Storage API
+     * (`POST /v2/media`).
+     */
+    media_name?: string | null;
+
+    /**
+     * The greeting mode. `default` plays the standard system greeting.
+     * `custom_greeting` plays the audio referenced by `media_name`.
+     */
+    mode?: 'default' | 'custom_greeting';
+  }
+}
+
 export declare namespace Voicemail {
   export {
     type VoicemailPrefResponse as VoicemailPrefResponse,

package/src/resources/private-wireless-gateways.ts

@@ -141,7 +141,7 @@ export interface PrivateWirelessGateway {
 export interface PrivateWirelessGatewayStatus {
   /**
    * This attribute is an
-   * [error code](https://developers.telnyx.com/development/api-fundamentals/api-errors)
+   * [error code](https://developers.telnyx.com/docs/development/api-fundamentals/api-errors)
    * related to the failure reason.
    */
   error_code?: string | null;

package/src/resources/sim-cards/actions.ts

@@ -244,6 +244,50 @@ export class Actions extends APIResource {
   ): APIPromise<ActionBulkEnableVoiceResponse> {
     return this._client.post('/sim_cards/actions/bulk_enable_voice', { body, ...options });
   }
+
+  /**
+   * This API disables voice calling on a SIM card. The SIM card will no longer be
+   * able to make or receive calls.<br/> The API will trigger an asynchronous
+   * operation called a SIM Card Action. The status of the SIM Card Action can be
+   * followed through the
+   * [List SIM Card Action](https://developers.telnyx.com/api-reference/sim-card-actions/list-sim-card-actions)
+   * API.
+   *
+   * @example
+   * ```ts
+   * const response = await client.simCards.actions.disableVoice(
+   *   '6a09cdc3-8948-47f0-aa62-74ac943d6c58',
+   * );
+   * ```
+   */
+  disableVoice(id: string, options?: RequestOptions): APIPromise<ActionDisableVoiceResponse> {
+    return this._client.post(path`/sim_cards/${id}/actions/disable_voice`, options);
+  }
+
+  /**
+   * This API enables voice calling on a SIM card. When a <code>connection_id</code>
+   * is provided, the SIM is associated with the specified Mobile Voice Connection.
+   * The connection must be owned by the same user and of type
+   * <code>mobile_voice</code>.<br/> The API will trigger an asynchronous operation
+   * called a SIM Card Action. The status of the SIM Card Action can be followed
+   * through the
+   * [List SIM Card Action](https://developers.telnyx.com/api-reference/sim-card-actions/list-sim-card-actions)
+   * API.
+   *
+   * @example
+   * ```ts
+   * const response = await client.simCards.actions.enableVoice(
+   *   '6a09cdc3-8948-47f0-aa62-74ac943d6c58',
+   * );
+   * ```
+   */
+  enableVoice(
+    id: string,
+    body: ActionEnableVoiceParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<ActionEnableVoiceResponse> {
+    return this._client.post(path`/sim_cards/${id}/actions/enable_voice`, { body, ...options });
+  }
 }
 
 export type WirelessSimCardActionsDefaultFlatPagination = DefaultFlatPagination<WirelessSimCardAction>;
@@ -369,9 +413,17 @@ export interface WirelessSimCardAction {
    *  <li><code>enable_standby_sim_card</code> - move a SIM card previously on the <code>standby</code> status to the <code>enabled</code> status after it consumes data.</li>
    *  <li><code>disable</code> - move the SIM card to the <code>disabled</code> status</li>
    *  <li><code>set_standby</code> - move the SIM card to the <code>standby</code> status</li>
+   *  <li><code>enable_voice</code> - enable voice calling on the SIM card</li>
+   *  <li><code>disable_voice</code> - disable voice calling on the SIM card</li>
    *  </ul>
    */
-  action_type?: 'enable' | 'enable_standby_sim_card' | 'disable' | 'set_standby';
+  action_type?:
+    | 'enable'
+    | 'enable_standby_sim_card'
+    | 'disable'
+    | 'set_standby'
+    | 'enable_voice'
+    | 'disable_voice';
 
   /**
    * ISO 8601 formatted date-time indicating when the resource was created.
@@ -455,6 +507,14 @@ export interface ActionDisableResponse {
   data?: WirelessSimCardAction;
 }
 
+export interface ActionDisableVoiceResponse {
+  /**
+   * This object represents a SIM card action. It allows tracking the current status
+   * of an operation that impacts the SIM card.
+   */
+  data?: WirelessSimCardAction;
+}
+
 export interface ActionEnableResponse {
   /**
    * This object represents a SIM card action. It allows tracking the current status
@@ -463,6 +523,14 @@ export interface ActionEnableResponse {
   data?: WirelessSimCardAction;
 }
 
+export interface ActionEnableVoiceResponse {
+  /**
+   * This object represents a SIM card action. It allows tracking the current status
+   * of an operation that impacts the SIM card.
+   */
+  data?: WirelessSimCardAction;
+}
+
 export interface ActionRemovePublicIPResponse {
   /**
    * This object represents a SIM card action. It allows tracking the current status
@@ -537,7 +605,9 @@ export namespace ActionListParams {
       | 'disable'
       | 'set_standby'
       | 'remove_public_ip'
-      | 'set_public_ip';
+      | 'set_public_ip'
+      | 'enable_voice'
+      | 'disable_voice';
 
     /**
      * Filter by a bulk SIM card action ID.
@@ -578,6 +648,24 @@ export interface ActionBulkDisableVoiceParams {
 
 export interface ActionBulkEnableVoiceParams {
   sim_card_group_id: string;
+
+  /**
+   * The identifier of the Mobile Voice Connection to associate with the SIM cards.
+   * The connection must be owned by the same user and of type
+   * <code>mobile_voice</code>. If omitted, voice is enabled without a connection
+   * association.
+   */
+  connection_id?: string;
+}
+
+export interface ActionEnableVoiceParams {
+  /**
+   * The identifier of the Mobile Voice Connection to associate with this SIM card.
+   * The connection must be owned by the same user and of type
+   * <code>mobile_voice</code>. If omitted, voice is enabled without a connection
+   * association.
+   */
+  connection_id?: string;
 }
 
 export declare namespace Actions {
@@ -590,7 +678,9 @@ export declare namespace Actions {
     type ActionBulkEnableVoiceResponse as ActionBulkEnableVoiceResponse,
     type ActionBulkSetPublicIPsResponse as ActionBulkSetPublicIPsResponse,
     type ActionDisableResponse as ActionDisableResponse,
+    type ActionDisableVoiceResponse as ActionDisableVoiceResponse,
     type ActionEnableResponse as ActionEnableResponse,
+    type ActionEnableVoiceResponse as ActionEnableVoiceResponse,
     type ActionRemovePublicIPResponse as ActionRemovePublicIPResponse,
     type ActionSetPublicIPResponse as ActionSetPublicIPResponse,
     type ActionSetStandbyResponse as ActionSetStandbyResponse,
@@ -602,5 +692,6 @@ export declare namespace Actions {
     type ActionSetPublicIPParams as ActionSetPublicIPParams,
     type ActionBulkDisableVoiceParams as ActionBulkDisableVoiceParams,
     type ActionBulkEnableVoiceParams as ActionBulkEnableVoiceParams,
+    type ActionEnableVoiceParams as ActionEnableVoiceParams,
   };
 }

package/src/resources/sim-cards/index.ts

@@ -10,7 +10,9 @@ export {
   type ActionBulkEnableVoiceResponse,
   type ActionBulkSetPublicIPsResponse,
   type ActionDisableResponse,
+  type ActionDisableVoiceResponse,
   type ActionEnableResponse,
+  type ActionEnableVoiceResponse,
   type ActionRemovePublicIPResponse,
   type ActionSetPublicIPResponse,
   type ActionSetStandbyResponse,
@@ -21,6 +23,7 @@ export {
   type ActionSetPublicIPParams,
   type ActionBulkDisableVoiceParams,
   type ActionBulkEnableVoiceParams,
+  type ActionEnableVoiceParams,
   type WirelessSimCardActionsDefaultFlatPagination,
 } from './actions';
 export {

package/src/resources/sim-cards/sim-cards.ts

@@ -12,7 +12,10 @@ import {
   ActionBulkSetPublicIPsParams,
   ActionBulkSetPublicIPsResponse,
   ActionDisableResponse,
+  ActionDisableVoiceResponse,
   ActionEnableResponse,
+  ActionEnableVoiceParams,
+  ActionEnableVoiceResponse,
   ActionListParams,
   ActionRemovePublicIPResponse,
   ActionRetrieveResponse,
@@ -778,7 +781,9 @@ export declare namespace SimCards {
     type ActionBulkEnableVoiceResponse as ActionBulkEnableVoiceResponse,
     type ActionBulkSetPublicIPsResponse as ActionBulkSetPublicIPsResponse,
     type ActionDisableResponse as ActionDisableResponse,
+    type ActionDisableVoiceResponse as ActionDisableVoiceResponse,
     type ActionEnableResponse as ActionEnableResponse,
+    type ActionEnableVoiceResponse as ActionEnableVoiceResponse,
     type ActionRemovePublicIPResponse as ActionRemovePublicIPResponse,
     type ActionSetPublicIPResponse as ActionSetPublicIPResponse,
     type ActionSetStandbyResponse as ActionSetStandbyResponse,
@@ -790,6 +795,7 @@ export declare namespace SimCards {
     type ActionSetPublicIPParams as ActionSetPublicIPParams,
     type ActionBulkDisableVoiceParams as ActionBulkDisableVoiceParams,
     type ActionBulkEnableVoiceParams as ActionBulkEnableVoiceParams,
+    type ActionEnableVoiceParams as ActionEnableVoiceParams,
   };
 }
 

package/src/resources/storage/index.ts

@@ -17,6 +17,7 @@ export {
 } from './cloudfs/index';
 export {
   Kvs,
+  type EdgeComputePaginationMeta,
   type KvNamespace,
   type KvNamespaceResponseWrapper,
   type KvListParams,
@@ -40,4 +41,13 @@ export {
   type MigrationListResponse,
   type MigrationCreateParams,
 } from './migrations/index';
+export {
+  Sqldbs,
+  type SqlDatabase,
+  type SqlDatabaseResponseWrapper,
+  type SqldbListParams,
+  type SqldbCreateParams,
+  type SqldbDeleteParams,
+  type SqlDatabasesDefaultFlatPagination,
+} from './sqldbs/index';
 export { Storage, type StorageListMigrationSourceCoverageResponse } from './storage';

package/src/resources/storage/kvs/index.ts

@@ -11,6 +11,7 @@ export {
 } from './keys';
 export {
   Kvs,
+  type EdgeComputePaginationMeta,
   type KvNamespace,
   type KvNamespaceResponseWrapper,
   type KvListParams,

package/src/resources/storage/kvs/kvs.ts

@@ -95,6 +95,16 @@ export class Kvs extends APIResource {
 
 export type KvNamespacesDefaultFlatPagination = DefaultFlatPagination<KvNamespace>;
 
+export interface EdgeComputePaginationMeta {
+  page_number?: number;
+
+  page_size?: number;
+
+  total_pages?: number;
+
+  total_results?: number;
+}
+
 export interface KvNamespace {
   id?: string;
 
@@ -130,6 +140,7 @@ Kvs.Keys = Keys;
 
 export declare namespace Kvs {
   export {
+    type EdgeComputePaginationMeta as EdgeComputePaginationMeta,
     type KvNamespace as KvNamespace,
     type KvNamespaceResponseWrapper as KvNamespaceResponseWrapper,
     type KvNamespacesDefaultFlatPagination as KvNamespacesDefaultFlatPagination,

package/src/resources/storage/sqldbs/actions.ts

@@ -0,0 +1,101 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import { APIPromise } from '../../../core/api-promise';
+import { RequestOptions } from '../../../internal/request-options';
+import { path } from '../../../internal/utils/path';
+
+/**
+ * Manage SQL databases and run SQL against them
+ */
+export class Actions extends APIResource {
+  /**
+   * Runs SQL against the database and returns the resulting rows — empty for
+   * statements that return none, such as DDL. Bind positional `?` placeholders with
+   * `params` rather than interpolating values into the SQL string.
+   *
+   * @example
+   * ```ts
+   * const response = await client.storage.sqldbs.actions.query(
+   *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+   *   { sql: 'SELECT * FROM users WHERE name = ?' },
+   * );
+   * ```
+   */
+  query(id: string, body: ActionQueryParams, options?: RequestOptions): APIPromise<ActionQueryResponse> {
+    return this._client.post(path`/storage/sqldbs/${id}/actions/query`, { body, ...options });
+  }
+}
+
+export interface ActionQueryResponse {
+  data?: ActionQueryResponse.Data;
+}
+
+export namespace ActionQueryResponse {
+  export interface Data {
+    /**
+     * Number of rows returned.
+     */
+    count?: number;
+
+    /**
+     * Wall-clock duration of the request, in milliseconds.
+     */
+    duration?: number;
+
+    meta?: Data.Meta;
+
+    /**
+     * The result rows, each a map of column name to value. Empty for statements that
+     * return no rows.
+     */
+    results?: Array<{ [key: string]: unknown }>;
+
+    success?: boolean;
+  }
+
+  export namespace Data {
+    export interface Meta {
+      /**
+       * Number of rows added, changed, or removed by the statement.
+       */
+      changes?: number;
+
+      /**
+       * Wall-clock duration of the statement, in milliseconds.
+       */
+      duration?: number;
+
+      /**
+       * Rowid of the last inserted row, when applicable.
+       */
+      last_row_id?: number;
+
+      rows_read?: number;
+
+      rows_written?: number;
+    }
+  }
+}
+
+export interface ActionQueryParams {
+  /**
+   * The SQL to run. Use positional `?` placeholders and supply the values in
+   * `params` rather than interpolating them into this string.
+   */
+  sql: string;
+
+  /**
+   * Positional bind parameters, in placeholder order. Each value is a string, a
+   * number, a boolean, or null; booleans are cast to `1`/`0`. The count must match
+   * the number of `?` placeholders exactly — a mismatch is rejected with 422 rather
+   * than binding null for the ones you left out. (Not enforced for multi-statement
+   * scripts or named parameters, where the placeholder count is not the number
+   * bound.)
+   */
+  params?: Array<string | number | boolean | null>;
+}
+
+export declare namespace Actions {
+  export { type ActionQueryResponse as ActionQueryResponse, type ActionQueryParams as ActionQueryParams };
+}

package/src/resources/storage/sqldbs/index.ts

@@ -0,0 +1,12 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { Actions, type ActionQueryResponse, type ActionQueryParams } from './actions';
+export {
+  Sqldbs,
+  type SqlDatabase,
+  type SqlDatabaseResponseWrapper,
+  type SqldbListParams,
+  type SqldbCreateParams,
+  type SqldbDeleteParams,
+  type SqlDatabasesDefaultFlatPagination,
+} from './sqldbs';