# idempotency_key_required

> Writes need an idempotency key of 8–128 characters (A–Z a–z 0–9 . _ : -), for example one UUID per intended action.

Source: https://x.builera.app/docs/en/errors/idempotency_key_required

| | |
|---|---|
| HTTP status | 428 |
| Safe to retry | No |
| Message (fixed, English) | This write needs an idempotency key (8–128 characters). |

## What to do {#what-to-do}

Writes need an idempotency key of 8–128 characters (A–Z a–z 0–9 . _ : -), for example one UUID per intended action.

## Error shape {#body}

```json
{
  "code": "idempotency_key_required",
  "message": "This write needs an idempotency key (8–128 characters).",
  "retryable": false,
  "request_id": "req_…"
}
```

Can be returned by 83 operations

[All error codes](/docs/en/errors)