---
title: "Test/Live Mode Conflict"
description: "The envelope mode in the request does not match your API key mode. Use a key of the same mode, or omit the mode property from the request."
canonical: "https://signatureapi.com/docs/v1/errors/mode-conflict"
source: "https://signatureapi.com/docs/v1/errors/mode-conflict.md"
last_verified_api_version: "1.18.0"
last_modified: "2026-11-18T11:41:57Z"
---

# Test/Live Mode Conflict

The envelope mode in the request does not match your API key mode. Use a key of the same mode, or omit the mode property from the request.

_Last verified against API version 1.18.0._

## What Happened

Either the client set `mode` to `test` in a create envelope request sent with a live API key, or the client set `mode` to `live` with a test API key. The `mode` of the request must match the mode of the API key.

Learn more about [test and live modes](https://signatureapi.com/docs/api/test-mode).

## Example response

```json 422 Unprocessable Content (application/problem+json)
{
  "type": "https://signatureapi.com/docs/v1/errors/mode-conflict",
  "title": "Mode Conflict",
  "status": 422,
  "detail": "A live-mode envelope cannot be created with a test-mode API key"
}
```

## How to Fix

- Use an API key of the mode you want, or change `mode` to match your key.
- Or remove `mode` from the request. The envelope then takes the mode of the API key.

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