---
title: Handle Invalid Escape Sequences
description: When set to true any attempt to URL encode a control character (range %00-%1F inclusive, or %7F) will be rejected with an HTTP 400 response.
component: java-agents
version: 2025.11
page_id: java-agents:properties-reference:org.forgerock.agents.reject.invalid.escape.sequences.enabled
canonical_url: https://docs.pingidentity.com/java-agents/2025.11/properties-reference/org.forgerock.agents.reject.invalid.escape.sequences.enabled.html
---

# Handle Invalid Escape Sequences

When set to `true` any attempt to URL encode a control character (range %00-%1F inclusive, or %7F) will be rejected with an HTTP 400 response.

Invalid encodings, such as %G1 will also be rejected, although these should already have been rejected by the container.

|                          |                                                                                                   |
| ------------------------ | ------------------------------------------------------------------------------------------------- |
| Property name            | `org.forgerock.agents.reject.invalid.escape.sequences.enabled`                                    |
| Aliases                  | `org.forgerock.agents.reject.invalid.escape.sequences.enabled`   Introduced in Java Agent 2024.11 |
| Function                 | Configure behaviour                                                                               |
| Type                     | Boolean: `true` returns true; all other strings return `false`.                                   |
| Default                  | `true`                                                                                            |
| Bootstrap property       | No                                                                                                |
| Required property        | No                                                                                                |
| Restart required         | No                                                                                                |
| Local configuration file | `AgentConfig.properties`                                                                          |