---
title: "Reconcile a source file with its WordPress document"
method: POST
path: "/v1/spaces/{spaceId}/content/sync/reconcile"
tags: ["Spaces"]
---

# Reconcile a source file with its WordPress document

`POST /v1/spaces/{spaceId}/content/sync/reconcile`

## Request

- Base URL: `https://api.spacefast.com`
- URL: `https://api.spacefast.com/v1/spaces/{spaceId}/content/sync/reconcile`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://api.spacefast.com/v1/auth/oauth2/authorize`, token URL `https://api.spacefast.com/v1/auth/oauth2/token`; client credentials, token URL `https://api.spacefast.com/v1/auth/oauth2/token`, scopes: `spaces:write`)

Three-way reconciles one bound source file against the post it backs, using the stored common base. The binding's format decides the serializer — Markdown or HTML. Answers with the new ledger, and with the text to write back when WordPress moved ahead.

## Path parameters

- `spaceId` string, required

## Request body

- union
  - object
    - `bindingId` string, required
    - `source` string, required
    - `text` string, required
    - `observedSourceRevision` string, required
    - `operationId` string, required
    - `state` 'initial', required
  - object
    - `bindingId` string, required
    - `source` string, required
    - `text` string, required
    - `observedSourceRevision` string, required
    - `operationId` string, required
    - `state` 'bound', required
    - `baseRevision` string, required

## Response `200`

Response for status 200

- object
  - `$schema` string, uri: Canonical JSON Schema URL for this response body. The server also sends it in the `Link: rel="describedby"` response header.
  - `data` union, required
    - object
      - `format` 'spacefast.content-sync', required
      - `version` 1, required
      - `operationId` string, required
      - `ledger` object, required
        - `version` 1, required
        - `bindingId` string, required
        - `source` string, required
        - `format` 'md' | 'html' | 'blocks' | 'tsx', required
        - `baseText` string, required
        - `textDigest` string, required
        - `blocksDigest` string, required
        - `metadataDigest` string
        - `wordpressRevisionId` integer, required
        - `serializerVersion` 1, required
        - `revision` string, required
        - `lastDirection` 'push' | 'pull', required
      - `status` 'created', required
    - object
      - `format` 'spacefast.content-sync', required
      - `version` 1, required
      - `operationId` string, required
      - `ledger` object, required
        - `version` 1, required
        - `bindingId` string, required
        - `source` string, required
        - `format` 'md' | 'html' | 'blocks' | 'tsx', required
        - `baseText` string, required
        - `textDigest` string, required
        - `blocksDigest` string, required
        - `metadataDigest` string
        - `wordpressRevisionId` integer, required
        - `serializerVersion` 1, required
        - `revision` string, required
        - `lastDirection` 'push' | 'pull', required
      - `status` 'unchanged', required
    - object
      - `format` 'spacefast.content-sync', required
      - `version` 1, required
      - `operationId` string, required
      - `ledger` object, required
        - `version` 1, required
        - `bindingId` string, required
        - `source` string, required
        - `format` 'md' | 'html' | 'blocks' | 'tsx', required
        - `baseText` string, required
        - `textDigest` string, required
        - `blocksDigest` string, required
        - `metadataDigest` string
        - `wordpressRevisionId` integer, required
        - `serializerVersion` 1, required
        - `revision` string, required
        - `lastDirection` 'push' | 'pull', required
      - `status` 'pushed', required
    - object
      - `format` 'spacefast.content-sync', required
      - `version` 1, required
      - `operationId` string, required
      - `ledger` object, required
        - `version` 1, required
        - `bindingId` string, required
        - `source` string, required
        - `format` 'md' | 'html' | 'blocks' | 'tsx', required
        - `baseText` string, required
        - `textDigest` string, required
        - `blocksDigest` string, required
        - `metadataDigest` string
        - `wordpressRevisionId` integer, required
        - `serializerVersion` 1, required
        - `revision` string, required
        - `lastDirection` 'push' | 'pull', required
      - `status` 'pulled', required
      - `sourceWrite` object, required
        - `state` 'prepared', required
        - `source` string, required
        - `expectedSourceRevision` string, required
        - `text` string, required
        - `textDigest` string, required

## Other responses

- `default`: Problem details (RFC 9457). Any 4xx/5xx response is one `application/problem+json` document.

---

[API](https://skmtc.dev/spacefast/apis/spacefast-api.md) · [All operations](https://skmtc.dev/spacefast/apis/spacefast-api/llms.txt) · [OpenAPI document](https://skmtc.dev/spacefast/apis/spacefast-api/revisions/bd165bc7c983?raw)