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

# Idempotency

> Retry a create request without creating a duplicate method.

`POST /api/methods` and `POST /api/workflow-uploads` require `idempotency_key` in the body.
The MCP tool `create_workflow` requires the same key.

```json theme={null}
{ "idempotency_key": "customer-4821-recording-17" }
```

## Rules

* Create one key for one logical request. Use 8 to 200 characters.
* Store the key before the first request.
* Reuse it after a timeout, a disconnect, or an uncertain response.
* Use a new key for a new source.

A repeated key returns the same method with `created: false` and status `200`.
The API stores only the SHA-256 of the key. `GET /api/workflow-creation-requests/<sha256>` returns `{ found, method }` for a key.

## Retry a build

A failed build is retried on the same method with `POST /api/methods/:id/retry`.
Do not send a new key to retry a build.