Use the Partner Rebuild API

The Partner Rebuild API lets you send a website URL to Nova to automatically recreate that site. Nova accepts the request immediately and runs the rebuild process in the background. When the process finishes, Nova sends a completion callback to your registered webhook endpoint.

Authentication#

Authenticate your requests with the following HTTP headers:

Submit a rebuild request#

POST /api/integration/partners/cpanel/rebuilds

Request body#

{
  "sourceUrl": "https://example.com",
  "prompt": "Optional custom instructions for the rebuild"
}

Example request#

curl -X POST "https://<nova-api-domain>/api/integration/partners/cpanel/rebuilds" \
  -H "Content-Type: application/json" \
  -H "X-Partner-Id: <partner-company-id>" \
  -H "X-API-Key: <partner-rebuild-api-key>" \
  -d '{
    "sourceUrl": "https://customer-site.example",
    "prompt": "Modernize the website while preserving the business identity."
  }'

Responses#

New rebuild request#

Nova returns 202 Accepted when you create a new rebuild request.

{
  "requestId": "rebuild_01JZ8Y2R4S3T6V7W8X9Y0Z",
  "projectId": "8wwnkg-lzs06y-3ewtwx",
  "status": "running"
}

Existing rebuild request#

If you submit the same sourceUrl value again, Nova returns 200 OK with the existing request instead of starting a new rebuild.

{
  "requestId": "rebuild_01JZ8Y2R4S3T6V7W8X9Y0Z",
  "projectId": "8wwnkg-lzs06y-3ewtwx",
  "status": "success",
  "previewUrl": "https://8wwnkg-lzs06y-3ewtwx.nova.example.com"
}

Response fields#

Idempotency#

Nova handles rebuild requests as idempotent per partner and source URL: if you submit the same sourceUrl value again, Nova returns the existing rebuild request rather than starting a new one. Changing the prompt value does not create a new rebuild if you submitted the same sourceUrl value.

Rate limiting#

Requests are rate-limited to 30 per hour per partner by default. If you exceed the limit, Nova returns an error:

{
  "message": "Rate limit exceeded",
  "error": {
    "code": "RATE_LIMIT_EXCEEDED"
  }
}

Completion callback#

Nova sends a webhook callback when the rebuild reaches a final state. Callbacks use the Partner Webhooks delivery system and go to your configured webhook endpoint.

Event type: partner_project_rebuild_completed

Successful callback payload#

{
  "event_type": "partner_project_rebuild_completed",
  "request_id": "rebuild_01JZ8Y2R4S3T6V7W8X9Y0Z",
  "partner_id": 42,
  "project_id": "8wwnkg-lzs06y-3ewtwx",
  "source_url": "https://customer-site.example",
  "status": "success",
  "preview_url": "https://8wwnkg-lzs06y-3ewtwx.nova.example.com"
}

Failed callback payload#

{
  "event_type": "partner_project_rebuild_completed",
  "request_id": "rebuild_01JZ8Y2R4S3T6V7W8X9Y0Z",
  "partner_id": 42,
  "project_id": "8wwnkg-lzs06y-3ewtwx",
  "source_url": "https://customer-site.example",
  "status": "failed",
  "error_code": "process_failed",
  "error_message": "Partner project recreation process failed"
}

Callback fields#

Assign a rebuild to a customer#

If the rebuild request is successful, Nova stores the project temporarily under a system account. You can assign the rebuild to a customer using a magic link or the admin panel.

Assign a rebuild with a magic link#

Generate custom magic links to give your customers seamless access to rebuild projects. Nova will only assign the rebuild if the payload’s status value is success and the projectId value matches a rebuild on your account. Otherwise, Nova will ignore the payload and the customer will sign in normally.

To attach a completed rebuild to a customer’s magic link:

1. Copy the projectId value from the rebuild response and use it to create the following key=value pair, where projectID represents the projectId value: rebuildId=projectId For example, rebuildId=8wwnkg-lzs06y-3ewtwx.
2. Encode that entire string using Base64. For example, cmVidWlsZElkPTh3d25rZy1senMwNnktemV3dHd4.
3. Set the promptToken value in your magic link to this encoded string. For example, promptToken=cmVidWlsZElkPTh3d25rZy1senMwNnktemV3dHd4.

When the customer opens the magic link and logs in, Nova takes them directly to the new rebuild project.

Assign a rebuild from the admin panel#

You can use the admin panel to assign a rebuild to an existing user directly. You can only assign rebuilds that have a status value of success.

To assign a rebuild from the admin panel:

1. Log in to your admin panel and navigate to the Partner Rebuilds section.
2. Find the rebuild that you want to assign.
3. Select Clone to user and choose the target user.

Nova creates a new copy of the rebuild project and assigns it to the selected user. This action will not affect the original rebuild project and preview URL in your admin panel.

Error handling#