specs for images-controller and add examples to apipie doc