Your first request

1. Open a workspace folder

Click Open Workspace on the Welcome screen (or press ⌘⇧O) and pick any folder on your machine — even an empty one.

2. Create a .http file

Right-click in the file tree → New File. Name it requests.http.

3. Write a request

### Get a joke
GET https://official-joke-api.appspot.com/random_joke

The ### line is the request name (optional but useful). The next line is the method and URL.

4. Run it

Click the ▶ gutter button on the method line, or press ⌘Enter with your cursor anywhere in the request block.

The Results Panel shows:

• Status code and response time
• Response headers
• Response body — JSON is automatically pretty-printed

5. Add a body

### Create a post
POST https://jsonplaceholder.typicode.com/posts
Content-Type: application/json

{
  "title": "Hello",
  "body": "My first post",
  "userId": 1
}

Leave one blank line between the last header and the body. That’s the separator.

6. Add file-level variables

@baseUrl = https://jsonplaceholder.typicode.com

### List posts
GET {{baseUrl}}/posts

### Get post 1
GET {{baseUrl}}/posts/1

### Create post
POST {{baseUrl}}/posts
Content-Type: application/json

{ "title": "Hello", "userId": 1 }

Define @key = value before the first ###. Reference with {{key}} anywhere in the file.

Keyboard shortcuts

Key	Action
⌘Enter	Run request under cursor
⌘⇧Enter	Run all requests in the file
⌘/	Toggle line comment
Tab	Accept autocomplete suggestion

Next steps

• .http file format — full syntax reference
• Environment variables — switch between dev/staging/prod
• Flow runner — chain requests with assertions