Documentation

Discard the "note that some endpoints". For a first time user, it's more confusing than anything, and anyway with a standard use he should not encounter the situation.