Get a document

GET/v1/documents/{id}

Returns a document's metadata and, unless includeBody is false, its Markdown body.

Request

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

Path parameters

idULIDrequired

Query parameters

includeBodyboolean
Default true

Response

documentDocument
Document metadata. The body is not part of it.
Show 11 fieldsHide fields
- idULID
- workspaceIdstring· 1–64 chars
- parentIdULIDor null
- titlestring· 1–255 chars
- sortKeystring· 1–256 chars
- propertiesobject
- createdAttimestamp
- updatedAttimestamp
- deletedAttimestampor null
- createdBystringor nulloptional· ≥ 1 chars
- updatedBystringor nulloptional· ≥ 1 chars
bodyDocumentBodyor null
Show 2 fieldsHide fields
- markdownstring
- versionstring
  Opaque content version; pass it as expectedVersion.

200

{
  "document": {
    "id": "01JCQ3V5MZ8G4ZK2X7T9R6N1PB",
    "workspaceId": "01JCQ3TZ0WJ8K4M2X7T9R6N1PA",
    "parentId": null,
    "title": "Meeting notes",
    "sortKey": "a0",
    "properties": {
      "status": "draft"
    },
    "createdAt": "2026-11-12T09:30:00.000Z",
    "updatedAt": "2026-11-12T09:30:00.000Z",
    "deletedAt": null,
    "createdBy": null,
    "updatedBy": null
  },
  "body": null
}

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