GraphQL Changelog – July 2
July 9th, 2026 by ReadMe API
Pipes now expose their trash through the API, so callers can list the cards deleted within the retention window.
Added:
- The query
deletedCardsis available. It lists the pipe's soft-deleted cards that are still inside the trash retention window (15 days), most recently deleted first, as a paginated connection ofDeletedCardnodes (max page size 50).pipeId: ID!(required) — the pipe whose trash is listed.- Each
DeletedCardnode exposesid,title,deletedAt,expirationDate(the moment the card leaves the trash:deletedAtplus the 15-day retention window, computed, not stored),createdAt,createdBy(the user who created the card), andphaseName(the name of the phase the card was in when it was deleted).
Notes:
- The query requires pipe admin permission (
manage). A caller without it receives aPERMISSION_DENIEDerror. An unknownpipeId— including the id of a database table — returns aRESOURCE_NOT_FOUNDerror. - Cards whose source phase was itself deleted are not listed, and neither are cards deleted more than 15 days ago — even though their rows still exist, they are considered outside the trash.
- Listing is read-only: restoring a card from the trash ships as a separate operation.

