---
title: "Read file or folder metadata"
method: HEAD
path: "/v2/files/{path}"
tags: ["files"]
---

# Read file or folder metadata

`HEAD /v2/files/{path}`

Read metadata of a file or folder at the target path.

This API operation reports whether the object at the target path is a file or folder. If a file, it also reports the file size and last modification time.

<Info>This acts on files and folders in the AI Hub filesystem, not your local filesystem.</Info>

<Note>Ensure the path is accessible within the context defined by the `IB-Context` header.</Note>

## Path parameters

- `path` string, required

## Headers

- `Authorization` string, required
- `IB-Context` string
- `IB-Retry-Config` string

## Response `200`

Successfully retrieved metadata.

- FilesGetFileMetadataResponse200 — Empty response body

## Other responses

- `404` — No file or folder was found at the target path.

---

[API](https://skmtc.net/instabase/apis/api-reference.md) · [All operations](https://skmtc.net/instabase/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/instabase/api-reference/revisions/3a4f46d48141/schema)