Get a publication

GET/v1/publications/{id}

A publication with the state of each published document.

Request

curl "https://api.lydie.co/v1/publications/01JCQ3V5MZ8G4ZK2X7T9R6N1PB" \
  -H "Authorization: Bearer $LYDIE_TOKEN"

Path parameters

idULIDrequired

Response

publicationPublication
Show 15 fieldsHide fields
- idULID
- workspaceIdstring· 1–64 chars
- connectionIdULID
- connectorstring
- documentIdULID
- includeSubpagesboolean
- filterobjector null
  Publish only documents whose property equals this (lists: contains it).
  Show 2 fieldsHide fields
  propertystring· 1–128 chars
  equalsany
- configobject
- autoPublishboolean
- lastRunAttimestampor null
- itemsPublicationItem[]
  Show 9 fieldsHide fields
  idULID
  documentIdULID
  statestring
  One ofdraftscheduledpublishingpublishedupdated_pendingfailedunpublisheddiverged
  externalIdstringor null
  externalUrlstringor null
  lastPublishedAttimestampor null
  lastErrorobjector null
  divergenceobjector null
  For diverged items: reason, base/ours/theirs (destination format), conflicts, marked text and the pull request.
  updatedAttimestamp
- createdBystringor null
- updatedBystringor null
- createdAttimestamp
- updatedAttimestamp

200

{
  "publication": {
    "id": "01JCQ3V5MZ8G4ZK2X7T9R6N1PB",
    "workspaceId": "01JCQ3TZ0WJ8K4M2X7T9R6N1PA",
    "connectionId": "01JCQ3V5MZ8G4ZK2X7T9R6N1PB",
    "connector": "string",
    "documentId": "01JCQ3V5MZ8G4ZK2X7T9R6N1PB",
    "includeSubpages": false,
    "filter": null,
    "config": {},
    "autoPublish": false,
    "lastRunAt": null,
    "items": [
      {
        "id": "01JCQ3V5MZ8G4ZK2X7T9R6N1PB",
        "documentId": "01JCQ3V5MZ8G4ZK2X7T9R6N1PB",
        "state": "draft",
        "externalId": null,
        "externalUrl": null,
        "lastPublishedAt": null,
        "lastError": null,
        "divergence": null,
        "updatedAt": "2026-11-12T09:30:00.000Z"
      }
    ],
    "createdBy": null,
    "updatedBy": null,
    "createdAt": "2026-11-12T09:30:00.000Z",
    "updatedAt": "2026-11-12T09:30:00.000Z"
  }
}

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