---
title: Idempotency keys
description: Retry mutation requests only when the public contract says it is safe.
---

> **Not yet available for public mutations** — the current contract does not define an `Idempotency-Key` request header.

Do not assume that repeating a `POST` is safe. If a response is lost, inspect the operation outcome before retrying. This page will document key lifetime and replay behavior when the header becomes part of the public contract.

[Open the published OpenAPI JSON](/openapi.json) to verify the headers accepted by an operation, or read the [developer API map](/developers/public-api).