Clarify that Row IDs are returned in the same order/index as the rows added

[activescott]

WRT

api-docs/openapi/swagger.json

Line 99 in dc2d69f

"description": "Row IDs of added rows, e.g.,\n\n```json\n[\n\t\"2a1bad8b-cf7c-44437-b8c1-e3782df6\",\n\t\"93a19-cf7c-44437-b8c1-e9acbbb\"\n]\n```"

I assume that I can map the index of the row added in the rquest to the index of the row ID in the response, is that correct? If so, we should clarify. If not, how can we map a row ID to the input row?

Also we should clarify what happens when one row of a batch fails to get added. Is it a different status code? Is the whole batch failed, or did some of the rows get added? What is in rowID response? How do I read the descriptive error message about why it failed to add, etc. etc.

[rwdaigle]

Agreed.

re: unknownColumns option: https://github.com/glideapps/glide/issues/28119