Endpoint
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 passasset_ids, each asset must already belong to the same tentId. Missing assets return 404 Not Found.
Auto-publish rules match create
Ifcustom_page_alias is present, you must also set auto_publish: true.
Alias rules are the same as POST /v1/tents:
- Maximum
100characters - 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, orassets - 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 returns429 Too Many Requests.
Clone a Tent
{"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.