Skip to main content

Endpoint

Use this endpoint to create a new generation for a tent that already has at least one completed or in-progress version.
POST /v1/tents/{tentId}/edit is asynchronous. It queues a new generation and returns immediately with a new generation_id.

Request Body

Request Example

Response Example

202 Accepted

Important Behavior

The tent must already exist

Edits only work for tents that already have a generation history. If the tent exists but has never been generated, the API returns:

Asset references stay on the same tent

If you pass asset_ids, each asset must already belong to the same tentId. Missing assets return 404 Not Found.

Auto-publish rules match create

If custom_page_alias is present, you must also set auto_publish: true. Alias rules are the same as POST /v1/tents:
  • Maximum 100 characters
  • Lowercase letters, numbers, hyphens, underscores, and dots only
  • Must start with a letter or number
  • Must not be a UUID
  • Must not use reserved words such as api, admin, submit, or assets
  • Use / to publish at the domain root

Credits

Editing checks workspace credits before the generation is queued. If the workspace cannot cover the edit, the API returns 429 Too Many Requests.

Clone a Tent

Duplicate a tent — its latest content and assets — into a brand-new tent. The clone starts unpublished; publish it separately once you’re ready. Optionally send {"name": "..."} to name the copy; otherwise it defaults to "Copy of {name}".

Response Example

201 Created

Common Errors

Next: Retrieve Tent Status

Poll the tent until the new generation completes or fails.