Skip to content
LydieDevelopers
Menu

Publish now

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

Queues a run that publishes what changed: unchanged documents are skipped (content hash), remote edits are detected and pulled back or shown as a divergence, never overwritten. force republishes unchanged documents. scheduledAt runs it later. A waiting run absorbs repeated requests.

docs:write
Request
curl -X POST "https://api.lydie.co/v1/publications/01JCQ3V5MZ8G4ZK2X7T9R6N1PB/run" \
  -H "Authorization: Bearer $LYDIE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

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.