---
title: "PUT /api/v1/internal/landing-designs/sync"
method: PUT
path: "/api/v1/internal/landing-designs/sync"
tags: ["Internal", "Affiliation"]
---

# PUT /api/v1/internal/landing-designs/sync

`PUT /api/v1/internal/landing-designs/sync`

Idempotently synchronizes the complete Landing Pages design manifest and, unless an authenticated deployment defers it, queues a differential reconciliation of every Landing Pages cache projection.

## Headers

- `authorization` string, required

## Request body

- object
  - `cacheRefresh` 'deferred'
  - `designs` object[], required
    - `code` string, required
    - `contentContract` object
      - `allowsLandingContent` boolean, required
      - `designCode` string, required
      - `images` object[], required
        - `aspectRatio` string, nullable, required
        - `compatibleComponents` string[], required
        - `compatibleDesigns` string[], required
        - `description` string, required
        - `example` string, required
        - `format` 'plain_text' | 'rich_text' | 'https_url', required
        - `key` string, required
        - `required` boolean, required
        - `type` 'string', required
      - `translations` object[], required
        - `aspectRatio` string, nullable, required
        - `compatibleComponents` string[], required
        - `compatibleDesigns` string[], required
        - `description` string, required
        - `example` string, required
        - `format` 'plain_text' | 'rich_text' | 'https_url', required
        - `key` string, required
        - `required` boolean, required
        - `type` 'string', required
      - `version` 1, required
    - `english` object, required
    - `kind` 'landing' | 'checkout' | 'offer' | 'component', required
    - `name` string, nullable

## Response `200`

The complete design manifest was synchronized atomically.

- object
  - `activated` integer, required
  - `disabled` integer, required
  - `disabledFunnels` integer, required
  - `disabledOffers` integer, required
  - `englishLocalesChanged` integer, required
  - `status` 'complete', required

## Other responses

- `400` — The design manifest is invalid.
- `401` — The deployment credential is invalid.
- `409` — The manifest conflicts with active catalog relations.
- `503` — Landing Design synchronization is unavailable.

---

[API](https://skmtc.dev/expertschat/apis/billing-core-api.md) · [All operations](https://skmtc.dev/expertschat/apis/billing-core-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/expertschat/billing-core-api/revisions/c6d0e986ce32/schema)
