# Files:Files

**Page:** api/files-files

[Download Raw Markdown](./api/files-files.md)

---

## API Endpoints Summary

- **GET** `/{path}` — List directory contents or download file
- **PUT** `/{path}` — Upload file
- **PATCH** `/{path}` — File operations
- **DELETE** `/{path}` — Delete file or directory
- **HEAD** `/{path}` — Get file metadata
- **PUT** `/api/v1/files/append/{path}` — Append data to file
- **PATCH** `/api/v1/files/chmod/{path}` — Change file permissions
- **PATCH** `/api/v1/files/chown/{path}` — Change file ownership
- **POST** `/api/v1/files/copy/{path}` — Copy file or directory
- **GET** `/api/v1/files/glob/{path}` — Find files by glob pattern
- **GET** `/api/v1/files/grep/{path}` — Search file contents (grep)
- **POST** `/api/v1/files/move/{path}` — Move file or directory
- **GET** `/api/v1/files/realpath/{path}` — Resolve canonical path (realpath)
- **GET** `/api/v1/files/stat/{path}` — Get file metadata (stat)
- **GET** `/api/v1/files/{path}` — List directory or download file
- **POST** `/api/v1/files/{path}` — File operations (mkdir, extract, download, move, copy)
- **PUT** `/api/v1/files/{path}` — Upload or append file
- **PATCH** `/api/v1/files/{path}` — Modify file properties or move/rename
- **DELETE** `/api/v1/files/{path}` — Delete file or directory
- **GET** `/{directory}?q` — Search directory
- **PUT** `/{path}?touch` — Touch file (create or update mtime)

## CLI

```bash
# CLI mapping will be generated from the SDK CLI sources in a later step.
# Example (placeholder):
# hoody-cli <command> --help
```