Regenerate a Zapsite

POST

/v2/zap-sites/{id}/regenerate

Regenerates the ZapSite's copy via AI, or rolls back to a previous copy version.
Path params

Field	Type	Required
`id`	string (UUID)	Yes

Request body

Field	Type	Required	Notes
`versionId`	integer	No	If provided, rolls back to this copy version number instead of generating new copy. Must be a positive integer that exists in this ZapSite's version history.
`notes`	string	No	Max 4000 chars. Guidance for what should change; ignored when `versionId` is passed.
`campaign_context`	string	No	Overrides the campaign context for this regeneration; ignored when `versionId` is passed.

Request

Path Params

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200Success

application/json

Bodyapplication/json

🟠404Version not Found

🟠422Invalid versionId

🟠404Zapsite Not Found

Request Example

Shell

JavaScript

Java

Swift

cURL

Regenerate New CopyRoll Back to a Prior Version

curl --location 'https://api.zapmail.ai/api/v2/zap-sites//regenerate' \
--header 'x-auth-zapmail: YOUR_API_KEY' \
--header 'x-workspace-id: workspace_123' \
--header 'x-service-provider: GOOGLE' \
--header 'Content-Type: application/json' \
--data '{
    "notes": "Make the headline punchier and lead with the ROI stat."
}'

Response Example

200 - Regenerate Success

{
    "status": 202,
    "message": "Page regeneration started",
    "data": {
        "id": "5b1e0c2a-4f3e-4a9d-9c7c-6a2b6e1a7d10",
        "status": "GENERATING",
        "version": 2,
        "lastError": null,
        "updatedAt": "2026-09-04T10:40:00.000Z"
    }
}

Modified at 2026-09-07 11:26:09

Edit a Zapsite

Deploy a Zapsite