You are reading an old version of the documentation (v2.2.2). For the latest version see https://matplotlib.org/stable/
Version 2.2.2
matplotlib
Fork me on GitHub

matplotlib.axes.Axes.remove

Axes.remove()

Remove the artist from the figure if possible. The effect will not be visible until the figure is redrawn, e.g., with matplotlib.axes.Axes.draw_idle(). Call matplotlib.axes.Axes.relim() to update the axes limits if desired.

Note: relim() will not see collections even if the collection was added to axes with autolim = True.

Note: there is no support for removing the artist’s legend entry.