Reviewing request history
Look back at requests you've sent, replay them and turn them into new drafts.
Overview
Relay records every request you send, with its response, in History. Requests that fail are recorded too; requests you cancel aren't. A WebSocket connection is recorded when it closes, with its messages.
History belongs to Relay rather than to a workspace: the History section of the sidebar lists the same entries in every window, newest first. It's stored only on your Mac, and Relay encrypts the parts of each entry that can hold secrets, such as credentials, cookies, the URL, headers and parameters as they were sent, script output and stream events.
Find a past request
In the sidebar, scroll to History. Each entry shows the request's URL. The section lists the 20 newest entries; click Show More at the end of the list to see the rest.
To find an entry, enter part of its URL in the Filter field at the bottom of the sidebar.
Look at a past request
Select an entry in History. The request editor shows the request in cards: its parameters and headers as they were sent, with variables filled in and the headers that authentication, cookies and Relay's defaults added, then its body. The response inspector shows the response it got.
An entry can't be edited. To work with its request, send it again or turn it into a draft.
Replay a request
Select the entry, then click Send or press Command-Return. Relay sends the request again, with its variables filled in from their current values, and records the result as a new entry. The original entry doesn't change.
A recorded WebSocket connection can't be replayed. To connect again, open the original request.
Turn a past request into a draft
Select the entry, then click the Edit as New Draft button at the end of the URL bar, or choose Request > Convert to Draft. Relay creates a draft with the request as you wrote it, along with its response, and opens it in the request editor.
You can also Control-click an entry and choose Duplicate. The new draft has the request but not its response.
To view an entry in a separate window, Control-click it and choose Open in New Window.
Delete history
To delete one entry, select it and press Delete, or Control-click it and choose Delete. To get it back, choose Edit > Undo.
To delete every entry, hold the pointer over the History heading in the sidebar, click the History Options button (…), choose Clear All History, then click Clear History. You can also open the History pane of Relay > Settings and click Clear… next to Clear All History.
Important
Choose how much history to keep
Relay keeps the 100 newest entries and deletes older ones as new requests arrive. To keep more or fewer, open the History pane of Relay > Settings and change Max History Entries, from 10 to 500. Lowering it deletes the oldest entries right away.
See Also
- Sending, stopping, and replaying requests: Send a request, stop one that's in progress and send a past request again.
- Inspecting responses: Read a response's status, body and headers, and copy or save what you need.
- Creating and managing requests: Keep requests as drafts or save them in collections, and rename, duplicate and open them in their own windows.
- Configuring Relay settings: Change Relay's defaults for requests, networking, history, code export and the MCP server.