This topic describes low-level APIs, which are considered legacy functionality, but can be useful in specific scenarios. Optimizely recommends using Catalog Content APIs in Customized Commerce.
You can only suggest edits to Markdown body content, but not to the API spec.