Skip to main content

​
dedupe

dedupe deduplicates semantically identical actions in a 24-hour window.
  • Scope: account + key
  • Ignores already failed actions
  • If matched, API returns existing action with deduplicated: true

​
Typical use cases

  • Prevent duplicate invoice processing
  • Avoid repeated outbound notifications
  • Suppress duplicate user-triggered operations

​
Idempotency-Key header

Idempotency-Key deduplicates repeated create requests in a 24-hour window.
  • Scope: account + header value
  • Works even if body is retried by the client unchanged
  • Returns existing action with deduplicated: true

​
Difference

Business-level dedupe: “these actions mean the same thing”.

​
cURL examples

curl -X POST http://localhost:3000/v1/actions \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/work",
    "body": {"invoice_id":"inv_123"},
    "dedupe": "invoice:inv_123"
  }'