Glen Aultman-Bettridge
08/12/2026, 9:40 PMkapa.ai
08/12/2026, 9:40 PM{} stream state that still causes the same error. If this happens, proceed to Option 2 or 3. [GitHub Issue]
Option 2: Overwrite the state directly via API If the reset doesn't fully clear the state, you can overwrite it manually using the internal API:
POST /api/v1/state/create_or_update
{
"connectionId": "<your-connection-id>",
"connectionState": {
"stateType": "global",
"connectionId": "<your-connection-id>",
"globalState": { "shared_state": {}, "streamStates": [] }
}
}
This empties the offset and forces the next sync to re-snapshot. [GitHub Issue]
> ⚠️ Note: On Airbyte Cloud, this endpoint may return a 403 for API application tokens, and the public API exposes no state mutation. [GitHub Issue]
Option 3: Delete and recreate the connection If neither of the above works (especially on Airbyte Cloud), deleting and recreating the connection is the most reliable workaround, since state is keyed to the connection ID. The first sync after recreation will perform the initial CDC snapshot successfully. [GitHub Issue]
After resolving the state issue Once CDC is running, make sure to configure it properly to avoid future failures:
• Set up a Debezium heartbeat query to prevent WAL disk consumption issues on low-traffic databases. [Postgres Troubleshooting]
• Tune wal_keep_size (PG 13+) to retain enough WAL history between syncs. [Postgres Troubleshooting]
• Run syncs frequently enough to keep the replication slot current. 👍 0 button 👎 0 button ℹ️ Tip: Mention @kapa.ai in the thread for follow-ups or DM the app for 1-to-1 help.