Idempotency - wondeya

Network retries happen (a request times out, a function re-runs), and a blind retry of a create makes a second agent, or spends a second chat credit. An Idempotency-Key makes a retry replay the first response instead.

Use it

Send any unique string on any POST under /v1; every one honours it (creates, publish and unpublish, knowledge adds, topic merges, asset uploads, the JSON chat turn):

curl -X POST $WDY/agents \
  -H "Authorization: Bearer $WDY_KEY" \
  -H "Idempotency-Key: a1b2c3-create-support" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Support" }'

Retry with the SAME key and the SAME body, and you get the first response back, unchanged, with:

Idempotent-Replayed: true

No second agent is created, and no second credit is spent.

The rules

Situation	Result
Same key, same body	The first response is replayed (`Idempotent-Replayed: true`).
Same key, different body	`422` `wondeya.idempotency.conflict`: a key names one request.
Same key while the first is still running	`409`.
The first request failed	Not stored; retry the same key freely.

A key is scoped to your API key and kept for 24 hours. It is honoured in the JSON chat mode; a streamed (SSE) turn cannot be replayed, so the key is ignored there.