clarify write api