template api documentation is great, but there are a few things that could make it more clear :

• https://www.zabbix.com/documentation/3.2/manual/api/reference/template/massremove has parameters "templateids", "hostids", "templateids_clear" and "templateids_link".
  the "hostids" parameter actually includes both template and host ids. while a careful reader can decypher all these, it would be a bit easier if some of them had linkage direction specified, for example :
  "Hosts or templates to unlink the given templates from." -> "Hosts or templates to unlink the given templates from (downstream)."
  "Templates to unlink and clear from the given templates." -> "Templates to unlink and clear from the given templates (upstream)."
  "Templates to unlink from the given templates." -> "Templates to unlink from the given templates (upstream)."

• https://www.zabbix.com/documentation/3.2/manual/api/reference/template/create
  for the "groups" and "templates" parameters, it is clarified that they "...must have the groupid property defined" - but this note is missing for the "hosts" parameter in the same table (as can be seen in the example below, that is the case)

it would be great if these could be applied to all the api documentation versions