The response structure for creating new content (Articles, Conversations, Questions, Ideas, and Product Updates) via the API has been updated.
These endpoints now return a structured JSON object with id and publicId fields, replacing the previous single-string return value. Please check your existing automation scripts to ensure they are parsing this new object structure correctly.
💬 Have a question for
+2Is this now live in production? Was there any notification that this was changing?
Yes, this is now live in production. We released this change last week.
We sincerely apologize that this was rolled out without prior notification. We understand that unannounced API changes can cause unexpected work and break existing integrations.
We transitioned from a single-string return to a structured JSON object (containing id and publicId) to provide more robust data handling for developers. You can find the updated schema details in our Developer Documentation.
Going forward, we have already updated our internal processes to ensure that any future API enhancements are announced well in advance, giving you the necessary lead time to update your scripts.
+2
I understand the benefits, and the change sounds fine.
Unfortunately, when you have Documentation in an upstream system that automatically updates Gainsight articles via the API, and that system changes, you leave customers with an internal fire to fix it. That causes planning problems and takes employees away from their current workloads due to the vendor change without any notification.
You're absolutely right. We need to focus on a better approach to address the resource planning and the "firefighting" it forces on your team. That is exactly what we aim to avoid, and we clearly missed the mark here by not giving you the lead time to prepare. To prevent this from happening again, we are formalizing a communication standard for all API enhancements and optimizing our release patterns to ensure you have the lead time necessary for your roadmap.
If you ever had a profile with us, there's no need to create another one.
Don't worry if your email address has since changed, or you can't remember your login, just let us know at community@gainsight.com and we'll help you get started from where you left.
Else, please continue with the registration below.
Enter your E-mail address. We'll send you an e-mail with instructions to reset your password.