Getting started

Use Echo to prepare an API request, send it and inspect what came back. This guide covers Windows and macOS. For Android and iOS, start with Echo on your phone.

Install Echo

On Windows, find Gapfy Echo in the Microsoft Store, install it and open it from the Start menu. On a Mac with Apple silicon, download the installer, open the .pkg and follow the installation. Then open Echo from Applications. This Mac download is for Apple chips, including compatible iMac models; it does not install an Intel build.

Choose how to start

Guest mode lets you save requests, collections and environments on your computer without an account. The database is encrypted, with its key protected by Windows DPAPI or macOS Keychain. Editing saved work does not need a connection. Calling a remote API still needs access to that API.

Sign in through your usual browser to synchronize work, use shared collections and select an organization. Check the active workspace before creating shared content. Cloud features depend on your account's permissions and plan. Collections and sharing explains those boundaries.

Send and save a first request

  1. Create a space for your project and a collection inside it.
  2. Add an HTTP request. Give it a recognizable name, such as List orders.
  3. Choose the method and enter your API's URL. Add query parameters and headers in their editors. For POST or PUT, choose the body format your API accepts.
  4. Configure the request's authentication if required. Prefer an environment variable over a token pasted into the URL.
  5. Select the environment and send. You can cancel a request that is still running.
  6. Inspect the status, response headers and body. The timing view separates connection work, waiting for the server and downloading the response.
  7. Save the request in your collection. A history entry does not replace a saved request you intend to maintain.

Start with a read operation against an API you can safely call. Sending a request can create or change data. Learn the individual editors in requests and protocols.

Make the workspace comfortable

Use the command palette to find actions without searching every menu. Open requests in tabs or arrange up to four panes to compare related calls. The history view has filters for finding previous executions and reopening their details.

Settings offers light, dark and system themes, accent colors and seven interface languages. The website has six languages. Restart Echo when the language setting asks you to. The shortcuts section lets you change bindings and restore defaults.

Preferences also control tab restoration and defaults for new requests, including timeout, certificate validation and redirects. Check the individual request when you need a different setting. Proxy and client certificates are covered in requests and protocols.

Bring existing requests

Use the import section in Settings for Postman, Insomnia, Bruno or OpenAPI files. The separate cURL import assist uses AI and requires a Pro AI seat. Read the preview and warnings before confirming. Some settings and attachments need manual adjustment. Import and export also explains folder links and documentation publishing.

When something does not work

For a failed request, check the environment, resolved URL, authentication and response details. For missing shared work, check the account, workspace and synchronization status. Its details show recent activity and actions for conflicts or items needing repair.

Settings shows the installed version, diagnostic tools and update checks where supported by the installation channel. An unavailable in-app check does not mean a store installation has no updates. When contacting support, include the version and failing action, and remove credentials from shared logs.

Resetting the device database removes device data. Export anything that has not synchronized before considering this recovery operation. For routine connection or permission errors, start with the error details.

Continue with your workflow