GraphQL Changelog – July 2

Pipes now expose their trash through the API, so callers can list the cards deleted within the retention window.

Added:

  • The query deletedCards is 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 of DeletedCard nodes (max page size 50).
    • pipeId: ID! (required) — the pipe whose trash is listed.
    • Each DeletedCard node exposes id, title, deletedAt, expirationDate (the moment the card leaves the trash: deletedAt plus the 15-day retention window, computed, not stored), createdAt, createdBy (the user who created the card), and phaseName (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 a PERMISSION_DENIED error. An unknown pipeId — including the id of a database table — returns a RESOURCE_NOT_FOUND error.
  • 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.