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

# Idempotency

> Safely retry requests without creating duplicate jobs.

## Overview

Include an `Idempotency-Key` header when creating a video job. If a request with the same key is made again (e.g. after a network timeout), the API returns the **existing job** instead of creating a new one.

## Usage

```bash theme={null}
curl -X POST https://hypergate.store/v1/videos \
  -H "Authorization: Bearer <your-token>" \
  -H "Idempotency-Key: my-unique-key-001" \
  -H "Content-Type: application/json" \
  -d '{ "model": "...", "prompt": "..." }'
```

## Rules

* The key can be any string — a UUID or a meaningful identifier works well
* The key is scoped to your team token (another team using the same key is unaffected)
* If the key matches an existing job, the original job is returned regardless of the request body
* There is no expiry — keys are stored for the lifetime of the job