Skip to content
MZBase MZBase Docs

HTTP request

  • Type http.request
  • Group Network
  • Role action
  • Risk acts outside MZBase
  • Side effect has an effect each run
  • Runs once per item
  • Needs network
  • Credentials header, bearer, basic, query, oauth2

Calls an API or a URL

Also available to AI agents and over MCP as a tool.

Parameters

Section titled “Parameters”

method

Method · string · required · default GET · one of GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS

The HTTP method of the request.

url

URL · string · required

The full address, starting with https://. Use an expression to build it from the item.

credentialId

Credential · string · optional

A saved credential from the vault; it adds the authentication for you.

query

Query parameters · array · optional

Query string parameters, added to the URL.

Fields:

  • name (string) Name
  • value (string) Value

headers

Headers · array · optional

Request headers, one row each. Values may use expressions.

Fields:

  • name (string) Name
  • value (string) Value

body

Body · string · optional · default none · one of none, json, form, multipart, raw, binary

What the request sends: nothing, JSON, a form, raw text or a file from the item.

json

JSON · string · optional

Shown when body is json.

form

Form fields · array · optional

Shown when body is form, multipart.

Fields:

  • name (string) Name
  • value (string) Value

raw

Raw body · string · optional

Shown when body is raw.

contentType

Content type · string · optional

Shown when body is raw.

binaryKey

File field · string · optional

Shown when body is binary.

response

Response format · string · optional · default json · one of json, text, binary

How to read the answer: parsed JSON, text, or a file.

fullResponse

Full response · boolean · optional · default false

Output the status code and headers too, not only the body.

ignoreHttpErrors

Ignore HTTP errors · boolean · optional · default false

Treat 4xx and 5xx answers as a normal output instead of an error.

pagination

Pagination · object · optional

Fetch more pages until there are none left or the page limit is reached.

Fields:

  • mode (string) Mode
  • nextUrl (string) Next URL
  • param (string) Page parameter
  • cursorPath (string) Cursor path
  • maxPages (integer) Max pages

timeoutMs

Timeout (ms) · integer · optional · default 30000 · range 100 – 600000

How long to wait, in milliseconds, before the step fails.

batchSize

Batch size · integer · optional · range 1 – 1000

batchIntervalMs

Pause between batches (ms) · integer · optional · default 1000 · range 0 – 3600000

rateLimitPerMinute

Max requests a minute · integer · optional · range 1 – 60000

proxy

Proxy · string · optional · default none · one of none, profile, proxy

proxyId

Proxy · string · optional

Shown when proxy is proxy.

retryOn429

Retry on 429 (Retry-After) · boolean · optional · default true

maxRetries429

Retries on 429 · integer · optional · default 3 · range 1 – 10

Shown when retryOn429 is true.

Outputs

Section titled “Outputs”
  • main

← All nodes