> ## Documentation Index
> Fetch the complete documentation index at: https://resq-dependabot-github-actions-github-actions-478e18be3d.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Head

# Function: head()

Issue an HTTP HEAD (response headers only, no body). Convenience
wrapper around [fetcher](./fetcher).

Useful for cache validation, content-length probing, or existence
checks without the body transfer cost.

## Call Signature

> **head**\<`T`>(`url`, `options?`, `params?`): `Effect`\<`T`, [`FetcherValidationError`](../classes/FetcherValidationError) | [`FetcherError`](../classes/FetcherError), `HttpClient`>

Defined in: [packages/http/src/fetcher.ts:758](https://github.com/resq-software/npm/blob/fe2e20ae9db8398a0db1e3218edaabb3cf7004d6/packages/http/src/fetcher.ts#L758)

### Type Parameters

#### T

`T` = `unknown`

### Parameters

#### url

`string`

#### options?

[`FetcherOptions`](../interfaces/FetcherOptions)\<`T`>

#### params?

### Returns

`Effect`\<`T`, [`FetcherValidationError`](../classes/FetcherValidationError) | [`FetcherError`](../classes/FetcherError), `HttpClient`>

## Call Signature

> **head**\<`S`>(`url`, `options`, `params?`): `Effect`\<`Type`\<`S`>, [`FetcherValidationError`](../classes/FetcherValidationError) | [`FetcherError`](../classes/FetcherError), `HttpClient`>

Defined in: [packages/http/src/fetcher.ts:764](https://github.com/resq-software/npm/blob/fe2e20ae9db8398a0db1e3218edaabb3cf7004d6/packages/http/src/fetcher.ts#L764)

### Type Parameters

#### S

`S` *extends* `SyncSchema`\<`Type`\<`S`>>

### Parameters

#### url

`string`

#### options

[`FetcherOptions`](../interfaces/FetcherOptions)\<`Type`\<`S`>> & `object`

#### params?

### Returns

`Effect`\<`Type`\<`S`>, [`FetcherValidationError`](../classes/FetcherValidationError) | [`FetcherError`](../classes/FetcherError), `HttpClient`>