Idempotency

curl -X POST https://api.alguna.io/invoices \
  -H "Authorization: Bearer $ALGUNA_API_KEY" \
  -H "Alguna-Version: 2026-04-01" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: ik_create_invoice_cust123_20260330" \
  -d '{ "customer_id": "cust_abc123" }'

import os

import requests

response = requests.post(
    "https://api.alguna.io/invoices",
    headers={
        "Authorization": f"Bearer {os.environ['ALGUNA_API_KEY']}",
        "Alguna-Version": "2026-04-01",
        "Content-Type": "application/json",
        "Idempotency-Key": "ik_create_invoice_cust123_20260330",
    },
    json={"customer_id": "cust_abc123"},
    timeout=10,
)
response.raise_for_status()
invoice = response.json()
replayed = response.headers.get("Idempotent-Replayed") == "true"

const invoice = await alguna.invoices.create(
  { customer_id: "cust_abc123" },
  { idempotencyKey: "ik_create_invoice_cust123_20260330" },
);