Method: namespaces.routes.list

List routes. Results are sorted by creation time, descending.

HTTP request

GET https://run.googleapis.com/apis/serving.knative.dev/v1/{parent}/routes

Path parameters

Parameters
parent

string

The namespace from which the routes should be listed. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID It takes the formnamespaces/{namespace}.

Authorization requires the followingIAM permission on the specified resourceparent:

  • run.routes.list

Query parameters

Parameters
limit

integer

Optional. The maximum number of records that should be returned.

includeUninitialized

boolean

Not currently used by Cloud Run.

fieldSelector

string

Allows to filter resources based on a specific value for a field name. Send this in a query string format. i.e. 'metadata.name%3Dlorem'. Not currently used by Cloud Run.

labelSelector

string

Allows to filter resources based on a label. Supported operations are =, !=, exists, in, and notIn.

resourceVersion

string

The baseline resource version from which the list or watch operation should start. Not currently used by Cloud Run.

watch

boolean

Flag that indicates that the client expects to watch this resource as well. Not currently used by Cloud Run.

continue

string

Optional. Encoded string to continue paging.

Request body

The request body must be empty.

Response body

ListRoutesResponse is a list of Route resources.

If successful, the response body contains data with the following structure:

JSON representation
{"apiVersion":string,"kind":string,"metadata":{object (ListMeta)},"items":[{object (Route)}],"unreachable":[string]}
Fields
apiVersion

string

The API version for this call such as "serving.knative.dev/v1".

kind

string

The kind of this resource, in this case always "RouteList".

metadata

object (ListMeta)

Metadata associated with this Route list.

items[]

object (Route)

List of Routes.

unreachable[]

string

Locations that could not be reached.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

For more information, see theAuthentication Overview.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-07-09 UTC.