List the trash

GET/v1/workspaces/{workspaceId}/trash

Lists what is in a workspace's trash, newest first. A document deleted with its subtree is one item; restoring it restores the subtree.

docs:readRead-only

Request

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

Path parameters

workspaceIdstringrequired· 1–64 chars

Query parameters

limitinteger· 1–500
Default 100

Response

itemsTrashItem[]
Show 8 fieldsHide fields
- kindstring
  One ofdocumentattachment
- idULID
- workspaceIdstring· 1–64 chars
- titlestring
  Document title or attachment filename.
- parentIdULIDor null
  Where a document goes back to on restore, if still there.
- deletedAttimestamp
- deletedBystringor null· ≥ 1 chars
- descendantCountinteger
  Documents trashed together with it.

200

{
  "items": [
    {
      "kind": "document",
      "id": "01JCQ3V5MZ8G4ZK2X7T9R6N1PB",
      "workspaceId": "01JCQ3TZ0WJ8K4M2X7T9R6N1PA",
      "title": "Meeting notes",
      "parentId": null,
      "deletedAt": "2026-11-12T09:30:00.000Z",
      "deletedBy": null,
      "descendantCount": 0
    }
  ]
}

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