telnyx 7.16.0 → 7.18.0

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

@@ -130,6 +130,15 @@ export interface ChatCreateCompletionParams {
    */
   presence_penalty?: number;
 
+  /**
+   * Controls the reasoning effort for models that support it. When set, the model
+   * spends more or less compute on internal reasoning before generating its
+   * response. Supported values: none, minimal, low, medium, high, xhigh, max. Not
+   * all models support all values; unsupported values are rejected with a 400 error.
+   * When omitted, reasoning models use their default effort level.
+   */
+  reasoning_effort?: 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max';
+
   /**
    * Use this is you want to guarantee a JSON output without defining a schema. For
    * control over the schema, use `guided_json`.

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

@@ -127,6 +127,8 @@ export interface OpenAICreateResponseParams {
    */
   model?: string;
 
+  reasoning?: OpenAICreateResponseParams.Reasoning;
+
   /**
    * The service tier to use for this request. Supported values vary by model; use
    * `GET /v2/ai/openai/models` and inspect the model's `service_tiers` field. If
@@ -143,6 +145,16 @@ export interface OpenAICreateResponseParams {
   [k: string]: unknown;
 }
 
+export namespace OpenAICreateResponseParams {
+  export interface Reasoning {
+    /**
+     * Controls the reasoning effort for models that support it. Same values and
+     * semantics as reasoning_effort on Chat Completions.
+     */
+    effort?: 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max';
+  }
+}
+
 OpenAI.Embeddings = Embeddings;
 OpenAI.Chat = Chat;
 

package/src/resources/ai/tools.ts

@@ -3,6 +3,7 @@
 import { APIResource } from '../../core/resource';
 import { APIPromise } from '../../core/api-promise';
 import { DefaultFlatPagination, type DefaultFlatPaginationParams, PagePromise } from '../../core/pagination';
+import { buildHeaders } from '../../internal/headers';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
@@ -42,12 +43,20 @@ export class Tools extends APIResource {
    * });
    * ```
    */
-  create(body: ToolCreateParams, options?: RequestOptions): APIPromise<SharedToolResponse> {
-    return this._client.post('/ai/tools', { body, ...options });
+  create(params: ToolCreateParams, options?: RequestOptions): APIPromise<SharedToolResponse> {
+    const { 'Idempotency-Key': idempotencyKey, ...body } = params;
+    return this._client.post('/ai/tools', {
+      body,
+      ...options,
+      headers: buildHeaders([
+        { ...(idempotencyKey != null ? { 'Idempotency-Key': idempotencyKey } : undefined) },
+        options?.headers,
+      ]),
+    });
   }
 
   /**
-   * Delete a custom AI tool.
+   * Permanently deletes the specified custom AI tool from your account.
    *
    * @example
    * ```ts
@@ -187,31 +196,73 @@ export interface ToolListParams extends DefaultFlatPaginationParams {
 }
 
 export interface ToolCreateParams {
+  /**
+   * Body param
+   */
   display_name: string;
 
+  /**
+   * Body param
+   */
   type: string;
 
+  /**
+   * Body param
+   */
   client_side_tool?: { [key: string]: unknown };
 
+  /**
+   * Body param
+   */
   function?: { [key: string]: unknown };
 
+  /**
+   * Body param
+   */
   handoff?: { [key: string]: unknown };
 
+  /**
+   * Body param
+   */
   invite?: { [key: string]: unknown };
 
+  /**
+   * Body param
+   */
   pay?: PayToolParams;
 
+  /**
+   * Body param
+   */
   retrieval?: { [key: string]: unknown };
 
+  /**
+   * Body param
+   */
   timeout_ms?: number;
 
   /**
-   * Configuration for an update_dynamic_variables tool.
+   * Body param: Configuration for an update_dynamic_variables tool.
    */
   update_dynamic_variables?: UpdateDynamicVariablesToolParams;
 
+  /**
+   * Body param
+   */
   webhook?: { [key: string]: unknown };
 
+  /**
+   * Header param: Optional opaque, unquoted key for safely retrying the same logical
+   * request. Keys must contain 1 to 255 letters, numbers, hyphens, or underscores.
+   * Generate a unique UUID v4 for each operation and reuse it only when retrying
+   * that operation with the same request. Invalid headers—including duplicate,
+   * empty, malformed, or overlong values—return 400 with error code 10015. A request
+   * already in progress with the same key returns 409; reusing the key with a
+   * different request returns 422. Only successful responses are replayed, for up to
+   * 24 hours. Do not include sensitive data in the key.
+   */
+  'Idempotency-Key'?: string;
+
   [k: string]: unknown;
 }
 

package/src/resources/authentication-providers.ts

@@ -30,7 +30,8 @@ export class AuthenticationProviders extends APIResource {
   }
 
   /**
-   * Creates an authentication provider.
+   * Creates a new authentication provider for single sign-on, configured from the
+   * provided identity provider details, and returns the created resource.
    *
    * @example
    * ```ts

package/src/resources/bundle-pricing/billing-bundles.ts

@@ -9,7 +9,8 @@ import { path } from '../../internal/utils/path';
 
 export class BillingBundles extends APIResource {
   /**
-   * Get all allowed bundles.
+   * Returns a paginated list of the billing bundles available to your account, with
+   * support for filtering.
    *
    * @example
    * ```ts
@@ -39,7 +40,8 @@ export class BillingBundles extends APIResource {
   }
 
   /**
-   * Get a single bundle by ID.
+   * Returns the details of a single billing bundle by its ID, so you can inspect its
+   * contents before purchasing a user bundle.
    *
    * @example
    * ```ts

package/src/resources/bundle-pricing/user-bundles.ts

@@ -10,7 +10,8 @@ import { path } from '../../internal/utils/path';
 
 export class UserBundles extends APIResource {
   /**
-   * Get a paginated list of user bundles.
+   * Returns a paginated list of the bundles active on your account, with support for
+   * filtering.
    *
    * @example
    * ```ts
@@ -81,7 +82,8 @@ export class UserBundles extends APIResource {
   }
 
   /**
-   * Deactivates a user bundle by its ID.
+   * Deactivates the specified user bundle on your account and returns the
+   * deactivated bundle.
    *
    * @example
    * ```ts
@@ -107,7 +109,7 @@ export class UserBundles extends APIResource {
   }
 
   /**
-   * Retrieves a user bundle by its ID.
+   * Returns the details of a single user bundle on your account by its ID.
    *
    * @example
    * ```ts

package/src/resources/call-control-applications.ts

@@ -33,7 +33,8 @@ export class CallControlApplications extends APIResource {
   }
 
   /**
-   * Create a call control application.
+   * Creates a call control application, which defines the webhook endpoints and
+   * settings used to control calls on associated connections.
    *
    * @example
    * ```ts
@@ -52,7 +53,8 @@ export class CallControlApplications extends APIResource {
   }
 
   /**
-   * Deletes a call control application.
+   * Permanently deletes the specified call control application and its webhook
+   * configuration.
    *
    * @example
    * ```ts