Just a note from my experience - I was happy to figure out the row update API can accept the canonical field_N names to reference columns if you don’t use the user_field_names parameter. This wasn’t immediately clear to me from the API docs / examples but was a welcome capability since I’m trying only use the canonical field names to reference columns in my application.
(technically I use a Python Enum to hide them behind my own friendly names like
class SometableFields(Enum):
NAME = field_123
URL = field_124
url = row[SometableFields.URL.value]
I agree that the source you linked to is much more informative and I think it would be helpful if that same information could be reflected in the generated docs. I’ve only seen the docs you reference once after searching for information about file uploads - it might also be helpful to link to these more official docs from the Introduction section in the generated docs.
Yeah probably a good idea. The generated docs are a bit simplified, not providing full documentation, but they try to present things in more beginner/user-friendly way.