Import and run

import pulls named requests from another file into the current document. run executes requests from imported or local files.

Run an entire file

import-all.httphttp
### RUN_ALL_GRAPHQL_REQUESTS

run ./graphql.http

Import and run a named request

import-one.httphttp
import ./graphql.http

### REQUEST_GQL_STARWARS_QUERY_PERSON

run #GQL_STARWARS_QUERY_PERSON

### REQUEST_GQL_STARWARS_QUERY_PLANET

run #GQL_STARWARS_QUERY_PLANET

Variable overrides

Pass @variable=value after the request or file name:

run-with-overrides.httphttp
import ./requests.http

run #Login (@host=example.com)

run #Login (@host=example.com, @user=userName)

Nested imports

Imports can be nested: a file you import may itself import other files. Variables from imported files (including shared blocks) merge into the importing document’s shared scope.

Compat flags propagate

Operators in the file header - including # @kulala-vscode-restclient-compat and # @kulala-curl--* - propagate to blocks brought in via import and run.