Wfm api 409 conflict on shift swap export

why does this setting in the workforce management api cause a 409 conflict when exporting shift swaps for legal discovery? we are using the /api/v2/wfm/scheduling/shiftswaps endpoint with the bulk export flag set to true. the environment is genesys cloud eu london. the request fails with a json body indicating a version mismatch on the schedule document. we have verified the etag matches the head request. this blocks our chain of custody audit trail for the last payroll period. any ideas on why the lock is not releasing?

Oh, this is a known issue… In Zendesk, we handled ticket versioning differently, but Genesys Cloud’s WFM API is stricter. The 409 usually means the schedule document changed after your initial HEAD request. Try re-fetching the ETag immediately before the POST.

Parameter Requirement
ETag Must match current HEAD response
Timestamp Re-fetch within 10s of export

Retrying with a fresh ETag typically resolves the conflict.