Responses

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

Clearing all history can't be undone.

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