==================================
POST /:country/listings/:id/images
==================================

Uploads a new image for an existing listing.

Body Parameters
---------------

An `Image`_ model with the following properties filled:

===========  ==================================================
 `base64`     The image being uploaded encoded in base64.
 `type`       A valid Image type (see model documentation).
 `caption`    Image caption (may be an empty string).
===========  ==================================================

The `id` and `url` properties should be omitted, these are populated by Opendi
and returned in the response.

Response
--------

On success returns **HTTP 201 Created** with the newly created `Image`_ model.

The returned model will not have ``base64`` populated, but will have an publicly
accessible URL of the uploaded image set in ``url``.

On error, returns an `Error`_ model.

Example
-------

**POST https://api.opendi.com/de/listings/5194891/images**

.. code-block:: javascript

    {
        "caption": "Opendi logo",
        "base64": "iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAABHNCSVQICAgIfAhkiAAABNhJREFUWIW9VltsVFUUXefeOw9qaUkf05QCfcQO0NoIRUEgEU0ViKaED3whhg8DfpgSTQQMxgeGRwxEEgwaH2gTJEAARSCIVIxIMTU0BbG21E7b9DEzMH1OW4aZe+/Zx4+h5badxx0k7mR/nXXWWnvfc87dDImF8vDszKWry4teXrJg+qKSmZk5Voskt3X5+y5e7rr6Q5Xr+I8XWo9oOvWbJWRmgQ85M8r2vle298kF04ti4Tq9Q/2bd13YeejU9Y8B8PtiYM2K2e9889GyDxVZkiauiog0+4/Wn1n/btULRGI4FrccT/ylZ2e+fXD38h0SA4MQMCYJgUHhhF10h30Y1kqLMgvzclJKT/zccviOy8QNOPOmLD63f+UBWWLSHYUxOYhCTMpfA9Z3AQw0YX3OrIwHWzv9wWtNPdXRNCK0dDTY7o2L91hlJoMI45O4DqQvh9WWAj35MYD4BAyIsHvjwi02q5yVsIHcqcmLyh+f8WiYeGIOwYnk9IIwSeZTIC4i4hxT7MmvlDtfTdjAi8vyV44l0wHSAK6C6yqQ+QxkKXz4FHsa9MkLAB4MY0gfY2LpwpwV0XSUaAuz8tPngQhBkYSQPA1kcUDYssHsDsi2DExOyxlbSc7zGEyaB7rtAwu6IaleSLwXSaIXS+ZmFTPG7EKIoGkDMxyTp4JzKEyFnLcKlpT8aNAwkcWOFEcxgGIA4WMYaDsO9J2GI1VOVhQ5TdN0z/h9UT+BJAkJxKHwAOR/tkPzt8Q0YAwhALX1EJK6vwcjAoiDMRZRK6oBX/dQHzgHOIekByE3bYPmd8UVJyGguiph850EIwCcIxjQdF3nER+kqAY6vQNtxoMk6UHIDVuhDXXFNKC7KmHznQEIo3ubOwa6icifkIGG1v66kQ6MdkK7hdDtwZgGpODNsLhh3x/1vfWI8hpGNXDusu9S+DrdTZ0kSEnZMQ0gKddwFcN5tbk/8ZfQ3R2sdXUO9hgr0VgKLPbUUYw2fAPajRoQkcFADqCrYzpw4qLnp4QNCEA99mvXaeM54NZsKIoEPdCLUP0+yDXrYPnrfVDNBmi+K+EeT5oK8LsPUV1Tb4e7J1ibsAEAqKzyHrhbjQZucUBr+Aqsei1s7pOQuA6QBGXIBaVuE3jNJnD1FgjWO3t0HDzvPoQYc0G8eUCu3lXauLg4rRAI328GAiJfaUAAAgJgMhgIqk48a/VvxQPDetM9dQAA33eq/bORb8mIAyQw/naMJnEwIjCuAZzj2/OeqljiZjoAWWIpLZ/Pb8t12NLiYcdH0eu1ZY1dgV9iYeJ1AJzE4M6j7XujVh0lj13yXYonDpicCRWJpTZ9MsdVkGXLMIMHgOI3/ixr6Lod10DcDgCATsK/5WD7jmjDyfisPH/zrBlxIIGxnAG26q0zry1yPuCMhQuopBVs+Lv0pl+rN8NrqgMAIIBQRWXHm5HmPmN+cNT9qVlxwMRYbgzvgN6ckSyVzC+wF40f0SEEGjqHPWu/8D5HQoTMcpruwEhsPuyt6OgJ9Ueqft3+GxU6j/zbvW8GAqrwrv/a8xYEwZh7zvYc+d0V+C5RvoQ+wUi0+NQr2any3EdybbMgBK57Qt5V+9zlnBC4F757CruFORq35Xm0Lwv5nBm2Zf+bsDFKplmffu2JKdv/C8e/CWXpESD2G38AAAAASUVORK5CYII=",
        "type": "logo"
    }


**201 Created**

.. code-block:: javascript

    {
        "id": "39",
        "type": "logo",
        "url": "http:\/\/static.opendi.com\/yellow\/local\/de\/5194891\/images\/39.jpg",
        "base64": null,
        "caption": "Opendi logo"
    }

.. _Image: ./../models.html#image
.. _Error: ./../models.html#error