> ## 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.

# Search Tasks

> Search existing Octoparse tasks before starting, stopping, or exporting them through AgentTools.

<Info>
  The generated request and response examples are shown in the API panel. Use this page to understand the existing-task workflow.
</Info>

Search existing Octoparse tasks before controlling or exporting them through AgentTools.

<Steps>
  <Step title="Find a task">
    Use `keyword`, `status`, or `taskIds` to locate existing tasks.
  </Step>

  <Step title="Read normalized status">
    Use `taskStatusLabel` for user-facing status and `rawTaskStatusCode` for lower-level diagnostics.
  </Step>

  <Step title="Continue the workflow">
    Use the returned `taskId` with `startOrStopTask` or `exportData`.
  </Step>
</Steps>

```text theme={null}
searchTasks -> startOrStopTask -> exportData
```

<CardGroup cols={2}>
  <Card title="Required header" icon="user">
    `x-external-user-id` is required for task search.
  </Card>

  <Card title="Status filters" icon="sliders-horizontal">
    Supported values are `Running`, `Stopped`, `Completed`, and `Failed`.
  </Card>
</CardGroup>

<AccordionGroup>
  <Accordion title="Task fields">
    `taskId` identifies the task.

    `taskName` is the display name.

    `taskDescription` gives a short task summary when available.
  </Accordion>

  <Accordion title="Paging fields">
    `page`, `size`, `total`, and `totalPages` describe the result set.
  </Accordion>

  <Accordion title="What to call next">
    Follow `suggestedNextCall`, `workflow`, and `toolHint` when deciding whether to call `startOrStopTask` or `exportData`.
  </Accordion>
</AccordionGroup>