Routes API

Delete a Particular Route

DELETE /v2/routes/:guid?recursive=true

Request

Route

DELETE /v2/routes/3fd654ee-7ba2-43db-aecb-0bbcb697c661?recursive=true

Parameters

Name Description Valid Values Example Values
guid The guid of the Route
recursive Will delete route service bindings and route mappings associated with the route.
  • true
  • false
async Will run the delete request in a background job. Recommended: 'true'.
  • true
  • false
 
recursive: true

Headers

Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTEzOCIsImVtYWlsIjoiZW1haWwtOTNAc29tZWRvbWFpbi5jb20iLCJzY29wZSI6WyJjbG91ZF9jb250cm9sbGVyLmFkbWluIl0sImF1ZCI6WyJjbG91ZF9jb250cm9sbGVyIl0sImV4cCI6MTQ2NjAwODg4OX0.F9Abfi-wusX9KT2ZCH6BlfrcmyLmV8S4VqCEvxDYr4E
Host: example.org
Content-Type: application/json
Cookie:

cURL

curl "https://api.[your-domain.com]/v2/routes/3fd654ee-7ba2-43db-aecb-0bbcb697c661?recursive=true" -d '' -X DELETE \
	-H "Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTEzOCIsImVtYWlsIjoiZW1haWwtOTNAc29tZWRvbWFpbi5jb20iLCJzY29wZSI6WyJjbG91ZF9jb250cm9sbGVyLmFkbWluIl0sImF1ZCI6WyJjbG91ZF9jb250cm9sbGVyIl0sImV4cCI6MTQ2NjAwODg4OX0.F9Abfi-wusX9KT2ZCH6BlfrcmyLmV8S4VqCEvxDYr4E" \
	-H "Host: example.org" \
	-H "Content-Type: application/json" \
	-H "Cookie: "

Response

Status

204 No Content

Headers

X-VCAP-Request-ID: 1cc8ad5c-62b9-4d12-b941-cae31d284e9a
X-Content-Type-Options: nosniff

Audit Records Created By The Request

Audit Record: audit.route.delete-request

Attribute Name Value
id 193
guid f68f17da-96c5-4649-97b6-6dcfda52b653
created_at 2016-06-08 16:41:29 UTC
updated_at
timestamp 2016-06-08 16:41:29 UTC
type audit.route.delete-request
actor uaa-id-138
actor_type user
actee 3fd654ee-7ba2-43db-aecb-0bbcb697c661
actee_type route
metadata 
{
  "request": {
    "recursive": true
  }
}
space_id
organization_guid 53661f5c-1a4f-45d0-8bfd-9d2560a324bc
space_guid 2e7209dd-587b-4bf1-adde-088c18335fbb
actor_name [email protected]
actee_name host-15