> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mesh.larkwave.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Idempotency

> Retry any create without making it twice.

Every `POST` that creates something or moves money needs an `Idempotency-Key` header: customers, wallets, virtual accounts, verifications, transfers and settlements. Use a fresh unique value per operation; a UUID works.

```bash theme={null}
curl https://$MESH_HOST/v1/transfers/internal \
  -H "X-Api-Key: $MESH_KEY" \
  -H "Idempotency-Key: 5d6f0c64-6b2c-4b1e-9f4e-2f9a7a1c3e10" \
  -H "Content-Type: application/json" \
  -d '{ "source_account_number": "6037000001", "destination_account_number": "6037000004", "amount_minor": 500000 }'
```

| You send | You get |
| - | - |
| A new key | The operation runs |
| The same key, same body | The first result again, with `Idempotent-Replayed: true`. Nothing runs twice |
| The same key, a different body | `409`, code `53` |
| No key | `400`, code `54` |

> [!TIP]
>
> When a create times out or answers `502`, `503` or `504`, send it again with the **same** key. Either it ran and you get its result, or it runs now: never both.

Keys are scoped to your business and mode, so they never collide with another business's.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.