List a document's children

GET/v1/workspaces/{workspaceId}/children

Lists the direct children of a document (or the top level when parentId is omitted) in order, each with its number of live children. Use it to load a tree level by level.

docs:readRead-only

Request

curl "https://api.lydie.co/v1/workspaces/01JCQ3TZ0WJ8K4M2X7T9R6N1PA/children" \
  -H "Authorization: Bearer $LYDIE_TOKEN"

Path parameters

workspaceIdstringrequired· 1–64 chars

Query parameters

parentIdULID
Omit for the top level.
includeDeletedboolean
Default false

Response

entriesChildEntry[]
Show 14 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
- childCountinteger
  Live children, so a tree can show a disclosure.
- teamspaceIdstringor nulloptional
- privateOwnerIdstringor nulloptional

200

{
  "entries": [
    {
      "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,
      "childCount": 0,
      "teamspaceId": null,
      "privateOwnerId": null
    }
  ]
}

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