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 App'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\nlonger be forwarded to the App.\n\nThe App may still receive traffic from an unmapped Route for a small period\nof 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\nwill receive the traffic. If no other Apps are bound the Route will return\na 404 HTTP status code.\n\n### Examples\n\n```\n# Unmap myapp.example.com from myapp in the targeted Space\nkf unmap-route myapp example.com --hostname myapp\n\n# Unmap the Route in a specific Space\nkf unmap-route --space myspace myapp example.com --hostname myapp\n\n# Unmap a Route with a path\nkf unmap-route myapp example.com --hostname myapp --path /mypath\n```\n\n### Flags\n\n`--async`\n\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\n: Port on the App the Route will connect to.\n\n`-h, --help`\n\n: help for unmap-route\n\n`--hostname=`\u003cvar translate=\"no\"\u003estring\u003c/var\u003e\n\n: Hostname for the Route.\n\n`--path=`\u003cvar translate=\"no\"\u003estring\u003c/var\u003e\n\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\n: Username to impersonate for the operation.\n\n`--as-group=`\u003cvar translate=\"no\"\u003estrings\u003c/var\u003e\n\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\n: Path to the Kf config file to use for CLI requests.\n\n`--kubeconfig=`\u003cvar translate=\"no\"\u003estring\u003c/var\u003e\n\n: Path to the kubeconfig file to use for CLI requests.\n\n`--log-http`\n\n: Log HTTP requests to standard error.\n\n`--space=`\u003cvar translate=\"no\"\u003estring\u003c/var\u003e\n\n: Space to run the command against. This flag overrides the currently targeted Space."]]
