---
title: Agent Deployment URI Prefix
description: Overrides the request URL given by the agent, when the agent is configured behind a load balancer or proxy. Use this property when the protocol, hostname, or port of the load balancer or proxy differ from those of the agent.
component: web-agents
version: 2025.11
page_id: web-agents:properties-reference:com.sun.identity.agents.config.agenturi.prefix
canonical_url: https://docs.pingidentity.com/web-agents/2025.11/properties-reference/com.sun.identity.agents.config.agenturi.prefix.html
---

# Agent Deployment URI Prefix

Overrides the request URL given by the agent, when the agent is configured behind a load balancer or proxy. Use this property when the protocol, hostname, or port of the load balancer or proxy differ from those of the agent.

At least one of the following properties must be enabled:

* [Enable Override Request URL Port](com.sun.identity.agents.config.override.port.html)

* [Enable Override Request URL Protocol](com.sun.identity.agents.config.override.protocol.html)

* [Enable Override Request URL Host](com.sun.identity.agents.config.override.host.html)

Use these properties only if you are not using `x-forwarded` headers from the load balancer or proxy to override the agent's protocol, hostname, and port values.

Default: `agent-root-URL`

|                    |                                                                                |
| ------------------ | ------------------------------------------------------------------------------ |
| Property name      | `com.sun.identity.agents.config.agenturi.prefix`   Introduced in Web Agent 4.x |
| Function           | Profile                                                                        |
| Type               | String                                                                         |
| Bootstrap property | No                                                                             |
| Required property  | No                                                                             |
| Restart required   | No                                                                             |
| AM console         | Tab: `Global`Title: `Agent Deployment URI Prefix`                              |