# Manage Folders

You can create, list, update, and delete workspace folders from the command line.

## List Folders

```bash
roboflow folder list
```

With JSON output:

```bash
roboflow folder list --json
```

## Get Folder Details

```bash
roboflow folder get <folder-id>
```

```bash
roboflow folder get <folder-id> --json
```

## Create a Folder

```bash
roboflow folder create "Training Data"
```

### Options

| Flag         | Description                            |
| ------------ | -------------------------------------- |
| `--parent`   | Parent folder ID (for nesting)         |
| `--projects` | Comma-separated project IDs to include |

Example with projects:

```bash
roboflow folder create "Q2 Models" --projects my-project,other-project
```

## Update a Folder

Rename a folder:

```bash
roboflow folder update <folder-id> --name "New Name"
```

## Delete a Folder

```bash
roboflow folder delete <folder-id>
```

## JSON Output

All folder commands support `--json` for structured output:

```bash
roboflow folder list --json | jq '.[].name'
roboflow folder create "My Folder" --json
```

Exit codes: 0 = success, 1 = error, 2 = auth error, 3 = not found.