---
# @generated by sylphx-gen. Do not edit.
title: "Serving routes"
description: "The `serving_routes` collection of Sylphx Hosting: One public HTTPRoute and every Host/path/backend it binds."
type: reference
product: hosting
summary: "One public HTTPRoute and every Host/path/backend it binds."
updated: 2026-09-28
order: 900
---

One public HTTPRoute and every Host/path/backend it binds. This is an owner read projection, including default deploy hosts without Domain records.

**Service** Sylphx Hosting · **Resource type** `hosting.sylphx.com/ServingRoute` · **Name pattern** `orgs/{org}/projects/{project}/envs/{env}/serving_routes/{serving_route}` · **Shape** `record`

## Fields

| Field | Type | What it is |
| --- | --- | --- |
| `name` | `string` | Tenant-scoped name of this route observation. |
| `uid` | `string` | Stable identity of the underlying route lifetime. Output only. |
| `meta` | `ResourceMeta` | Route generation and observation time. |
| `service` | `string` | Owning same-environment service. Output only. |
| `hostnames` | `string[]` | Full declared hostname population; wildcard values stay wildcard. Output only. |
| `rules` | `ServingRouteRule[]` | Every rule, including unsupported or unobserved ones. Output only. |
| `observed` | `bool` | True only when the owner has observed the current route generation. Output only. |

## Methods

Every method of the collection, in the registry's order, with the scope it
needs. The full request, response and examples are one link away.

| Method | Call | What it does |
| --- | --- | --- |
| `GET` | [`get`](/docs/api/serving_routes#get) | Gets an authorized public route observation. |
| `GET` | [`list`](/docs/api/serving_routes#list) | Lists every authorized public route; follow all pages in one snapshot. |

## get

Gets an authorized public route observation.

`GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/serving_routes/serving-route` · scope `hosting:read` · effect `read` · [Request, response and examples](/docs/api/serving_routes/get)

## list

Lists every authorized public route; follow all pages in one snapshot.

`GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/serving_routes` · scope `hosting:read` · effect `read` · paginated · [Request, response and examples](/docs/api/serving_routes/list)