Add documentation for REST API PO endpoint

WIP

dev-manual/api/add-po.rst

@@ -0,0 +1,41 @@
+.. _api-add-po:
+
+================================
+Add physical object endpoint
+================================
+
+**POST /api/informationobjects**
+
+This endpoint will allow adding a :term:`physical object`.
+
+.. _add-po-ex-req:
+
+Example request
+===============
+
+.. code-block:: none
+
+   curl -v -X POST -H "REST-API-Key: api-key" "https://www.example.com/api/informationobjects" -H Content-Type: "application/json" -d '{"name": "testobject", "location": "Test location"}'
+
+.. _add-po-ex-resp:
+
+Example response
+================
+
+Example response is truncated and edited for readability.
+
+.. code-block:: none
+
+   HTTP/1.1 200 OK
+   Content-Type: application/pdf
+   Content-Length: 339503
+   Content-Description: File Transfer
+   Content-Transfer-Encoding: binary
+   Content-Disposition: attachment; filename=sample_file.pdf
+   Cache-Control: public, must-revalidate
+   Pragma: public
+
+   (file bitstream)
+
+
+:ref:`Back to top <api-add-po>`

dev-manual/api/api-intro.rst

@@ -210,6 +210,8 @@ parameters. There are three endpoints available:
 * :ref:`Browse taxonomy terms <api-browse-taxonomies>`
 * :ref:`Browse information objects <api-browse-io>`
 * :ref:`Read information object <api-read-io>`
+* :ref:`Download digital objects <api-download-do>`
+* :ref:`Add physical objects <api-add-po>`
 
 .. _api-intro-i18n: