Skip to main content
POST
Restore a published theme or the original
A restore compares the reviewed version with the current live design. If it would lose search reporting or helpfulness votes, the response is 422 with code theme_tracking_confirmation_required and a tracking_losses list. After the editor explicitly accepts the losses, repeat the same restore with those values in confirmed_tracking_losses. Restoring tracking requires no confirmation. Restoring a saved revision checks its templates against current content in each language. A 400 with code theme_page_check_failed includes the affected title, locale, localized preview path (page), template, and reason in issue. Repair a private draft based on that revision, preview the affected page, then publish the repaired draft. You can restore the site’s original design by passing null. If the response is 400 and names a conditional control, the comparison could not verify that version. You can choose another published version or publish a draft with the affected search or feedback control outside the condition.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string<uuid>
required
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Body

application/json
revision_id
string<uuid> | null
required

A previously published revision, or null for the original design.

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
expected_live_revision_id
string<uuid> | null
required
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
confirmed_tracking_losses
enum<string>[]

On explicit approval, repeat the exact tracking_losses returned by the 422 for the reviewed revisions. Omit on the first attempt.

Maximum array length: 2
Available options:
search_results,
article_feedback

Response

Default Response

live_revision_id
string<uuid> | null
required
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$