Skip to main content

​
dedupe_key

dedupe_key deduplicates semantically identical jobs in a 24-hour window.
  • Scope: account + key
  • Ignores already failed jobs
  • If matched, API returns existing job 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 job with deduplicated: true

​
Difference

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

​
cURL examples

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