File Upload
============

.. code-block:: http

    /api/repositories/{repository}/upload

.. csv-table::
    :header: Parameter, Type, Purpose
    :widths: 20, 20, 60
    :stub-columns: 1

    repository, string, The name of the :doc:`repository` to access

Post
~~~~

.. http:post:: /api/repositories/(string:repository)/upload
    :synopsis: Upload a file to the server file system

.. code-block:: http

    POST /api/repositories/jupiter/upload/library.ebr HTTP/1.1

The message body takes a ``file`` as input. The encoding should be set to ``enctype='multipart/form-data'``.

Only one file can be uploaded at a time.

.. csv-table::
    :header: Response Code, Reason
    :widths: 25, 75

    200, File uploaded to the server
    500, Server error

A successful response contains the path to the file that is uploaded.

If the server filesystem contains another file with the same name, the file will be renamed to an unique name.

The request above would result in the following response:

.. code-block:: json

    {
        "path": "/export/library.ebr"
    }