Skip to content
LydieDevelopers
Menu

Resolve a diverged document

View as Markdown
POST/v1/publications/{id}/resolve

Settles a document that changed both in Lydie and at the destination. overwrite publishes the Lydie version over the remote edits. keepRemote accepts the destination's version as published without changing the document. pull merges the remote edits into the document (connectors that can pull) and publishes the result; a merge conflict leaves it diverged.

docs:writeCannot be undone
Request
curl -X POST "https://api.lydie.co/v1/publications/01JCQ3V5MZ8G4ZK2X7T9R6N1PB/resolve" \
  -H "Authorization: Bearer $LYDIE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "documentId": "01JCQ3V5MZ8G4ZK2X7T9R6N1PB",
    "resolution": "overwrite"
  }'

Path parameters

  • idULIDrequired

Body

Response

200
{
  "run": {
    "id": "01JCQ3V5MZ8G4ZK2X7T9R6N1PB",
    "publicationId": "01JCQ3V5MZ8G4ZK2X7T9R6N1PB",
    "action": "publish",
    "trigger": "manual",
    "options": {},
    "status": "queued",
    "attempt": -9007199254740991,
    "runAt": "2026-11-12T09:30:00.000Z",
    "steps": [
      {
        "at": "2026-11-12T09:30:00.000Z",
        "step": "string",
        "status": "ok",
        "documentId": "01JCQ3V5MZ8G4ZK2X7T9R6N1PB",
        "ms": 0,
        "detail": {}
      }
    ],
    "summary": null,
    "error": null,
    "requestedBy": "string",
    "createdAt": "2026-11-12T09:30:00.000Z",
    "startedAt": null,
    "finishedAt": null
  }
}

Errors use one envelope for every endpoint. See Errors and versions.