Home
Version 3
Routes API

Routes API

Check a Route exists

GET /v2/routes/reserved/domain/:domain_guid/host/:host?path=:path

This endpoint returns a status code of 204 if the route exists, and 404 if it does not.

Request

Route

GET /v2/routes/reserved/domain/7db6cd2d-df33-4ef8-aa6e-8a3916357e27/host/host-13?path=/apps/v1/path

Parameters

Name Description Valid Values Example Values
domain_guid The guid of a domain
host The host portion of the route
path The path of a route
  • /apps/v1/path
  • /apps/v2/path
 
path: /apps/v1/path

Headers

Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTIzMSIsImVtYWlsIjoiZW1haWwtMTY3QHNvbWVkb21haW4uY29tIiwic2NvcGUiOlsiY2xvdWRfY29udHJvbGxlci5hZG1pbiJdLCJhdWQiOlsiY2xvdWRfY29udHJvbGxlciJdLCJleHAiOjE0NTM4MzcyNzJ9.rCVcFDTHwzOOHNkI2ZJir91FrLXVX4V2u_LrUYmm8sk
Host: example.org
Cookie:

cURL

curl "https://api.[your-domain.com]/v2/routes/reserved/domain/7db6cd2d-df33-4ef8-aa6e-8a3916357e27/host/host-13?path=/apps/v1/path" -X GET \
	-H "Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTIzMSIsImVtYWlsIjoiZW1haWwtMTY3QHNvbWVkb21haW4uY29tIiwic2NvcGUiOlsiY2xvdWRfY29udHJvbGxlci5hZG1pbiJdLCJhdWQiOlsiY2xvdWRfY29udHJvbGxlciJdLCJleHAiOjE0NTM4MzcyNzJ9.rCVcFDTHwzOOHNkI2ZJir91FrLXVX4V2u_LrUYmm8sk" \
	-H "Host: example.org" \
	-H "Cookie: "

Response

Status

204 No Content

Headers

X-VCAP-Request-ID: 
X-Content-Type-Options: nosniff