Creating and managing requests
Keep requests as drafts or save them in collections, and rename, duplicate and open them in their own windows.
Overview
Every request in Relay is either a draft or part of a collection:
- Drafts: Requests you haven't filed yet. Drafts are kept on your Mac between launches, and the Drafts section of the sidebar lists them in every window, whichever workspace the window shows. A draft uses its workspace's variables, auth and settings, but not those of a collection or folder.
- Collection requests: Requests saved in a collection, or in a folder inside one. They belong to the collection's workspace and inherit the variables, auth, scripts and settings of their collection and folders.
Start with a draft when you're trying something out, and save it to a collection once it's worth keeping. You can turn a collection request back into a draft at any time.
Create a draft
Choose File > New Draft Request, or press Shift-Command-N. You can also click New Draft at the end of the Drafts section in the sidebar, or click the Add button (+) at the bottom of the sidebar and choose New Draft.
The draft appears in the Drafts section of the sidebar and opens in the request editor. It uses the default method, which you can change in the Requests pane of Relay > Settings.
When a window has no request selected, the request editor shows an empty request. It becomes a draft as soon as you edit or send it.
To create a WebSocket request instead, choose File > New WebSocket Draft, or press Option-Shift-Command-N. For more information, see Connecting to a WebSocket server.
Create a request in a collection
In the sidebar, Control-click a collection or folder and choose New Request. The new request opens in the request editor.
Save a draft to a collection
- Select the draft in the sidebar.
- Click the Save to Collection button at the end of the URL bar.
- Choose a collection.
The request moves out of Drafts and to the end of the collection, and it joins the collection's workspace. If the workspace has no collections yet, choose File > New Collection to create one first.
You can also save a draft in any of these ways:
- Choose Request > Save to Collection, then choose a collection.
- Control-click the draft in the sidebar, choose Save to Collection, then choose a collection or a folder inside one.
- Drag the draft onto a collection or folder in the sidebar.
To undo the move, choose Edit > Undo.
Turn a request back into a draft
Select the request and choose Request > Convert to Draft, or Control-click it in the sidebar and choose Convert to Draft. You can also drag it into the Drafts section.
The request moves to the end of Drafts. It keeps using the variables of the workspace it came from.
Rename a request
Click the request's title in the toolbar. In the Rename Request popover, enter a name and click Rename.
You can also rename a request in the sidebar. Select it and press Return, or Control-click it and choose Rename. Enter the name and press Return, or press Escape to keep the old one.
A request without a name shows its URL in the sidebar, and Untitled Draft or Untitled Request in the toolbar.
Duplicate a request
Select the request and choose Request > Duplicate Request, or press Command-D. You can also Control-click it in the sidebar and choose Duplicate.
The copy appears right after the original, in the same collection, folder or Drafts, and opens in the request editor. If the original has a name, the copy's name ends in "(Copy)".
Open a request in its own window
Control-click the request in the sidebar and choose Open in New Window. The new window shows the request, so you can keep it beside another one.
Delete requests
Select a request in the sidebar and press Delete, or Control-click it and choose Delete. Relay deletes it right away. To get it back, choose Edit > Undo.
To delete every draft at once, open the Requests pane of Relay > Settings, click Delete… next to Delete All Drafts, then click Delete Drafts.
Important
See Also
- Sending your first request: Create a draft, send it, read the response and save the request.
- Organizing requests into collections: Group requests into collections and folders, and move, copy and style them.
- Understanding workspaces: Learn how workspaces, collections, folders and drafts fit together.
- Sending, stopping, and replaying requests: Send a request, stop one that's in progress and send a past request again.