Campaign

Release Notes for Acoustic Mobile SDKs

Supported platforms

Acoustic currently provides mobile push SDKs for the following development environments/platforms:

SDK/Plug-in
Supported platform versions

Apple iOS

  • iOS 13.x, iOS 14.x, iOS 15.x, Xcode 13.x

Apple Watch

  • watchOS 4.x, watchOS 5.x, watchOS 6.x, watchOS 7.x, Xcode 13.x

Android

  • Simple push notifications are supported for Android 4.1 / API level 16
  • All features are supported for Android 4.4 / API level 19 (and higher)
  • gms version in build.gradle (Module: app) should be 10.x or above
  • support/testing on FCM only

Cordova

  • 10.x (using Cordova iOS plug-in 6.2.1 and Cordova Android plug-in 10.1.1 )
  • iOS 12.x, iOS 13.x, iOS 14.x, iOS 15 and Xcode 13.1
  • All features are supported for Android 4.4 / API level 19 (and higher). For more information, see Notes.

Xamarin

  • The latest stable version of Xamarin.Forms (Xamarin Native is not supported)
  • iOS 12.x, iOS 13.x, iOS 14.x, and Xcode 12.4
  • All features are supported for Android 4.4 / API level 19 (and higher). For more information, see Notes.

React Native

  • React Native 0.59.9, 0.60, 0.61, 0.62, 0.63, 0.64 and react-native-cli 2.0.1.

Cordova SDK 3.8.4

On November 5th, Acoustic introduced several improvements and bug fixes. This release is recommended for all Cordova users.

Bug Fixes:

  • Eliminated reference to removed class FirebaseInstanceIdService
  • Removed references to UIWebView and has been replaced with WKWebView for iOS 13 compatibility.
  • Resolved Cordova SDK crashes on Android due to updates in Cordova Android support. We now support Cordova (10.x) and the associated Android and iOS libs, which resolve the crash issue.

Improvements:

  • Upgraded iOS SDK to 3.8.4.
  • Upgraded Android SDK to 3.8.4.
  • Upgraded the Cordova SDK to use typescript, which will provide the typings expected for each function call.

Our environment for this release:

  • Cordova version: 10.0.0 ([email protected])
  • Cordova Android plugin version: 10.1.1
  • Cordova iOS plugin version: 6.2.0
  • Gradle version: 6.5
  • Xcode version: 13.1
  • Android Studio version: 2020.3.1 (MacOS)
  • iOS 12.4.5, 13.6, 14.8, 15
  • Android 6.0.1 (API 23), 7.1.2 (API 25), 8.0 (API 26), 9.0 (API 28), 10 (API 29), 11 (API 30)

Android SDK 3.8.4

October 2021 – Android application not responsive (ANR) issue fixed
On October 15th, Acoustic resolved the ANR issue for Android applications. This release is recommended for Android native users affected by the defects resolved.

Updating to the new baseUrl is recommended to everyone, regardless of whether you update to 3.8.4 or not.

For basic migration steps, see Migrating Android SDK.

Bug fixes:
Eliminated ANR generation for applications using the Android SDK on specific devices such as Oppo, Samsung, and others. As part of the fix, the SDK now uses ProviderInstaller.installIfNeededAsync() instead of ProviderInstaller.installIfNeeded() internally.

Improvements:

  • None

Our environment for this release:

  • Android Studio 4.0.1
  • Gradle 6.5
  • Android Plugin 3.5.3
  • SQLeet: v0.28.0
  • Android 4.4.2 (API 19), 5.0.0 (API 21), 5.1.1 (API 22), 6.0 (API 23), 7.0.0 (API 24), 7.1.1 (API 25), 8.0.0 (API 26), 8.1.0 (API 27), 9.0 (API 28), 10.0 (API 29), 11 (API 30)

React Native SDK 3.8.4

October 2021 improvements

On October 1st, Acoustic introduced several improvements. This release is recommended for all React Native users.

Bug Fixes:

  • None

Improvements:

  • Upgraded iOS SDK to 3.8.4.
  • Upgraded Android SDK to 3.8.3.

Note:

If you are migrating from version 3.0.1 or lower you will need to remove the old packages and add new packages. Because the package names in the underlying native SDKs have changed, some manual updates are also required. See the Migration guide for React Native 3.0.1 to 3.8.0/3.8.1 for more details.
If you are migrating from 3.8.0, no additional steps are required to upgrade to 3.8.1.

Our environment for this release:

  • react-native: 0.64.2
  • react-native-cli: 2.0.1
  • MacOS 11.5.1
  • Xcode version: 12.5.1
  • iOS 12.4.5, 13.6, 14.8
  • Android Studio version: 2020.3.1 (MacOS)
  • Gradle version: 6.5
  • Android 5.0 (API 21), 6.0.1 (API 23), 7.1.2 (API 25), 8.0 (API 26), 9.0 (API 28), 10 (API 29), 11 (API 30)
  • Node.js version: v14.16.1

Android SDK 3.8.3

September 2021 – Improvements to battery saver optimization
On September 17th, Acoustic introduced several improvements. This release is recommended for Android native users affected by the defects resolved and those who wish to take advantage of the SDK improvements.

Updating to the new baseUrl is recommended to everyone, regardless of whether you update to 3.8.3 or not.

For basic migration steps, see Migrating Android SDK.

Bug fixes:
Fixed the bug in the unified inbox messages, where the message status did not update on one device when the message was read or deleted in the other device that shared the inbox.

Improvements:

  • Improved battery saver optimization function to allow simple push notifications to render additional images when the device battery saver mode is ON.
  • Updated the SDK to accommodate Google's August 2021 guidelines to meet Google Play's target API level requirement/API 30.

Our environment for this release:

  • Android Studio 4.0.1
  • Gradle 6.5
  • Android Plugin 3.5.3
  • SQLeet: v0.28.0
  • Android 4.4.2 (API 19), 5.0.0 (API 21), 5.1.1 (API 22), 6.0 (API 23), 7.0.0 (API 24), 7.1.1 (API 25), 8.0.0 (API 26), 8.1.0 (API 27), 9.0 (API 28), 10.0 (API 29), 11 (API 30)

iOS SDK 3.8.4

September 2021 – Improvements to Keychain

On September 10th, Acoustic introduced several improvements. This release is recommended for iOS native users affected by the defects resolved and those who wish to take advantage of the SDK improvements.

Updating to the new baseUrl is recommended to everyone, regardless of whether you update to 3.8.4 or not.

For basic migration steps, see Migrating iOS SDK

Bug Fixes:
The default MCEKeychain now uses the appKey (previously BundleID) as a service attribute. Initializing an instance of MCEKeychain will now trigger a data migration procedure if needed, which is non-destructive. The data migration will be performed just once.

Improvements:

  • None

Our environment for this release:

  • Xcode 13
  • MacOS 10.15.7
  • iOS 15.x
  • WatchOS 4.0

iOS SDK 3.8.3

April 2021 – Improvements to Geofences

On April 9th, Acoustic introduced several improvements. This release is recommended for iOS native users affected by the defects resolved and those who wish to take advantage of the SDK improvements.

Updating to the new baseUrl is recommended to everyone, regardless of whether you update to 3.8.3 or not.

For basic migration steps, see Migrating iOS SDK

Bug fixes:

  • Fixed the MCElog bug that caused a crash when there was an error while writing a log to file.

Improvements:

  • The maximum search radius for Geofences was decreased from 10 000 km to 2 500 km.
  • Added “minimumQuantity” key to geofences configuration, defaults to 1. For more information, see Configuration (MceConfig.json).

Our environment for this release:

  • Xcode 13.0
  • MacOS 10.15.7
  • iOS 15.x
  • WatchOS 4.0

Android SDK

February 2021 – Added ability to manage permissions in Android manifest

Applications published to Google Play Store using background permissions will require approval as part of Google’s Safer and More Transparent Access to User Location. Please read and consider Google’s policies and how they impact your application.

Currently, the Acoustic Android SDK requires location permissions as part of the default settings in the manifest. These permissions impact Google's approval requirement for your application. You may edit and remove required permissions prior to releasing your application with reduced functionality.

Android SDK 3.8.2

August 2020 improvements - Compatible with 20.3 Acoustic Campaign Automation

On August 12th, Acoustic introduces the following improvements. This release is recommended for all Android native users affected by the defects resolved, and those who wish to take advantage of the SDK improvements.

Updating to the new baseUrl is recommended to everyone, regardless of whether you update to 3.8.2 or not.

A migration guide from 3.8.1 to 3.8.2 is available.

Bug Fixes:

  • Added onFailure callback when retrieving inbox on spotty networks
  • Fixed incorrect event type in ExamplePlugin
  • Changed retry value to seconds from milliseconds
  • Prevented crash on inbox video when network is down
  • Prevented in-app messages from breaking when presented with an invalid template name
  • Updated outdated branding

Improvements:

  • Added support for push deliverability metrics
  • Added support for external processing of inbox and in-app messages
  • Converted plugins to importable modules
  • Exposed co.acoustic.mobile.push.sdk.plugin.inapp.InAppFragment to allow extension

Our environment for this release:

  • Android Studio 4.0.1
  • Gradle 6.1.1
  • Android Plugin 3.5.3
  • SQLeet: v0.28.0
  • Android 4.4.2 (API 19), 5.0.0 (API 21), 5.1.1 (API 22), 6.0 (API 23), 7.0.0 (API 24), 7.1.1 (API 25), 8.0.0 (API 26), 8.1.0 (API 27), 9.0 (API 28), 10.0 (API 29)

iOS SDK 3.8.2

August 2020 improvements - Compatible with 20.3 Acoustic Campaign Automation

On August 12th, Acoustic introduces the following improvements. This release is recommended for iOS native users affected by the defects resolved and those who wish to take advantage of the SDK improvements.

Updating to the new baseUrl is recommended to everyone, regardless of whether you update to 3.8.2 or not.

A migration guide from 3.8.1 to 3.8.2 is available.

Bug Fixes:

  • Resolved issue with watch payload
  • Fixed race condition in Swift sample app
  • Fixed sample app listener for MCERegistrationChangedNotification

Improvements:

Note:

iOS 13 changes location permission requests so that users cannot grant "always" permission from within your application. For more information, see Device Location Awareness (DLA).

Note:

Due to Apple defect FB7017088, multiple window support for push message actions may not function on iOS 13.0 when the app is not running. Our testing shows that this issue appears to have been fixed in iOS 13.1.

Our environment for this release:

  • Xcode 11.6 (11E7080)
  • MacOS 10.15.6
  • iOS 11.4, 12.4.1, 13.6

Android SDK 3.8.1

April 2020 improvements - Compatible with 20.2 Acoustic Campaign Automation

On April 14th, Acoustic introduces the following improvements. This release is recommended for all Android native users affected by the defects resolved, and those who wish to take advantage of the SDK improvements.

Updating to the new baseUrl is recommended to everyone, regardless of whether you update to 3.8.1 or not.

A migration guide from 3.8.0 to 3.8.1 is available.

Bug Fixes:

  • Corrected initialization defect when using "messagingService":"custom"
  • Resolved job issues when upgrading from older releases.

Improvements:

  • Improved battery life by preventing unnecessary updates to timezone.
  • Removed extraneous error messages.
  • Allowed queues to process even if a bad entry is encountered.
  • Improved support for TLS 1.3 and future versions.
  • Made integration easier by using manifest merging.
  • Corrected ExamplePlugin custom event type
  • Updated to Acoustic branding/images in sample app.
  • Removed obsolete GCM code from the SDK.
  • Removed obsolete Zebra beacon code from the SDK.

Note:

This release contains only the Demo sample app in AAR format. Most customers now use AAR format, and this allows us to focus our sample app testing. If you need instructions for migrating to the AAR format, see Migrating a project from jar to aar in Android.

Our environment for this release:

  • Android Studio 3.6.1
  • Gradle 5.6.4
  • Android Plugin 3.5.3
  • SQLeet: v0.28.0
  • Android 4.4.2 (API 19), 5.0.0 (API 21), 5.1.1 (API 22), 6.0 (API 23), 7.0.0 (API 24), 7.1.1 (API 25), 8.0.0 (API 26), 8.1.0 (API 27), 9.0 (API 28), 10.0 (API 29)

iOS SDK 3.8.1

April 2020 improvements - Compatible with 20.2 Acoustic Campaign Automation

On April 1, Acoustic introduces the following improvements. This release is recommended for all users experiencing any issues resolved, as well as for users who want to take advantage of the SDK improvements.

A migration guide from 3.8.0 to 3.8.1 is available.

We recommend that you update to the new baseUrl, regardless of whether you update to 3.8.1 or not.

Bug Fixes:

  • Renamed storage from com.ibm.mobile-push to co.acoustic.mobile-push (missed on initial migration)
  • Fixed problem saving to keychain (error -25299)
  • Resolved issue with CocoaPod support and XCWorkspace/XCFramework

Improvements:

  • Added support for MacOS Catalina / Catalyst and UIKit
  • Updated SQLeet library
  • Added multiple window support to sample app
  • Added support for UIScene-based state restoration to sample app
  • Removed obsolete code that supported Zebra beacons and pre-iOS 10 APIs
  • Added a sample app demonstrating manual integration in Swift

Note

This release includes new baseUrl values, which are live now and in the future. See Upgrading from old baseUrl to new baseUrl for more details.

Note

iOS 13 changes location permission requests so that users cannot grant "always" permission from within your application. For more information, see Device Location Awareness (DLA) for more details.

Note

Due to Apple defect FB7017088, multiple window support for push message actions may not function on iOS 13.0 when the app is not running. Our testing shows that this issue appears to have been fixed in iOS 13.1.

Our environment for this release:

  • Xcode 11.3.1
  • MacOS 10.15.3
  • iOS 11.3.1, 12.4.1, 13.3.1

React Native SDK 3.8.0

February 2020 improvements - Compatible with 20.1 Acoustic Campaign Automation

On February 7, Acoustic and IBM Mobile Messaging introduce the following improvements. This release is recommended for all React Native users.

Bug Fixes:

  • Corrected calendar plugin to run on main thread.

Improvements:

  • Upgraded iOS SDK to 3.8.0.
  • Upgraded Android SDK to 3.8.0.

Note

To upgrade, you will need to remove the old packages and add new packages. Because the package names in the underlying native SDKs have changed, some manual updates are also required. See the Migration guide for React Native 3.0.1 to 3.8.0 for more details.

Note

Due to issues building with the latest version of Node.js, Facebook recommends using an earlier version to build on Windows, although users have suggested other solutions.

Note

As shipped, the React Native SDK includes references to UIWebView, which will prevent publication to the Apple App Store after December 2020. A workaround for this is detailed in this article.

Our environment for this release:

  • react-native: 0.59.9
  • react-native-cli: 2.0.1
  • MacOS 10.15.2
  • Xcode version: 11.3
  • iOS 11.3.1, 12.4.1, 13.3.1
  • Android Studio version: 3.5.2 (MacOS)
  • Gradle version: 4.10.2
  • Android Gradle Plugin : 3.3.1
  • Android 4.4.2 (API 19), 5.1.1 (API 22), 6.0 (API 23), 7.0 (API 24), 71.1. (API 25), 8.0 (API 26), 8.1.0 (API 27), 9.0 (API 28)
  • Node.js version: 12.9.1 (MacOS)

Xamarin SDK 3.8.0

January 2020 improvements - Compatible with 20.1 Acoustic Campaign Automation

On January 27th, Acoustic and IBM Mobile Messaging introduce the following improvements. This release is recommended for all Xamarin users.

Bug Fixes:

  • none

Improvements:

  • Updated to native iOS SDK 3.8.0.
  • Updated to native Android SDK 3.8.0.
  • Updated to Acoustic packages and branding.
  • Added support for dark mode on iOS 13 and Android Q.
  • Added an iOS Notification Service Extension now that C# allows it.
  • Updated to use Xamarin.Forms version 4.3.0.991211.

Note

With this release, the SDK namespaces have been renamed. All references to "using IBMMobilePush." should be changed to "using AcousticMobilePush." instead. In addition, on Android you will need to update your AndroidManifest.mf if you are building for Android. See the migration guide for more details.

Note

iOS 13 changes location permission requests so that users cannot grant "always" permission from within your application. For more information, see Device Location Awareness (DLA) for more details.

Note

Due to Apple defect FB7017088, multiple window support for push message actions may not function on iOS 13.0 when the app is not running. Our testing shows that this issue appears to have been fixed in iOS 13.1.

Our environment for this release:

  • Xamarin.Mac 5.6.1.24 (d16-3 / 08809f5b)
  • Visual Studio Community 2019 for Mac, Version 8.3.10(build 2)
  • Xcode 11.2.1
  • Android Studio 3.5
  • iOS 10.0.1 (64-bit - see note), 11.3.1, 12.1.4, 13.1.3
  • Android 4.4.2, 5.1.1, 6.0, 7.0.0, 8.1.0, 9.0, 10.0

Note

The latest versions of Xamarin do not build correctly for 32-bit iOS 10 devices. Builds on earlier versions of Xamarin may work.

Cordova SDK 3.8.0

On January 14th, Acoustic and IBM Mobile Messaging introduce the following improvements. This release is recommended for all Cordova users. Note that due to Cordova plugin compatibility issues, this release requires Cordova 9.x.

Bug Fixes:

  • none

Improvements:

  • Separated dial action into its own Cordova plugin. This allows apps which do not use dial to pass OS app store code reviews.
  • Updated to native iOS SDK 3.8.0.
  • Updated to native Android SDK 3.8.0.
  • Added support for dark mode on iOS.
  • Updated SDK and sample app package names.

Note

With this release, the SDK namespaces have been renamed. All references to the namespaces in your code will need to be modified. See the Cordova Migration Guide for more details.

Note

iOS 13 changes location permission requests so that users cannot grant "always" permission from within your application. For more information, see Device Location Awareness (DLA).

Note

There is a known issue with the Cordova build process including all slices in the SDK, which means they must be removed. A StackOverflow article details how to do this.

Note

As shipped, the Cordova SDK includes vestigial references to UIWebView, which will prevent publication to the Apple App Store after December 2020. A workaround for this is detailed in this article

Our environment for this release:

  • Cordova version: 9.0.0 ([email protected])
  • Cordova Android plugin version: 8.0.0
  • Cordova iOS plugin version: 5.0.0
  • Gradle version: Gradle 5.2.1
  • Xcode 11.3
  • Android Studio 3.1.3
  • iOS 11.3.1, 12.3.1, 13.3
  • Android 4.4.2, 5.0, 5.1.1, 6.0, 7.0, 7.1.1, 8.0, 8.1.0, 9.0

React Native SDK 3.0.1

December 2019 improvements - Compatible with 19.4 Acoustic Campaign Automation

On December 6, Acoustic and IBM Mobile Messaging introduce the following improvements. This release is recommended for React Native users who are developing on Windows.

Bug Fixes:

  • Updated .js and package.json files to allow the SDK to be built under Windows.

Improvements:

  • none

Note

Due to issues building with the latest version of Node.js, Facebook recommends using an earlier version to build on Windows. Our tests used 10.15.1.

Our environment for this release:

  • react-native: 0.59.9
  • react-native-cli: 2.0.1
  • MacOS 10.15.1
  • Xcode version: 11.2.1
  • iOS 13.1.2
  • Android Studio version: 3.3.1 (Windows), 3.5.2 (MacOS)
  • Gradle version: 4.10.2
  • Android Gradle Plugin : 3.3.1
  • Android 10.0.0 (API 29)
  • Node.js version: 10.17.1 (Windows), 10.15.1 (MacOS)

Android SDK 3.8.0

November 2019 improvements - Compatible with 19.4 Acoustic Campaign Automation

On November 7th, Acoustic and IBM Mobile Messaging introduce the following improvements. This release is recommended for all Android native users.

A migration guide from 3.7.1.4 to 3.8.0 is available at Upgrading from Android 3.7.1.4 to Android 3.8.0.

Note

We have had at least one report of issues upgrading from previous releases to 3.8.0 when there are old items in the queue. A workaround is available here. This does not affect new installs, only upgrades.

Bug Fixes:

  • Eliminated reference to removed class FirebaseInstanceIdService.
  • Fixed example event code in sample app to send correct attribution.
  • Fixed issue with log iteration time parsing.

Improvements:

  • Converted SDK and sample app to AndroidX.
  • Changed packaging to include DemoAar sample app only.
  • Added the example plugin to the sample app.
  • Removed GCM references from sample app.
  • Removed use of wakelocks when reporting metrics.
  • Improved error handling.
  • Added API to allow inbox messages to be transformed when received, before being inserted into the database, and after being inserted into the database (see Inbox control API additions for Android).
  • Added API to allow custom messaging service instead of FCM/GCM. See Android Messaging API and Using a custom messaging service for Android for more details.
  • Improved location events responsiveness when the app is in the background.
  • Collapsed outdated location events to send only the most recent.
  • Added support for Android 10.
  • Updated SDK and sample app package names. With this release, the SDK packages have been renamed. All references to the packages in your code will need to be modified. Please change all references of com.ibm.mce to co.acoustic.mobile.push.

Note

This release contains only the DemoAar sample app. Most customers now use AAR format, and this allows us to focus our sample app testing. If you need instructions for migrating to the AAR format, see Migrating a project from jar to aar in Android.

Note

If you use location services, you will need to update AndroidManifest.xml and MceConfig.json. See Device Location Awareness (DLA).

Our environment for this release:

  • Android Studio 3.5.1
  • Gradle 5.4.1
  • Android Plugin 3.5.0
  • Android 4.4.2 (API 19), 5.0.0 (API 21), 5.1.1 (API 22), 6.0 (API 23), 7.0.0 (API 24), 7.1.1 (API 25), 8.0.0 (API 26), 8.1.0 (API 27), 9.0 (API 28), 10.0 (API 29)
  • SQLeet 0.28.0

Note

Testing and support for GCM has been removed in anticipation of Google disabling the service. GCM classes still exist in the SDK, and it may continue to work, but have not been tested. We strongly recommend you move to FCM as soon as possible.

iOS SDK 3.8.0

October 2019 improvements - Compatible with 19.4 Acoustic Campaign Automation

On October 9, Acoustic and IBM Mobile Messaging introduce the following improvements. This release is recommended for all iOS native users who wish to use iOS 13 features (including dark mode) or take advantage of the SDK improvements.

Bug Fixes:

  • Fixed registration problem in simulator if configuration includes "autoInitialize" :false.
  • Added mailingId field to event with name "messageOpened" and type "inbox".

Improvements:

  • Added support for iOS 13 including dark mode, multiple window apps. With the addition of iOS 13 support, support is withdrawn for iOS 10.
  • Added rudimentary filtering of invalid mailingId values to event API. Values which do not contain a number will be rejected.
  • Improved user experience for post inbox template message images. Now the inbox opens the message if you click the image on the message list page, but opens the image zoom interface when tapped on the full message view.
  • Switched to using XCFramework instead of Framework. See Update your existing project to the new Acoustic frameworks for details about using Apple's new structure and our new package names.
  • Added support for UIKit for Mac.
  • Replaced UIWebView with WKWebView for iOS 13 compatibility.
  • Added active tracking to geofence display in Swift sample app.
  • Improved Custom Action page in Sample app.

Note

With this release, the SDK namespaces have been renamed. All references to the namespaces in your code will need to be modified. IBMMobilePushWatch should change to AcousticMobilePushWatch, IBMMobilePushNotificationService should change to AcousticMobilePushNotification (without the "Service" suffix) and any other references to IBMMobilePush should change to AcousticMobilePush.

Note

iOS 13 changes location permission requests so that users cannot grant "always" permission from within your application. For more information, see Device Location Awareness (DLA).

Note

Due to Apple defect FB7017088, multiple window support for push message actions may not function on iOS 13.0 when the app is not running. Our testing shows that this issue appears to have been fixed in iOS 13.1.

Our environment for this release:

  • Xcode 11.0
  • MacOS 10.14.6
  • iOS 11.3.1, 12.4.1, 13.1.2

React Native SDK 3.0.0

September 2019 improvements - Compatible with 19.4 Acoustic Campaign Automation

On September 24, Acoustic and IBM Mobile Messaging introduce the following improvements. This release is recommended for all React Native users.

Bug Fixes:

  • none

Improvements:

Our environment for this release:

  • react-native : 0.60
  • react-native-cli: 2.0.1
  • MacOS 10.14.6
  • Xcode version: 10.2.1
  • iOS 10.3(32-bit), 11.3.1, 12.4.1
  • Android Studio version: 3.5
  • Gradle version: 4.10.2
  • Android Gradle Plugin : 3.3.1
  • Android 4.4.2 (API 19), 5.1.1 (API 22), 6.0 (API 23), 7.0 (API 24), 7.1.1 (API 25), 8.0 (API 26), 8.1.0 (API 27), 9.0 (API 28)

Updated 25 days ago


Release Notes for Acoustic Mobile SDKs


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.