Skip to content

[D2] Document the ecommerce product events endpoint (Preview) - #719

Merged
rkaahean merged 1 commit into
mainfrom
ranjansrinivas/document-ecommerce-product-events
Oct 14, 2026
Merged

rkaahean merged 1 commit into
mainfrom
ranjansrinivas/document-ecommerce-product-events

Conversation

@rkaahean

@rkaahean rkaahean commented Oct 14, 2026 •

Copy link
Copy Markdown
Contributor

Why?

Ecommerce connectors can now send single product changes (created, updated, deleted) instead of re-uploading the whole catalog, so product answers stay current between full uploads. The endpoint is available in Preview but isn't in the spec, so developers can't find it or see how to call it.

How?

Adds the events operation to the Preview spec next to the catalog upload, with request examples for each event type, the error responses, and the rules for events that arrive out of order.

Notes for reviewers

The request schema keeps data.product and data.product_id as optional properties of one object instead of a oneOf per event type. Which field each type needs is stated in the field and operation descriptions, and the API rejects a mismatched event with 400 invalid_event. A one-schema-per-type split would turn the request into a union in generated SDKs for a rule the server already enforces.

Generated with Claude Code

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@rkaahean
rkaahean marked this pull request as ready for review October 14, 2026 08:12
@rkaahean
rkaahean merged commit 1e67771 into main Oct 14, 2026
5 checks passed
@rkaahean
rkaahean deleted the ranjansrinivas/document-ecommerce-product-events branch October 14, 2026 10:16
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.

2 participants