Idempotency and versions

The API version is part of every URL, as in /api/v1. The Changelog lists every change.

Safe retries

The API does not support an Idempotency-Key header. If you are not sure whether a change went through, read the item before you send it again.

Some updates accept expectedVersion or expectedDraftHash. If the item has changed since you read it, the request fails with 409. Read the item again, then decide whether to retry.

A successful response with cacheExpiryQueued: true means the change was saved, but other reads may show the old value for a short time. Do not send the change again.