---
title: "request: head · RUAL Documentation"
description: "The HEAD HTTP method requests the metadata of a resource in the form of headers that the server would have sent if the GET method was used instead."
canonical: https://docs.rual.nl/block-types/webhooks/function_trigger_webhook_http_head
language: en
---

# request: head

This block is part of the [`webhooks`](https://docs.rual.nl/block-types/webhooks) group and was last modified in core [`v15.0.0`](https://docs.rual.nl/core-versions/150000).

The HEAD HTTP method requests the metadata of a resource in the form of headers that the server would have sent if the GET method was used instead.

- flow `flow`

- URL required `value`

- Auth. header `value` Hidden when unused

- Query String `object` Hidden when unused

- headers `object` Hidden when unused

- skip ssl `condition` `true` will skip SSL verification • Hidden when unused

- include token `v12.1.6` `condition` `true` will include current users access token in header, to support internal RUAL endpoints requests • Hidden when unused

- timeout `v14.0.1` `number` Overwrites the default timeout. Time in seconds. • Hidden when unused

- retry `v14.0.4` `condition` Enable automatic retry on failure. Uses exponential backoff. • Hidden when unused

Default `false`

- retry count `v14.0.4` `number` Maximum number of retry attempts. Default is 3. • Hidden when unused

Default `3`

- retry delay `v14.0.4` `number` Initial delay between retries in seconds. Uses exponential backoff (delay doubles each retry). • Hidden when unused

Default `1`

- signing key `v15.0.0` `value` When set, signs the request with HMAC-SHA256 for RUAL-internal APIs (e.g. the mssgs backend): adds `X-Mssgs-Timestamp` (Unix seconds) and `X-Mssgs-Signature: sha256= ` computed over `timestamp\nmethod\nrequest URI\nbody`. • Hidden when unused

- flow `flow`

- code `number`

- headers `object` The replied headers of the request

| `request` |
| --- |
| `http head` |

A typical wiring for [Request: HEAD](https://docs.rual.nl/block-types/webhooks/function_trigger_webhook_http_head): a [function trigger](https://docs.rual.nl/block-types/globals/trigger_custom_function) starts the flow; the `flow` out pin feeds [debug](https://docs.rual.nl/block-types/state%20ui/state_debug).

![Studio canvas example for the Request: HEAD block: typical wiring for Request: HEAD.](https://docs.rual.nl/canvas-examples/function_trigger_webhook_http_head.png)

### Version history

Introduced in [`v13.0.8`](https://docs.rual.nl/core-versions/130008).

Last modified in [`v15.0.0`](https://docs.rual.nl/core-versions/150000).