> ## Documentation Index
> Fetch the complete documentation index at: https://www.octoparse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage tasks and task groups

> List, inspect, copy, rename, move, delete, and validate Octoparse tasks, then create and manage task groups from the command line.

Use task commands to find and manage remote tasks. Use task groups to organize related workflows.

## Find tasks

```bash theme={null}
octoparse task list
octoparse task list --page 2 --page-size 20
octoparse task list --keyword news --limit 10
octoparse task list --task-group <groupId>
octoparse task list --template-id <templateId>
octoparse task show <taskId> --json
```

## Copy or reorganize a task

```bash theme={null}
octoparse task copy <taskId> --task-group <groupId> --json
octoparse task rename <taskId> --name "New name" --yes
octoparse task move <taskId> --task-group <groupId> --yes
octoparse task delete <taskId> --yes
```

<Warning>
  `rename`, `move`, and `delete` modify remote task state and require `--yes`. Confirm the task and group IDs before running them in automation.
</Warning>

## Inspect or validate a task definition

```bash theme={null}
octoparse task inspect <taskId>
octoparse task validate <taskId>
octoparse task inspect <taskId> --task-file task.json
octoparse task validate <taskId> --task-file task.otd --json
```

When `--task-file` is used, `<taskId>` provides a fallback ID if the file does not contain one.

## Manage task groups

```bash theme={null}
octoparse task-group list --json
octoparse task-group create "Monitoring" --json
octoparse task-group update <groupId> --name "Price monitoring" --yes
octoparse task-group set-default <groupId> --yes
octoparse task-group delete <groupId> --yes
```

Group updates, deletion, and default-group changes modify remote state and require `--yes`.

## What's next

<CardGroup cols={2}>
  <Card title="Run tasks locally" href="local-runs">
    Start a foreground or detached local extraction.
  </Card>

  <Card title="Run tasks in the cloud" href="cloud-runs-and-schedules">
    Start cloud extraction and configure recurring schedules.
  </Card>
</CardGroup>