Delete a form

๐Ÿ“˜

REST API Equivalent. You can use the /config/{app}/flows/{flow}/forms/{form} operation and the DELETE method to delete a form.


Deleting a form can be dangerous. Why? Primarily because deleting a form removes the form definition from the flow, but doesnโ€™t change the fact that your login and registration pages still reference that form. For example, suppose youโ€™re using the JavaScript SDK and you delete the forgotPassword form. Hereโ€™s what your users will see if they then click the Forgot Password? link on the sign-in screen:

Why is there an error in displaying information? You got it: because the Identity Cloud is looking for a form that doesnโ€™t exist. Needless to say, itโ€™s not easy, even for the Identity Cloud, to display forms that donโ€™t exist.

That means that you need to consider all the possible ramifications (and take steps to modify your login and registration pages) if you decide to remove a form. This is especially important with Hosted Login, which doesnโ€™t give you access to the HTML markup for your login and registration pages. Because of that, itโ€™s recommended that you consult with your Identity Cloud representative before deleting any of the default Identity Cloud forms.


๐Ÿ“˜

And what if you do delete a form and then later change your mind? Fortunately, forms are referenced by name and not a unique identifier like a UUID. So suppose you delete the forgotPassword form, and you now regret that. Thatโ€™s OK: just create a new form named forgotPassword, and youโ€™ll be back in business.


If you decide to delete a form, click the trashcan icon located next to the form:

Doing so displays the following confirmation dialog:

Now just click Delete to delete the form.