Rooms

A room is the top-level container for a set of related API requests. Think of it as a project — one room per API, service, or client.

Creating a room

From the Rooms screen, click the + button or press Cmd+N. Choose a name and, optionally, a custom logo (Pro).

Rooms are stored as folders on your Mac. By default they live in ~/Library/Application Support/Restroom/rooms/, but you can change this in Settings → Data Location.

Organising requests

Inside a room, requests can be placed at the top level or in folders. Folders can be nested. Drag requests and folders to reorganise them, or right-click for options.

The sidebar supports three views, toggled by the icons at the top:

View	Shows
Endpoints	All requests, grouped by folder
Folders	Folder tree only
Favourites	Requests you've starred

Room settings

Each room has its own settings, accessible via Settings → Room tab (or the room menu in the bottom bar). Room settings include:

• Name and logo — rename the room or attach a logo image
• Base URLs — define named base URLs (e.g. Production, Staging) and switch between them in the toolbar
• Request defaults — default timeout, follow redirects, and SSL verification settings that apply to all requests in the room
• Git — connect the room directory to a git repository (Pro)
• Storage — export the room as a zip file, or relocate its data directory

Default room

Mark any room as the default in its settings. Restroom will open directly to that room's editor on launch instead of showing the Rooms screen.

The free tier limit

Free accounts can have up to 10 rooms. Upgrading to Pro removes the limit.

Deleting a room

Right-click a room on the Rooms screen and choose Delete. This removes the room from Restroom's list but does not delete the files from disk, so you can re-add the folder later if needed.