---
title: "Duplicate Document Key"
description: "Two documents in the same envelope share a key. Give every document a unique key, check the detail for the repeated one, and resubmit."
canonical: "https://signatureapi.com/docs/v1/errors/duplicate-document-key"
source: "https://signatureapi.com/docs/v1/errors/duplicate-document-key.md"
last_verified_api_version: "1.18.0"
last_modified: "2026-11-18T11:41:57Z"
---

# Duplicate Document Key

Two documents in the same envelope share a key. Give every document a unique key, check the detail for the repeated one, and resubmit.

_Last verified against API version 1.18.0._

## What Happened

Each document in an envelope needs a unique `key`. Your request uses a `key` that another document in the same envelope already has. The `detail` property names the repeated key.

## Example response

```json 409 Conflict (application/problem+json)
{
  "type": "https://signatureapi.com/docs/v1/errors/duplicate-document-key",
  "title": "Duplicate Document Key",
  "status": 409,
  "detail": "Each document must have a unique key. The key agreement is already in use. Please use a different key."
}
```

## How to Fix

- Give each document its own `key`.
- Find the repeated key in the `detail`, then change it in your `documents` array.
- See [documents](https://signatureapi.com/docs/api/resources/documents/object) for what the `key` property does.

Still stuck? [Contact support](https://signatureapi.com/support).
