joao::api - defined set_read