It would be pretty awesome if these docstrings could say what counts as a valid image (e.g. one that exists, and is active, in this case).

This is non-blocking, since it can be done in a different PR, and may not be very high priority - if we encounter a 500, do we want to retry?  Since the image is not actually invalid.