Add Generic Action
-------------------

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

+---------------+-------------------------------------------------------+
| Action        | add                                                   |
+===============+=======================================================+
| title         | Get the GUI Add form.                                 |
+---------------+-------------------------------------------------------+
| method        | GET                                                   |
+---------------+-------------------------------------------------------+
| URL           | /api/<resource_type>/<resource_name>/add/             |
+---------------+-------------------------------------------------------+
| Parameters    | hierarchy=[hierarchy], format=json                    |
+---------------+-------------------------------------------------------+
| Response      | The schema of <resource_type>/<resource_name> as JSON |
+---------------+-------------------------------------------------------+
| support_async | false                                                 |
+---------------+-------------------------------------------------------+
| class         | add                                                   |
+---------------+-------------------------------------------------------+
   
When adding the ``&schema=1`` parameter, the response contains the schema of the payload for the Create action.

The schema required to add the resource may be different from the schema that is used to 
obtain the details of the resource. Refer to the schema of the GUI Add form.

The actions in the response shows the URL for the POST API call to create an instance (see Create action).


For example, the request below shows the required details.
(Using variables [hierarchy])

Request:

::

   GET /api/data/AccessProfile/add/
     ?hierarchy=[hierarchy]
     &format=json
     &schema=1


Response snippet - POST call:

::


   "create": {
        "class": "add", 
        "href": "/api/data/HierarchyNode/?hierarchy=[hierarchy]", 
        "method": "POST", 
        "support_async": true, 
        "title": "Create"
    }


Response snippet - schema:

::
               
    "schema": {
       "$schema": "http://json-schema.org/draft-03/schema", 
       "properties": {
           "description": {
               "description": "A general description for the hierarchy node.", 
               "title": "Description", 
               "type": "string"
           }, 
           "name": {
               "description": "The name by which this hierarchy node will 
                 be known.", 
               "pattern": "^[A-Za-z0-9_\\- ]+$", 
               "required": true, 
               "title": "Name", 
               "type": "string"
           }, 
           "node_type": {
               "choices": [], 
               "description": "A type label for this node which refers 
                 to a Hierarchy Node Type.", 
               "format": "uri", 
               "is_password": false, 
               "items": {
                   "is_password": false
               }, 
               "readonly": false, 
               "required": false, 
               "target": "/api/data/HierarchyNodeType/choices/?hierarchy=[hierarchy]", 
               "target_attr": "name", 
               "target_model_type": "data/HierarchyNodeType", 
               "title": "Hierarchy node type", 
               "type": "string"
           }
       }, 
       "schema_version": "0.1", 
       "type": "object"
     }, 

.. |VOSS Automate| replace:: VOSS Automate
.. |Unified CM| replace:: Unified CM
.. |API Guide| replace:: API Guide