better 404 error message, updated API docs & testing