Library Entity Attribute
=========================

.. code-block:: http

    /api/repositories/{repository}/library/entities/{library}/attributes/{attribute}

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

    repository, string, The :doc:`repository` name
    library, int, The :doc:`library <libraryentity>` ID
    attribute, int, The attribute ID


.. _lesa_delete:

Delete
~~~~~~

.. http:delete:: /api/repositories/(string:repository)/library/entities/(int:libraryID)/attributes/(int:attributeID)
    :synopsis: Delete attribute in a library entity

    Deletes an attribute in the library.

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

    204, Success
    403, Forbidden - Attribute is in use. Cannot delete
    500, Server error


.. _lesa_edit:

Edit
~~~~

.. http:post:: /api/repositories/(string:repository)/library/entities/(int:libraryID)/attributes/(int:attributeID)
    :synopsis: Edits an attribute in the library

    Edits an attribute in the library. You may delete the attribute description by setting the description parameter to an empty string. However, you may not delete the attribute name, so if you set the name parameter to an empty string no change will be made to the attribute name.

    :jsonparam body: The request body

    The request requires a :doc:`standard-request` packet.

.. code-block:: http

    POST /api/repositories/test/library/entities/1/attributes
    {
        "command": "edit",
        "data": {
            "name": "newattrname",
            "description": "a new description"
        }
    }

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

    204, Success
    403, Forbidden - Attribute is in use. Cannot edit
    500, Server error