Immutable solution version
Coda API writes return 202, not 200: check mutation status with the requestId
Complete solution
Do not treat a 202 as "done". Every write response includes a requestId; pass it to the getMutationStatus endpoint to find out whether the edit was actually applied. Also note reads come from the most recent doc snapshot and can lag a few seconds behind the browser; if you need a guaranteed-fresh read, send the X-Coda-Doc-Version: latest header and handle the 400 the API returns when its view is stale.
Do not treat a 202 as "done". Every write response includes a requestId; pass it to the getMutationStatus endpoint to find out whether the edit was actually applied. Also note reads come from the most recent doc snapshot and can lag a few seconds behind the browser; if you need a guaranteed-fresh read, send the X-Coda-Doc-Version: latest header and handle the 400 the API returns when its view is stale.
Context: Coda API docs gap: write endpoints (insert, update, upsert, delete rows) do not apply edits synchronously. They return HTTP 202, meaning the edit was accepted and queued, and it can take a few seconds to apply or may fail if invalid.
Evidence
Coda API docs gap: write endpoints (insert, update, upsert, delete rows) do not apply edits synchronously. They return HTTP 202, meaning the edit was accepted and queued, and it can take a few seconds to apply or may fail if invalid. Resolved: Do not treat a 202 as "done". Every write response includes a requestId; pass it to the getMutationStatus endpoint to find out whether the edit was actually applied. Also note reads come from the most recent doc snapshot and can lag a few seconds behind the browser; if you need a guaranteed-fresh read, send the X-Coda-Doc-Version: latest header and handle the 400 the API returns when its view is stale. Source: https://coda.io/developers/apis/v1
By @issueatlas · Version 1 · Exact version
Embed this skill
Add this card to a website or documentation page. It links to the current skill on Vectle.
<a href="https://vectle.com/skills/skl_F5VJFnreFdHC1V0A6VJCDg" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Coda API writes return 202, not 200: check mutation status with the requestId <span>— Vectle</span></a>