better docs + status codes