nixflex 0.3.0 → 0.3.1

package/CHANGELOG.md

@@ -1,3 +1,8 @@
+## 0.3.1 (2026-08-24)
+
+- Voicemail as a structured setting: `voicemail_leave_enabled` + `voicemail_message` on Agent (applies to dashboard-imported numbers) and on PhoneNumber / PhoneNumberUpdateParams (the only voicemail control for API-imported numbers - no inheritance across the two worlds)
+- Enabling without a message is rejected with `voicemail_message_required`
+- No breaking changes.
 ## 0.3.0 (2026-08-23)
 
 - Call type: `charged_minutes` (minutes actually billed - transfers stop the meter at handoff, so this can be less than the recording length)

package/dist/index.d.cts

@@ -66,6 +66,12 @@ interface AgentCreateParams {
     amd_enabled?: boolean;
     /** Keypad digits instead of speech. Three-state: true/false explicit, null = not set (a number's own setting decides). */
     dtmf_enabled?: boolean | null;
+    /** Leave a message on detected voicemails. Applies to DASHBOARD-imported numbers on
+     * this agent; API-imported numbers use their own per-number setting instead. Enabling
+     * without voicemail_message is rejected with voicemail_message_required. */
+    voicemail_leave_enabled?: boolean;
+    /** Spoken word for word on voicemail when enabled - the agent never rewrites it. */
+    voicemail_message?: string | null;
     /** Where to POST post-call data. */
     webhook_url?: string | null;
     /** Agent can end the call cleanly. Default true. */
@@ -124,6 +130,8 @@ interface Agent {
     fallback_message: string;
     post_call_sms_enabled?: boolean;
     post_call_sms_template?: string | null;
+    voicemail_leave_enabled?: boolean;
+    voicemail_message?: string | null;
     data_extraction_fields?: unknown[];
     is_active: boolean;
     created_at: string;
@@ -385,6 +393,12 @@ interface PhoneNumber {
     custom_prompt?: string | null;
     voice_id?: string | null;
     sms_reply_enabled?: boolean;
+    /** This number's own voicemail setting - the ONLY one that applies to API-imported
+     * numbers (dashboard-imported numbers follow the agent). null = not set = silent
+     * hangup on voicemail. */
+    voicemail_leave_enabled?: boolean | null;
+    /** Spoken word for word on a detected voicemail when enabled. */
+    voicemail_message?: string | null;
     sms_prompt?: string | null;
     web_prompt?: string | null;
     speaking_rate?: number | null;
@@ -401,6 +415,12 @@ interface PhoneNumberUpdateParams {
     voice_id?: string | null;
     /** SMS agent auto-reply on/off. Default false. */
     sms_reply_enabled?: boolean;
+    /** This number's own voicemail toggle - the only voicemail control for API-imported
+     * numbers. Enabling without a message (here or already saved) is rejected with
+     * voicemail_message_required. null clears. */
+    voicemail_leave_enabled?: boolean | null;
+    /** Spoken word for word on voicemail. Max 2000. null clears. */
+    voicemail_message?: string | null;
     /** SMS agent instructions (independent channel). Max 20000. null clears. */
     sms_prompt?: string | null;
     /** Web agent instructions (independent channel). Max 20000. null clears. */

package/dist/index.d.ts

@@ -66,6 +66,12 @@ interface AgentCreateParams {
     amd_enabled?: boolean;
     /** Keypad digits instead of speech. Three-state: true/false explicit, null = not set (a number's own setting decides). */
     dtmf_enabled?: boolean | null;
+    /** Leave a message on detected voicemails. Applies to DASHBOARD-imported numbers on
+     * this agent; API-imported numbers use their own per-number setting instead. Enabling
+     * without voicemail_message is rejected with voicemail_message_required. */
+    voicemail_leave_enabled?: boolean;
+    /** Spoken word for word on voicemail when enabled - the agent never rewrites it. */
+    voicemail_message?: string | null;
     /** Where to POST post-call data. */
     webhook_url?: string | null;
     /** Agent can end the call cleanly. Default true. */
@@ -124,6 +130,8 @@ interface Agent {
     fallback_message: string;
     post_call_sms_enabled?: boolean;
     post_call_sms_template?: string | null;
+    voicemail_leave_enabled?: boolean;
+    voicemail_message?: string | null;
     data_extraction_fields?: unknown[];
     is_active: boolean;
     created_at: string;
@@ -385,6 +393,12 @@ interface PhoneNumber {
     custom_prompt?: string | null;
     voice_id?: string | null;
     sms_reply_enabled?: boolean;
+    /** This number's own voicemail setting - the ONLY one that applies to API-imported
+     * numbers (dashboard-imported numbers follow the agent). null = not set = silent
+     * hangup on voicemail. */
+    voicemail_leave_enabled?: boolean | null;
+    /** Spoken word for word on a detected voicemail when enabled. */
+    voicemail_message?: string | null;
     sms_prompt?: string | null;
     web_prompt?: string | null;
     speaking_rate?: number | null;
@@ -401,6 +415,12 @@ interface PhoneNumberUpdateParams {
     voice_id?: string | null;
     /** SMS agent auto-reply on/off. Default false. */
     sms_reply_enabled?: boolean;
+    /** This number's own voicemail toggle - the only voicemail control for API-imported
+     * numbers. Enabling without a message (here or already saved) is rejected with
+     * voicemail_message_required. null clears. */
+    voicemail_leave_enabled?: boolean | null;
+    /** Spoken word for word on voicemail. Max 2000. null clears. */
+    voicemail_message?: string | null;
     /** SMS agent instructions (independent channel). Max 20000. null clears. */
     sms_prompt?: string | null;
     /** Web agent instructions (independent channel). Max 20000. null clears. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nixflex",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Official Node.js SDK for the Nixflex voice AI platform - AI phone agents, outbound campaigns, and SMS.",
   "keywords": [
     "nixflex",