Delete & Deprecate System
Delete a System with its associated versions
The System Builder can delete a system along with all its versions directly from the System Builder listing page (the page that opens when you click the System Builder menu).
A system can be deleted only if none of its published versions have associated users. If any user is linked to any published version, the system cannot be deleted.
When a system is deleted, all its versions, APIs, and builder credentials are permanently removed.
Delete a Version of a System
If a specific version of a system has no associated users, the System Builder can delete that version from the Version History tab within the system editor. Deleting a version permanently removes all APIs and builder credentials linked to that version.
If the System Builder deletes the recommended version, they will be prompted to select a new recommended version, provided more than one published version exists. If only one published version remains, it will automatically become the recommended version.
If a system has no published versions, the system becomes inaccessible to users.
Deprecate a Version of a System
If the System Builder wants to discourage the use of a specific version while there are existing users, the version can be deprecated. Deprecating a version prevents new users from selecting it while still supporting existing users. A deprecated version can be restored at any time using the “Undo Deprecate” option.
If the System Builder deprecates the recommended version, they will be prompted to select a new recommended version when more than one published version exists. If only one published version is available, it is automatically set as the recommended version.
If no published versions exist for a system, the system cannot be accessed by new users.
When users access a deprecated version, they will see a warning message:
If a recommended version exists, the warning prompts the user to switch to the recommended version.
If no recommended version exists, the warning advises the user to discontinue using the system.
Last updated
Was this helpful?