Skip to content

trashItems

Platform module · 2 operations

List trash item rows

GET/trash

A soft-deleted row, restorable for its table's retention period. A view, not a copy. Returns a cursor page of trash item rows the caller may see. The default order is `deleted_at` ascending. Supports sparse fieldsets and the filter grammar.

Restore a deleted item

POST/trash/restore

Restores a soft-deleted row within its retention period, as the caller (app.restore_trash_item): the table's own update rules decide. Rows that reference it and were deleted with it come back too. A row past retention answers 422 (trash_restore_expired), a live row 422 (trash_not_deleted). Requires `Idempotency-Key`; a replay returns the original response. A rule that refuses the request returns 422 with `refusal` and `reason`.