GET /trash

Details #

Deleting a macro in the editor moves it to Recently Deleted instead of erasing it. It stays there for 30 days, then the engine erases it.

Returns a list, newest first. Each item has the macro as it was (the same shape as in GET /macros), deletedAt, and groupName, the name of the group it was deleted from.

curl -s -H "Authorization: Bearer $TOKEN" http://127.0.0.1:48080/trash

[
  {
    "macro": { "id": "m_4f2a9c", "name": "Paste ticket as title", "group": "g_work", "enabled": true, "when": [], "onlyIf": [], "do": [] },
    "deletedAt": "2026-10-25T09:12:40Z",
    "groupName": "Work"
  }
]

Parameters #

curl --unix-socket "$SWITCHBOARD_HOME/engine.sock" -X GET http://localhost/trash

The macros in Recently Deleted, newest first. The Unix socket needs no token; loopback 127.0.0.1:48080 needs Authorization: Bearer <api-token>.

Gotchas #

• A trashed macro never fires and does not appear in GET /macros.

• The file's id is the macro's id: pass it to restore or delete it for good.

See also #

• POST /trash/{id}/restore

• DELETE /trash/{id}