Request History
Restroom records every request you send. History is stored on disk alongside each room and is never sent anywhere.
Global history screen
The History screen (clock icon in the left toolbar) shows a unified timeline across all rooms. Each entry shows the method, URL, room name, status code, response time, and when it was sent.
Filtering
Use the filter menu to narrow the list:
- Method — select one or more HTTP methods (GET, POST, etc.)
- Status — filter by status class (2xx, 3xx, 4xx, 5xx, Error)
- Room — show entries from specific rooms only
Multiple values can be selected within each filter — for example, 4xx and 5xx together to see all error responses.
Search
The search box filters by URL or request name as you type.
Per-request history
Each request has its own history tab, accessible from the top toolbar in the editor. This shows only the history for that specific request, which is useful for seeing how responses have changed over time as you develop an API.
Comparing responses
To compare two responses:
- Hover over any entry and click Compare — this marks it as A.
- Hover over a second entry and click Compare — this marks it as B.
- Click View Diff in the banner at the top.
The diff view shows a line-by-line comparison of the two response bodies. JSON responses are formatted before diffing so structural differences are clear.
Loading into the editor
Hover over an entry and click Load to restore the full request (method, URL, headers, and body) into your active tab. If the tab has unsaved changes, you'll be asked to confirm.
Retention settings
Control how much history is kept in Settings → Global → History:
- Max entries per request — oldest entries are pruned when this is exceeded (default: 200)
- Retention period — entries older than this are deleted on load (default: 30 days)
History is pruned in the background when the history screen loads — it doesn't block the UI.