OneSignal · onesignal-deploy · Jun 17, 2026
diff --git a/DefaultApi.md b/DefaultApi.md
diff --git a/apis/exception.ts b/apis/exception.ts
@@ -21,4 +21,58 @@ export class ApiException<T> extends Error {
         // Reference: https://github.com/microsoft/TypeScript-wiki/blob/main/Breaking-Changes.md#extending-built-ins-like-error-array-and-map-may-no-longer-work
         Object.setPrototypeOf(this, ApiException.prototype);
     }
+
+    /**
+     * The error messages carried by the response body, normalized to a flat
+     * string array regardless of which envelope shape the API returned
+     * (`{ errors: "..." }`, `{ errors: ["..."] }`, `{ errors: [{ code, title }] }`,
+     * or an object map such as `{ errors: { invalid_aliases: {...} } }`, which is
+     * surfaced as `"<key>: <value>"` entries). Returns an empty array when the
+     * body is not a recognizable error envelope. The raw body remains on `body`.
+     */
+    public get errorMessages(): string[] {
+        let parsed: any = this.body;
+        if (typeof parsed === "string") {
+            try {
+                parsed = JSON.parse(parsed);
+            } catch {
+                return [];
+            }
+        }
+        if (parsed === null || typeof parsed !== "object") {
+            return [];
+        }
+        const errors: any = parsed.errors;
+        if (typeof errors === "string") {
+            return [errors];
+        }
+        if (Array.isArray(errors)) {
+            return errors
+                .map((e: any) => {
+                    if (typeof e === "string") {
+                        return e;
+                    }
+                    if (e !== null && typeof e === "object") {
+                        const title = typeof e.title === "string" ? e.title : undefined;
+                        const code = typeof e.code === "string" ? e.code : (e.code != null ? String(e.code) : undefined);
+                        return title || code;
+                    }
+                    return undefined;
+                })
+                .filter((m: any): m is string => typeof m === "string");
+        }
+        if (errors !== null && typeof errors === "object") {
+            // Object-shaped envelopes (e.g. { invalid_aliases: {...} }) carry data
+            // under arbitrary keys; surface each so it isn't silently dropped. Key
+            // order is unspecified, so sort for deterministic output.
+            return Object.keys(errors)
+                .map((key: string) => {
+                    const value: any = errors[key];
+                    const rendered = typeof value === "string" ? value : JSON.stringify(value);
+                    return key + ": " + rendered;
+                })
+                .sort();
+        }
+        return [];
+    }
 }
diff --git a/dist/apis/exception.d.ts b/dist/apis/exception.d.ts
@@ -7,4 +7,5 @@ export declare class ApiException<T> extends Error {
     constructor(code: number, message: string, body: T, headers: {
         [key: string]: string;
     });
+    get errorMessages(): string[];
 }
diff --git a/dist/apis/exception.js b/dist/apis/exception.js
diff --git a/dist/apis/exception.js.map b/dist/apis/exception.js.map
diff --git a/models/ApiKeyToken.ts b/models/ApiKeyToken.ts
@@ -2,7 +2,7 @@
  * OneSignal
  * A powerful way to send personalized messages at scale and build effective customer engagement strategies. Learn more at onesignal.com
  *
- * API Version: 5.6.0
+ * API Version: 5.7.0
  * Contact: devrel@onesignal.com
  */
 

diff --git a/models/ApiKeyTokensListResponse.ts b/models/ApiKeyTokensListResponse.ts
@@ -2,7 +2,7 @@
  * OneSignal
  * A powerful way to send personalized messages at scale and build effective customer engagement strategies. Learn more at onesignal.com
  *
- * API Version: 5.6.0
+ * API Version: 5.7.0
  * Contact: devrel@onesignal.com
  */
 

diff --git a/models/App.ts b/models/App.ts
@@ -2,7 +2,7 @@
  * OneSignal
  * A powerful way to send personalized messages at scale and build effective customer engagement strategies. Learn more at onesignal.com
  *
- * API Version: 5.6.0
+ * API Version: 5.7.0
  * Contact: devrel@onesignal.com
  */
 

diff --git a/models/BasicNotification.ts b/models/BasicNotification.ts
@@ -2,7 +2,7 @@
  * OneSignal
  * A powerful way to send personalized messages at scale and build effective customer engagement strategies. Learn more at onesignal.com
  *
- * API Version: 5.6.0
+ * API Version: 5.7.0
  * Contact: devrel@onesignal.com
  */
 

diff --git a/models/BasicNotificationAllOf.ts b/models/BasicNotificationAllOf.ts
@@ -2,7 +2,7 @@
  * OneSignal
  * A powerful way to send personalized messages at scale and build effective customer engagement strategies. Learn more at onesignal.com
  *
- * API Version: 5.6.0
+ * API Version: 5.7.0
  * Contact: devrel@onesignal.com
  */
 

diff --git a/models/BasicNotificationAllOfAndroidBackgroundLayout.ts b/models/BasicNotificationAllOfAndroidBackgroundLayout.ts
@@ -2,7 +2,7 @@
  * OneSignal
  * A powerful way to send personalized messages at scale and build effective customer engagement strategies. Learn more at onesignal.com
  *
- * API Version: 5.6.0
+ * API Version: 5.7.0
  * Contact: devrel@onesignal.com
  */
 

diff --git a/models/Button.ts b/models/Button.ts
@@ -2,7 +2,7 @@
  * OneSignal
  * A powerful way to send personalized messages at scale and build effective customer engagement strategies. Learn more at onesignal.com
  *
- * API Version: 5.6.0
+ * API Version: 5.7.0
  * Contact: devrel@onesignal.com
  */
 

diff --git a/models/CopyTemplateRequest.ts b/models/CopyTemplateRequest.ts
@@ -2,7 +2,7 @@
  * OneSignal
  * A powerful way to send personalized messages at scale and build effective customer engagement strategies. Learn more at onesignal.com
  *
- * API Version: 5.6.0
+ * API Version: 5.7.0
  * Contact: devrel@onesignal.com
  */
 

diff --git a/models/CreateApiKeyRequest.ts b/models/CreateApiKeyRequest.ts
@@ -2,7 +2,7 @@
  * OneSignal
  * A powerful way to send personalized messages at scale and build effective customer engagement strategies. Learn more at onesignal.com
  *
- * API Version: 5.6.0
+ * API Version: 5.7.0
  * Contact: devrel@onesignal.com
  */
 

diff --git a/models/CreateApiKeyResponse.ts b/models/CreateApiKeyResponse.ts
@@ -2,7 +2,7 @@
  * OneSignal
  * A powerful way to send personalized messages at scale and build effective customer engagement strategies. Learn more at onesignal.com
  *
- * API Version: 5.6.0
+ * API Version: 5.7.0
  * Contact: devrel@onesignal.com
  */
 

diff --git a/models/CreateNotificationSuccessResponse.ts b/models/CreateNotificationSuccessResponse.ts
@@ -2,7 +2,7 @@
  * OneSignal
  * A powerful way to send personalized messages at scale and build effective customer engagement strategies. Learn more at onesignal.com
  *
- * API Version: 5.6.0
+ * API Version: 5.7.0
  * Contact: devrel@onesignal.com
  */
 

diff --git a/models/CreateSegmentConflictResponse.ts b/models/CreateSegmentConflictResponse.ts
@@ -2,7 +2,7 @@
  * OneSignal
  * A powerful way to send personalized messages at scale and build effective customer engagement strategies. Learn more at onesignal.com
  *
- * API Version: 5.6.0
+ * API Version: 5.7.0
  * Contact: devrel@onesignal.com
  */
 

diff --git a/models/CreateSegmentSuccessResponse.ts b/models/CreateSegmentSuccessResponse.ts
@@ -2,7 +2,7 @@
  * OneSignal
  * A powerful way to send personalized messages at scale and build effective customer engagement strategies. Learn more at onesignal.com
  *
- * API Version: 5.6.0
+ * API Version: 5.7.0
  * Contact: devrel@onesignal.com
  */
 

diff --git a/models/CreateTemplateRequest.ts b/models/CreateTemplateRequest.ts
@@ -2,7 +2,7 @@
  * OneSignal
  * A powerful way to send personalized messages at scale and build effective customer engagement strategies. Learn more at onesignal.com
  *
- * API Version: 5.6.0
+ * API Version: 5.7.0
  * Contact: devrel@onesignal.com
  */
 

diff --git a/models/CreateUserConflictResponse.ts b/models/CreateUserConflictResponse.ts
@@ -2,7 +2,7 @@
  * OneSignal
  * A powerful way to send personalized messages at scale and build effective customer engagement strategies. Learn more at onesignal.com
  *
- * API Version: 5.6.0
+ * API Version: 5.7.0
  * Contact: devrel@onesignal.com
  */
 

diff --git a/models/CreateUserConflictResponseErrorsInner.ts b/models/CreateUserConflictResponseErrorsInner.ts
@@ -2,7 +2,7 @@
  * OneSignal
  * A powerful way to send personalized messages at scale and build effective customer engagement strategies. Learn more at onesignal.com
  *
- * API Version: 5.6.0
+ * API Version: 5.7.0
  * Contact: devrel@onesignal.com
  */
 

diff --git a/models/CreateUserConflictResponseErrorsItemsMeta.ts b/models/CreateUserConflictResponseErrorsItemsMeta.ts
@@ -2,7 +2,7 @@
  * OneSignal
  * A powerful way to send personalized messages at scale and build effective customer engagement strategies. Learn more at onesignal.com
  *
- * API Version: 5.6.0
+ * API Version: 5.7.0
  * Contact: devrel@onesignal.com
  */
 

diff --git a/models/CustomEvent.ts b/models/CustomEvent.ts
@@ -2,7 +2,7 @@
  * OneSignal
  * A powerful way to send personalized messages at scale and build effective customer engagement strategies. Learn more at onesignal.com
  *
- * API Version: 5.6.0
+ * API Version: 5.7.0
  * Contact: devrel@onesignal.com
  */
 

diff --git a/models/CustomEventsRequest.ts b/models/CustomEventsRequest.ts
@@ -2,7 +2,7 @@
  * OneSignal
  * A powerful way to send personalized messages at scale and build effective customer engagement strategies. Learn more at onesignal.com
  *
- * API Version: 5.6.0
+ * API Version: 5.7.0
  * Contact: devrel@onesignal.com
  */
 

diff --git a/models/DeliveryData.ts b/models/DeliveryData.ts
@@ -2,7 +2,7 @@
  * OneSignal
  * A powerful way to send personalized messages at scale and build effective customer engagement strategies. Learn more at onesignal.com
  *
- * API Version: 5.6.0
+ * API Version: 5.7.0
  * Contact: devrel@onesignal.com
  */
 

diff --git a/models/ExportEventsSuccessResponse.ts b/models/ExportEventsSuccessResponse.ts
@@ -2,7 +2,7 @@
  * OneSignal
  * A powerful way to send personalized messages at scale and build effective customer engagement strategies. Learn more at onesignal.com
  *
- * API Version: 5.6.0
+ * API Version: 5.7.0
  * Contact: devrel@onesignal.com
  */
 

diff --git a/models/ExportSubscriptionsRequestBody.ts b/models/ExportSubscriptionsRequestBody.ts
@@ -2,7 +2,7 @@
  * OneSignal
  * A powerful way to send personalized messages at scale and build effective customer engagement strategies. Learn more at onesignal.com
  *
- * API Version: 5.6.0
+ * API Version: 5.7.0
  * Contact: devrel@onesignal.com
  */
 

diff --git a/models/ExportSubscriptionsSuccessResponse.ts b/models/ExportSubscriptionsSuccessResponse.ts
@@ -2,7 +2,7 @@
  * OneSignal
  * A powerful way to send personalized messages at scale and build effective customer engagement strategies. Learn more at onesignal.com
  *
- * API Version: 5.6.0
+ * API Version: 5.7.0
  * Contact: devrel@onesignal.com
  */
 

diff --git a/models/Filter.ts b/models/Filter.ts
@@ -2,7 +2,7 @@
  * OneSignal
  * A powerful way to send personalized messages at scale and build effective customer engagement strategies. Learn more at onesignal.com
  *
- * API Version: 5.6.0
+ * API Version: 5.7.0
  * Contact: devrel@onesignal.com
  */
 

diff --git a/models/FilterExpression.ts b/models/FilterExpression.ts
@@ -2,7 +2,7 @@
  * OneSignal
  * A powerful way to send personalized messages at scale and build effective customer engagement strategies. Learn more at onesignal.com
  *
- * API Version: 5.6.0
+ * API Version: 5.7.0
  * Contact: devrel@onesignal.com
  */
 

diff --git a/models/GenericError.ts b/models/GenericError.ts
@@ -2,7 +2,7 @@
  * OneSignal
  * A powerful way to send personalized messages at scale and build effective customer engagement strategies. Learn more at onesignal.com
  *
- * API Version: 5.6.0
+ * API Version: 5.7.0
  * Contact: devrel@onesignal.com
  */
 

diff --git a/models/GenericSuccessBoolResponse.ts b/models/GenericSuccessBoolResponse.ts
@@ -2,7 +2,7 @@
  * OneSignal
  * A powerful way to send personalized messages at scale and build effective customer engagement strategies. Learn more at onesignal.com
  *
- * API Version: 5.6.0
+ * API Version: 5.7.0
  * Contact: devrel@onesignal.com
  */
 

diff --git a/models/GetNotificationHistoryRequestBody.ts b/models/GetNotificationHistoryRequestBody.ts
@@ -2,7 +2,7 @@
  * OneSignal
  * A powerful way to send personalized messages at scale and build effective customer engagement strategies. Learn more at onesignal.com
  *
- * API Version: 5.6.0
+ * API Version: 5.7.0
  * Contact: devrel@onesignal.com
  */
 

diff --git a/models/GetSegmentsSuccessResponse.ts b/models/GetSegmentsSuccessResponse.ts
@@ -2,7 +2,7 @@
  * OneSignal
  * A powerful way to send personalized messages at scale and build effective customer engagement strategies. Learn more at onesignal.com
  *
- * API Version: 5.6.0
+ * API Version: 5.7.0
  * Contact: devrel@onesignal.com
  */
 

diff --git a/models/LanguageStringMap.ts b/models/LanguageStringMap.ts
@@ -2,7 +2,7 @@
  * OneSignal
  * A powerful way to send personalized messages at scale and build effective customer engagement strategies. Learn more at onesignal.com
  *
- * API Version: 5.6.0
+ * API Version: 5.7.0
  * Contact: devrel@onesignal.com
  */
 

diff --git a/models/Notification.ts b/models/Notification.ts
@@ -2,7 +2,7 @@
  * OneSignal
  * A powerful way to send personalized messages at scale and build effective customer engagement strategies. Learn more at onesignal.com
  *
- * API Version: 5.6.0
+ * API Version: 5.7.0
  * Contact: devrel@onesignal.com
  */