Create
------


.. tabularcolumns:: |p{4cm}|p{10.5cm}|

+---------------+---------------------------------------------------------------+
| Action        | create                                                        |
+===============+===============================================================+
| title         | Create an instance of a resource.                             |
+---------------+---------------------------------------------------------------+
| method        | POST                                                          |
+---------------+---------------------------------------------------------------+
| URL           | /api/<resource_type>/<resource_name>/                         |
+---------------+---------------------------------------------------------------+
| Parameters    | hierarchy=[hierarchy]                                         |
+---------------+---------------------------------------------------------------+
| Payload       | See add schema of the object for the payload specification    |
+---------------+---------------------------------------------------------------+
| support_async | true                                                          |
+---------------+---------------------------------------------------------------+
| class         | add                                                           |
+---------------+---------------------------------------------------------------+
   
Response is a pkid of the created instance.

To obtain the schema of the resource, use the GET request:

::

   GET /api/<resource_type>/<resource_name>/
   ?hierarchy=[hierarchy]
   &format=json

To apply a configuration template when creating the resource, use the parameter 
``&configuration_template`` with its value the name of an existing Configuration Template. 
For details on the parameter, refer to the topic on API parameters.


.. |VOSS-4-UC| replace:: VOSS-4-UC
.. |Unified CM| replace:: Unified CM
.. |API Guide| replace:: API Guide