---
search:
  tags:
    - artifacts
    - HEAD
seo:
  description: >-
    Check that a cache artifact with the given hash exists. This request…
    Reference for the HEAD /artifacts/{hash} endpoint in the Turborepo Remote
    Cache API.
sidebar:
  label: Check if artifact exists
  badge: HEAD
title: Check if artifact exists
type: openapi-operation
---
Check that a cache artifact with the given `hash` exists. This request returns response headers only and is equivalent to a `GET` request to this endpoint where the response contains no body.

Implementers should return 200 if the artifact exists, or 404 if it does not.

`HEAD /artifacts/{hash}`

**Responses**

- `200` — Artifact exists
- `400` — Bad request. One or more of the provided values in the request query, headers, or body is invalid.
- `401` — Unauthorized. The request is missing a valid authentication token or the token is invalid.
- `403` — Forbidden. The authenticated user does not have permission to access this resource.
- `404` — Artifact not found. No artifact with the specified hash exists.