Skip to content

Creating Requests in Martini's HTTP Client

Overview

Martini's HTTP Client is a built-in tool for creating and managing HTTP requests directly inside Martini Designer. You can create requests from scratch, configure them fully, and save them for reuse — either scoped to your current workspace or shared across all workspaces. This eliminates the need to switch to an external API client when developing and testing APIs built with Martini.

What You Will Learn

  • How to create a new HTTP request
  • The difference between Workspace Requests and User Requests
  • How to save an HTTP request
  • How to delete one or more HTTP requests

When To Use This

Use this when you need to:

  • Test or debug an HTTP endpoint without switching to an external API client
  • Organize project-specific API requests separately from personal reusable ones
  • Remove outdated or unused API requests from your workspace or user request store

Prerequisites

Before creating HTTP requests in Martini, ensure the following are in place:

Creating HTTP Requests

The HTTP Client lets you build new requests from scratch using either the toolbar button or the right-click context menu. Every request opens as an unsaved draft that you configure in the HTTP Request Editor before saving.

Getting Started with HTTP Request Creation

There are two ways to create a new HTTP request in Martini Designer.

Using the toolbar:

  1. Open the HTTP Client view.
  2. In the toolbar, click the New Request button.

Expected result: An unsaved request opens in the HTTP Request Editor, ready for configuration.

Using the right-click context menu:

  1. Open the HTTP Client view.
  2. Right-click on either a Workspace Requests or User Requests folder (clicking on the blank space uses the corresponding root folder)
  3. Hover over New .
  4. Select HTTP Request .

Expected result: An unsaved request opens in the HTTP Request Editor, pre-associated with the folder you right-clicked.

Saving and Deleting HTTP Requests

After creating and configuring an HTTP request, save it to one of the two storage folders in the HTTP Client. You can also delete requests you no longer need from either storage folder.

Getting Started with Saving HTTP Requests

To save a new HTTP request:

  1. Press + , or click the Save button in the Martini toolbar.
  2. When prompted, choose where to save the request:
    • Workspace Requests — Saves the request to your current workspace only.
    • User Requests — Saves the request so it is available across all workspaces.

Expected result: The request is saved and appears in the selected folder of the HTTP Client view.

Workspace vs User Request Folder Key Terms

Understanding the two folders types helps you keep requests properly organized across projects and workspaces.

Term Definition
Workspace Requests Requests stored in the current Martini workspace under <workspace_root_folder>/requests/. Useful for project-specific API calls that should not carry over to other workspaces.
User Requests Requests stored at the user level under .martini_designer/http-client/requests/, shared across all workspaces. Useful for personal testing templates, shared utilities, or frequently reused API calls.

Getting Started with Deleting HTTP Requests

To delete one or more HTTP requests:

  1. Open the HTTP Client view.
  2. Select one or more HTTP requests you want to delete.
  3. Right-click the selection and choose Delete , or press .

Expected result: The selected requests are permanently removed from the HTTP Client.

Helpful Resources