Sign in

v61

latestOpenAPI 3.1.0Apache 2.0raw.githubusercontent.com2026-08-018131,3812.6 MB
Routes

Upsert a Route associated with a Service

Create or Update a Route associated with a Service using ID or name.

put/v2/control-planes/{controlPlaneId}/core-entities/services/{ServiceId}/routes/{RouteId}

Path parameters

ServiceIdstring required

ID of the Service to lookup

RouteIdstring required

ID of the Route to lookup

Request body

OR

Example request

{
  "hosts": [
    "foo.example.com",
    "foo.example.us"
  ],
  "id": "56c4566c-14cc-4132-9011-4139fcbbe50a",
  "name": "example-route",
  "paths": [
    "/v1",
    "/v2"
  ],
  "service": {
    "id": "bd380f99-659d-415e-b0e7-72ea05df3218"
  }
}

Response

Successfully upserted Route

OR

Example response

{
  "hosts": [
    "foo.example.com",
    "foo.example.us"
  ],
  "id": "56c4566c-14cc-4132-9011-4139fcbbe50a",
  "name": "example-route",
  "paths": [
    "/v1",
    "/v2"
  ],
  "service": {
    "id": "bd380f99-659d-415e-b0e7-72ea05df3218"
  }
}