Documentation

Short guides for the desktop app. For the full reference, see the canonical docs in the Echo repository.

Quick start

Collections live in the left sidebar. Click a request to load it, edit the method and URL, then use Send. The response appears in the panel below.

Workspace storage

On desktop, your workspace is saved automatically to a JSON file under the app data directory (the sidebar status area shows the path to collections.json). The web-only dev build uses browser localStorage instead.

Variables

In the Environment section, define variables and use {{variableName}} in the URL, headers, query, body, and auth. Disabled rows are ignored. Each request selects which environment definition to use; editing that definition updates every request that references it.

Secrets (desktop)

Add Secret rows in the environment table and reference them with {{secret:NAME}}. Values are read from the OS credential manager when you send a request and are not included in exported workspace files. Deleting an environment removes related keychain entries; changing a row away from Secret clears stored credentials for that name.

Authentication

Choose None, Bearer, Basic, or API key. API keys can be sent as a header or as query parameters.

Completion scripts

After a successful response, Echo can run your completion script: pm.response.status(), pm.response.text(), pm.response.json() (throws if the body is not valid JSON), and pm.console.log(...) for output in the script panel.

Import and export

Right-click a folder in the tree and choose Export workspace… or Import workspace… to back up or replace the full workspace JSON.

Full reference on GitHub