updated database API documentation