# Get directory metadata

Launch stage: Public Preview

`HEAD /api/2.0/fs/directories{directory_path}`

Get the metadata of a directory. The response HTTP headers contain the metadata.
 There is no response body.

 This method is useful to check if a directory exists and the caller has access to it.

 If you wish to ensure the directory exists, you can instead use `PUT`, which will create
 the directory if it does not exist, and is idempotent (it will succeed if the directory
 already exists).

API scopes: files

## Path parameters

- `directory_path` (string, required)
  The absolute path of a directory.
  Example: `/Volumes/my-catalog/my-schema/my-volume/directory/` : A directory

## Responses

### 200

Request completed successfully.

## Response

```json
{}
```