Home
Version 3
Spaces API

Spaces API

Delete a Particular Space

DELETE /v2/spaces/:guid?

Request

Route

DELETE /v2/spaces/70cabe29-0347-4af0-aafc-e13c00c45802?

Parameters

Name Description Valid Values Example Values
guid The guid of the Space
recursive Will delete all apps, services, routes, and service brokers associated with the space
  • true
  • false
async Will run the delete request in a background job. Recommended: 'true'.
  • true
  • false

Headers

Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTM1OSIsImVtYWlsIjoiZW1haWwtMjUzQHNvbWVkb21haW4uY29tIiwic2NvcGUiOlsiY2xvdWRfY29udHJvbGxlci5hZG1pbiJdLCJhdWQiOlsiY2xvdWRfY29udHJvbGxlciJdLCJleHAiOjE0NjYwMDg5MDB9.jeyyotVyOPWc-JiYpRXsyIa1uVky_SW4tNbPuvy0Sus
Host: example.org
Content-Type: application/x-www-form-urlencoded
Cookie: 

cURL

curl "https://api.[your-domain.com]/v2/spaces/70cabe29-0347-4af0-aafc-e13c00c45802?" -d '' -X DELETE \
	-H "Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTM1OSIsImVtYWlsIjoiZW1haWwtMjUzQHNvbWVkb21haW4uY29tIiwic2NvcGUiOlsiY2xvdWRfY29udHJvbGxlci5hZG1pbiJdLCJhdWQiOlsiY2xvdWRfY29udHJvbGxlciJdLCJleHAiOjE0NjYwMDg5MDB9.jeyyotVyOPWc-JiYpRXsyIa1uVky_SW4tNbPuvy0Sus" \
	-H "Host: example.org" \
	-H "Content-Type: application/x-www-form-urlencoded" \
	-H "Cookie: "

Response

Status

204 No Content

Headers

X-VCAP-Request-ID: 5923eec0-0519-4d74-a660-c61a2a4af811
X-Content-Type-Options: nosniff

Audit Records Created By The Request

Audit Record: audit.space.delete-request

Attribute Name Value
id 2
guid f3c05441-f252-4599-be5a-caf654105421
created_at 2016-06-08 16:41:40 UTC
updated_at
timestamp 2016-06-08 16:41:40 UTC
type audit.space.delete-request
actor uaa-id-359
actor_type user
actee 70cabe29-0347-4af0-aafc-e13c00c45802
actee_type space
metadata
{
  "request": {
    "recursive": false
  }
}
space_id
organization_guid 564d3369-db51-4ce8-8751-2ed38791cec6
space_guid 70cabe29-0347-4af0-aafc-e13c00c45802
actor_name [email protected]
actee_name name-2053