Skip to main content

​
Endpoint

DELETE /v1/tents/{identifier}
identifier can be:
  • The tent UUID
  • The current published alias for that tent
  • __index__ for a tent published at the domain root

​
Request Examples

Delete by UUID: 
curl --request DELETE \
  --url https://api.tented.ai/v1/tents/f11ef3cf-8664-4fe5-a261-c5b4d647b7d1 \
  --header "Authorization: Bearer $TENTED_API_KEY"
Delete by alias: 
curl --request DELETE \
  --url https://api.tented.ai/v1/tents/launch-page \
  --header "Authorization: Bearer $TENTED_API_KEY"
Delete a root-page tent: 
curl --request DELETE \
  --url https://api.tented.ai/v1/tents/__index__ \
  --header "Authorization: Bearer $TENTED_API_KEY"

​
Response Example

{
  "message": "Tent deleted successfully",
  "tent_id": "f11ef3cf-8664-4fe5-a261-c5b4d647b7d1"
}

​
What Gets Removed

Deleting a tent removes the tent record and its related public artifacts, including:
  • Uploaded tent assets
  • Published page assets for that tent
  • Alias reservations for published pages
  • Form submission delivery configs tied to the tent
  • Scheduled automations associated with the tent

​
Identifier Rules

  • If you use a UUID, it must be a valid v4 tent ID
  • If you use an alias, it must match the same alias validation rules as publishing
  • For the root page, use __index__ in the path segment

​
Common Errors

StatusCause
400 Bad RequestThe identifier is empty or not a valid tent ID / alias
401 UnauthorizedMissing or invalid bearer token
404 Not FoundNo tent in the workspace matches that UUID or alias

Back to API Overview

Review the full public API endpoint map.