Unpublishing Tents - Tented Help Center

Endpoint

POST /v1/tents/{tentId}/unpublish

Use this endpoint to take a published tent offline while keeping the tent and its generation history in Tented.

Request Example

curl --request POST \
  --url https://api.tented.ai/v1/tents/f11ef3cf-8664-4fe5-a261-c5b4d647b7d1/unpublish \
  --header "Authorization: Bearer $TENTED_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{}'

Response Example

{
  "id": "f11ef3cf-8664-4fe5-a261-c5b4d647b7d1",
  "status": "draft",
  "updated_at": "2026-04-08T12:50:00.000Z",
  "message": "Tent unpublished successfully"
}

Important Behavior

Unpublishing clears the public publication projection returned by GET /v1/tents/{tentId}
The tent remains in Tented and can be published again later
If the tent had a custom alias, that alias reservation is removed from the live published surface

Common Errors

Status	Cause
`400 Bad Request`	`tentId` is missing or not a valid UUID
`401 Unauthorized`	Missing or invalid bearer token
`404 Not Found`	The tent does not exist
`409 Conflict`	The tent’s mutation lease is briefly held — another publication is in progress, or a manual edit or a generation’s final commit is landing at that moment. Retry shortly. A running generation does not otherwise block publishing (you publish the latest completed version)

Back: Publish Tents

Review manual publishing behavior and alias handling.