update request API v2 - WriteMode and autorename ?

Thanks for the feedback! I think I understand the confusion, and we'll look at how we can reword.

I'd say the documentation is accurate, if a bit confusing to read. I'd also say you understand the semantics correctly.

Think of it like a method taking parameters:

"/files/upload takes a parameter called mode (a WriteMode) and one called autorename (a boolean). The mode parameter determines what constitutes a conflict and a corresponding autorenaming strategy. In the case of a conflict, the autorename parameter determines whether that autorenaming strategy should be employed or the call should simply fail with an error."

So it's true that WriteMode defines an autorename strategy.

None of this takes away from your point that this is hard to understand from reading the documentation in its current form. I think that's because the documentation sort of mixes parameters, behaviors, and types. The documentation on WriteMode is about that structure/type, so it knows nothing about the autorename parameter, and it wouldn't make sense to mention it there.