Skip to content

Add INKBOX_SKIP_WEBHOOK_RECONCILE for pre-provisioned subscriptions - #43

Merged
alex-w-99 merged 1 commit into
mainfrom
feat/skip-webhook-reconcile
Aug 7, 2026
Merged

Add INKBOX_SKIP_WEBHOOK_RECONCILE for pre-provisioned subscriptions#43
alex-w-99 merged 1 commit into
mainfrom
feat/skip-webhook-reconcile

Conversation

@alex-w-99

Copy link
Copy Markdown
Contributor

On start the bridge points the identity's mailbox, phone number, and iMessage events at whatever URL it just came up on, installing its own webhook subscriptions. That is the right default when the bridge owns its ingress.

It is the wrong default when subscriptions are provisioned ahead of time. There the destination is already fixed, and the API key the bridge runs with may not be permitted to change it — so the write is redundant at best, and at worst the reason startup never completes.

What changed

  • INKBOX_SKIP_WEBHOOK_RECONCILE, default false, resolved through the existing env_flag helper and carried on BridgeConfig as skip_webhook_reconcile.
  • When set, _patch_identity_objects returns early and logs the URL it expects deliveries to already be pointed at.

Behavior

Unchanged unless opted in. Unset, empty, or unrecognized values all leave reconciliation on.

When enabled, the subscriptions must already deliver to this bridge's webhook URL. If they do not, nothing arrives, and the log line names the URL that was expected.

Testing

  • pytest tests/ — 468 passed, 23 skipped.
  • New tests/test_gateway_skip_webhook_reconcile.py: skipping performs no API calls (the fake raises on any subscription call or identity read), not skipping still reconciles, the default config reconciles, and the truthy/falsy spellings resolve as documented.

Version bumped to 0.2.10 and the environment table updated.

On start the bridge points the identity's mailbox, phone number, and iMessage
events at whatever URL it just came up on. That is the right default when the
bridge owns its ingress, but not when subscriptions are provisioned ahead of
time: there the destination is already fixed, and the API key may not be
permitted to change it, so the write is redundant at best and fatal to startup
at worst.

Default false, so nothing changes unless a deployment opts in.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@alex-w-99
alex-w-99 marked this pull request as ready for review August 7, 2026 23:42
@alex-w-99
alex-w-99 merged commit 1a22e39 into main Aug 7, 2026
11 checks passed
@alex-w-99
alex-w-99 deleted the feat/skip-webhook-reconcile branch August 7, 2026 23:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant