API: documentation for namespaces added

Documentation for namespaces API added, with short descriptions and list of possible return codes.