---
title: "Check if asset exists by hash"
method: HEAD
path: "/api/assets/hash/{hash}"
tags: ["file"]
---

# Check if asset exists by hash

`HEAD /api/assets/hash/{hash}`

Checks if an asset exists in the system by its blake3 hash.
Returns 200 if the asset exists, 404 if it doesn't.

## Path parameters

- `hash` string, required

## Response `200`

Asset exists

## Other responses

- `400` — Invalid hash format
- `401` — Unauthorized
- `404` — Asset not found
- `500` — Internal server error

## Changes

> 38 revisions in range; 2 could not be searched.

- **2026-06-03** `8560879e6188` — 1 breaking, 5 info
  - added the pattern `^blake3:[a-f0-9]{64}$` to the `path` request parameter `hash`
  - api tag `file` added
  - api tag `assets` removed
  - added the optional property `details` to the response with the `400` status
  - …2 more
- **2026-05-22** `09a5075587c8` — 3 info
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
  - added the non-success response with the status `500`
- **2026-04-24** `a66055fa384e` — 6 info
  - api tag `assets` added
  - api tag `file` removed
  - removed the pattern `^blake3:[a-f0-9]{64}$` from the `path` request parameter `hash`
  - removed the non-success response with the status `400`
  - …2 more

[Change history](https://skmtc.dev/comfy-org/apis/comfyui-api/changes/api/assets/hash/:hash/head.md)

---

[API](https://skmtc.dev/comfy-org/apis/comfyui-api.md) · [All operations](https://skmtc.dev/comfy-org/apis/comfyui-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/comfy-org/comfyui-api/revisions/da017caf56f1/schema)