---
title: "aeontel file"
description: "Manage files"
section: "CLI"
group: "Commands"
order: 814
---

## File commands

### `aeontel file list`

List files in a workspace

```ts
aeontel file list --workspace <id> [--directory <id>] [--mime <prefix>]
```

```bash
aeontel file list --workspace wsp_...
```

### `aeontel file get`

Get file metadata

```ts
aeontel file get <id>
```

```bash
aeontel file get id_...
```

### `aeontel file update`

Rename or move a file

```ts
aeontel file update <id> [--name <name>] [--directory <id>]
```

```bash
aeontel file update id_...
```

### `aeontel file delete`

Soft-delete a file (restorable until retention expires)

```ts
aeontel file delete <id>
```

```bash
aeontel file delete id_...
```

### `aeontel file download`

Download a file via signed URL

```ts
aeontel file download <id> [--out <path>]
```

```bash
aeontel file download id_...
```

### `aeontel file html-from-url`

Fetch the post-render HTML of a URL via Cloudflare Browser Rendering and store as a file

```ts
aeontel file html-from-url --workspace <id> --url <url> [--directory <id>] [--name <name>] [--ttl-ms <ms>]
```

```bash
aeontel file html-from-url --workspace wsp_... --url https://example.com
```

### `aeontel file markdown-from-url`

Render a URL as markdown via Cloudflare Browser Rendering and store as a file

```ts
aeontel file markdown-from-url --workspace <id> --url <url> [--directory <id>] [--name <name>] [--ttl-ms <ms>]
```

```bash
aeontel file markdown-from-url --workspace wsp_... --url https://example.com
```

### `aeontel file pdf-from-url`

Render a URL to PDF via Cloudflare Browser Rendering and store as a file

```ts
aeontel file pdf-from-url --workspace <id> --url <url> [--directory <id>] [--name <name>] [--ttl-ms <ms>]
```

```bash
aeontel file pdf-from-url --workspace wsp_... --url https://example.com
```

### `aeontel file read`

Fetch file content and print to stdout

```ts
aeontel file read <id>
```

```bash
aeontel file read id_...
```

### `aeontel file restore`

Restore a soft-deleted file

```ts
aeontel file restore <id>
```

```bash
aeontel file restore id_...
```

### `aeontel file screenshot-from-url`

Screenshot a URL via Cloudflare Browser Rendering and store as a file

```ts
aeontel file screenshot-from-url --workspace <id> --url <url> [--directory <id>] [--name <name>] [--ttl-ms <ms>]
```

```bash
aeontel file screenshot-from-url --workspace wsp_... --url https://example.com
```

### `aeontel file to-markdown`

Convert an existing file (PDF/DOCX/PPTX/XLSX/image/HTML) to markdown via Cloudflare Workers AI and store as a new file

```ts
aeontel file to-markdown <id> [--directory <id>] [--name <name>] [--ttl-ms <ms>]
```

```bash
aeontel file to-markdown id_...
```

### `aeontel file upload`

Upload a local file (full multipart lifecycle: create → PUT parts → complete)

```ts
aeontel file upload --workspace <id> --file <path> [--directory <id>] [--name <override>]
```

```bash
aeontel file upload --workspace wsp_... --file <path>
```