Zones

Fetch Zone Changes (deprecated)

Get all changed zones relative to a meta-sync token. Deprecated by Apple in favor of changes/database (fetchDatabaseChanges), which returns the same "which zones changed" information. New code should use changes/database.

post/database/{version}/{container}/{environment}/{database}/zones/changes

Path parameters

versionstring required

Protocol version

containerstring required

Container ID (begins with "iCloud.")

environment'development' | 'production' required

Container environment

database'public' | 'private' | 'shared' required

Database scope

Request body

metaSyncTokenstring

The metaSyncToken returned by a previous zones/changes response. Omit it to fetch every zone. Verified against a live container (issue #430): this operation reads and returns metaSyncToken, not syncToken. A request sending syncToken is silently ignored and replays the first page. Apple's archived reference names the key metaSyncToken as well; only one line of its moreComing prose calls it syncToken. This is specific to zones/changes — changes/database, changes/zone and records/changes all use syncToken.

Response

Zone changes retrieved successfully

metaSyncTokenstring

Identifies a point in the database's change history. Send it back as metaSyncToken on the next request to fetch only newer changes.

moreComingboolean