idempotency (#282)

2025-11-17 11:42:09 +11:00
parent eacf231173
commit cb489654b5
14 changed files with 859 additions and 1118 deletions
@@ -37,6 +37,19 @@ resp, _ = client.emails.send(payload={
    "html": "<strong>Hi!</strong>",
 })

+# Idempotent retries: same payload + same key returns the original response
+resp, _ = client.emails.send(
+    payload=payload,
+    options={"idempotency_key": "signup-123"},
+)
+
+# Works for batch requests as well
+resp, _ = client.emails.batch(
+    payload=[payload],
+    options={"idempotency_key": "bulk-welcome-1"},
+)
+# If the same key is reused with a different payload, the API responds with HTTP 409.
+
 # 3) Campaigns
 campaign_payload: types.CampaignCreate = {
    "name": "Welcome Series",