---
title: "Route"
description: "one ingress route: a host and path prefix forwarded to one listener, over TLS"
section: concepts
address: /concepts/route
contract: 0476e35e6e275db5
---

# Route

one ingress route: a host and path prefix forwarded to one listener, over TLS

[figure: Route is a definition at platform scope. The drawing shows its fields and the objects that they point at.]

| property | value |
|---|---|
| kind | definition |
| scope | platform |
| key | the host and the path prefix |
| store | postgres |
| family | network |



## Fields


| field | type | required | note |
|---|---|---|---|
| `host` | `text` | yes |  |
| `path_prefix` | `text` | yes |  |
| `backend` | [Listener](/concepts/listener) | yes | only an api-gateway listener may be a backend |
| `tls` | [Certificate](/concepts/certificate) | yes |  |
| `keeps_open_streams_on_change` | `bool` | yes | a route change must not drop a long-lived stream |
| `rate_limit` | [RateLimit](/concepts/ratelimit) | no |  |



## Routes that use it
No route takes or returns Route directly. The record holds it, and the objects that point at it reach it.