The format of the representation to post to the URL may be XML or JSON.

Here is the basic structure in JSON:

{
  "name": "",
  "value": "",
  "controls": "",
  "position": ""
}

Only the following position values are allowed:

1. replace-or-add - replaces an existing property or - if it does not exist - add it (default)
2. replace - replaces an existing property
3. merge - merges the information into an existing property

Since version 3.1 also the following positions are supported:

1. merge-values - merges the information into an existing property and looks at the property as a list of properties and tries to integrate the given values into the existing list; duplicates are not added
2. delete-values - merges the information into an existing property and looks at the property as a list of properties and tries to remove values from the list

For these list values the following macros are supported:

1. Name List Macro (Names parameter)
   
2. Tag List Macro (Names parameter)
   
3. Name Body List Macro (body)
   
4. Tag Body List Macro (body)
   
5. Parent Property Macro (Parent Doctype parameter)