Update docs to reduce inconsistent type compatibility in api/