Skip to main content
POST
Publish a help center theme design
Omit confirmed_tracking_losses on the first call. A 422 with code theme_tracking_confirmation_required leaves the current version live and lists the affected features in tracking_losses. Values are search_results for submitted search results and their clicks, and article_feedback for helpfulness votes. After the editor explicitly accepts the losses, repeat the request for the same revisions with that exact list in confirmed_tracking_losses. A 400 naming a conditional search or feedback control means the comparison could not determine whether tracking is preserved. Simplify the condition around that control in the named template, preview the draft, and publish the new revision. Publishing checks sample pages against the site’s current content in each language. A 400 with code theme_page_check_failed includes the page title, language (locale), localized preview path (page), template, and reason in issue. The reason is missing_article_body or render_failed. Correct the draft, preview that path, then publish the new revision.

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
design_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)$
revision_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)$
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)$