Idempotency

Send an Idempotency-Key with create requests and side-effecting actions:

Idempotency-Key: import-crm-batch-2026-08-24-001

FluxDigest stores the first result for at least 24 hours. A retry with the same credential, route, key, and request body returns that result instead of running the operation again.

Choosing a key

Use a stable identifier for the logical operation, not a timestamp generated on every retry. UUIDs work when generated once and persisted with the job. Business identifiers work when they are unique and contain no sensitive information.

await fluxdigest.campaigns.send(
  "cmp_123",
  { workspaceId: "ws_123" },
  { idempotencyKey: "weekly-digest-2026-W35" },
);

Reusing a key with different input returns 409 idempotency_key_reused. The SDK automatically generates keys for retryable high-impact methods when a caller does not provide one, but explicit persisted keys are safer across process restarts.