first API docs
(swagger syntax)