Unmapping an App from a Route will cause traffic matching the Route to no longer be forwarded to the App.
The App may still receive traffic from an unmapped Route for a small period of time while the traffic rules on the gateways are propagated.
The Route will re-balance its routing weights so other Apps mapped to it will receive the traffic. If no other Apps are bound the Route will return a 404 HTTP status code.
Examples
# Unmap myapp.example.com from myapp in the targeted Space
kf unmap-route myapp example.com --hostname myapp
# Unmap the Route in a specific Space
kf unmap-route --space myspace myapp example.com --hostname myapp
# Unmap a Route with a path
kf unmap-route myapp example.com --hostname myapp --path /mypath
Flags
--async
Do not wait for the action to complete on the server before returning.
--destination-port=int32
Port on the App the Route will connect to.
-h, --help
help for unmap-route
--hostname=string
Hostname for the Route.
--path=string
URL path for the Route.
Inherited flags
These flags are inherited from parent commands.
--as=string
Username to impersonate for the operation.
--as-group=strings
Group to impersonate for the operation. Include this flag multiple times to specify multiple groups.
--config=string
Path to the Kf config file to use for CLI requests.
--kubeconfig=string
Path to the kubeconfig file to use for CLI requests.
--log-http
Log HTTP requests to standard error.
--space=string
Space to run the command against. This flag overrides the currently targeted Space.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[],[],null,["# kf unmap-route\n\n### Name\n\n`kf unmap-route` - Revoke an Apps's access to receive traffic from the Route.\n\n### Synopsis\n\n```\nkf unmap-route APP_NAME DOMAIN [--hostname HOSTNAME] [--path PATH] [flags]\n```\n\n### Description\n\nUnmapping an App from a Route will cause traffic matching the Route to no longer be forwarded to the App.\n\nThe App may still receive traffic from an unmapped Route for a small period of time while the traffic rules on the gateways are propagated.\n\nThe Route will re-balance its routing weights so other Apps mapped to it will receive the traffic. If no other Apps are bound the Route will return a 404 HTTP status code.\n\n### Examples\n\n```\n # Unmap myapp.example.com from myapp in the targeted Space\n kf unmap-route myapp example.com --hostname myapp\n \n # Unmap the Route in a specific Space\n kf unmap-route --space myspace myapp example.com --hostname myapp\n \n # Unmap a Route with a path\n kf unmap-route myapp example.com --hostname myapp --path /mypath\n```\n\n### Flags\n\n`--async`\n: Do not wait for the action to complete on the server before returning.\n\n`--destination-port=`\u003cvar translate=\"no\"\u003eint32\u003c/var\u003e\n: Port on the App the Route will connect to.\n\n`-h, --help`\n: help for unmap-route\n\n`--hostname=`\u003cvar translate=\"no\"\u003estring\u003c/var\u003e\n: Hostname for the Route.\n\n`--path=`\u003cvar translate=\"no\"\u003estring\u003c/var\u003e\n: URL path for the Route.\n\n### Inherited flags\n\nThese flags are inherited from parent commands.\n\n`--as=`\u003cvar translate=\"no\"\u003estring\u003c/var\u003e\n: Username to impersonate for the operation.\n\n`--as-group=`\u003cvar translate=\"no\"\u003estrings\u003c/var\u003e\n: Group to impersonate for the operation. Include this flag multiple times to specify multiple groups.\n\n`--config=`\u003cvar translate=\"no\"\u003estring\u003c/var\u003e\n: Path to the Kf config file to use for CLI requests.\n\n`--kubeconfig=`\u003cvar translate=\"no\"\u003estring\u003c/var\u003e\n: Path to the kubeconfig file to use for CLI requests.\n\n`--log-http`\n: Log HTTP requests to standard error.\n\n`--space=`\u003cvar translate=\"no\"\u003estring\u003c/var\u003e\n: Space to run the command against. This flag overrides the currently targeted Space."]]
