category_delete.rst

category_delete

.. function:: DELETE /orgs/{oid}/categories/{cid}

Summary

• Method: DELETE
• Response Code: 204 / 200
• Response Formats:
• Since: UForge 3.0

Deletes a category from an organization.

Warning

Only administrators have the ability to create and manage categories

Security Summary

• Requires Authentication: true
• Entitlements Required: categories_administrate

URI Parameters

• oid (required): the id of the :ref:`org-object`
• cid (required): the id of the :ref:`category-object`

HTTP Request Body Parameters

None

Example Request

curl "https://uforge.example.com/api/orgs/{oid}/categories/{cid}" -X DELETE \
-u USER_LOGIN:PASSWORD -H "Accept: application/xml"

.. seealso::

         * :ref:`category-object`
         * :ref:`categoryChild-create`
         * :ref:`category-create`
         * :ref:`category-deleteAll`
         * :ref:`category-get`
         * :ref:`category-getAll`
         * :ref:`category-update`
         * :ref:`org-object`