# TAG_KEY_INVALID

Canonical page: https://docs.ovok.com/errors/tag-key-invalid

**HTTP 422.** Problem type: [`https://docs.ovok.com/errors/tag-key-invalid`](https://docs.ovok.com/errors/tag-key-invalid).

## What this means [#what-this-means]

A tag filter's key is not alphanumeric. A filter is sent as `tags.<key>=<value>` or `tags[<key>]=<value>`, and `<key>` may hold only letters and digits. Nothing was read.

## Troubleshooting [#troubleshooting]

1. Read `detail`. It names the key that was refused.
2. Use the tag's key as stored, letters and digits only, with no dots, dashes or spaces.

## Retry safely [#retry-safely]

Fix the key and send the query once. Unchanged, it fails again.

## If the problem persists [#if-the-problem-persists]

Share the HTTP status, problem `type`, request path, response timestamp and `traceId` with your administrator or support contact. Remove access tokens, provider secrets and patient data first. The [Error responses guide](/errors) explains the response fields, and the [machine-code registry](/errors/machine-codes) lists every endpoint-specific type.
