# BH CLI Examples

> Task-based bh examples: dispatch scans, pull artifacts, and manage blobs and runners.

## Prerequisites

```bash
export BOUNTYHUB_TOKEN="<your_personal_access_token_here>"
```

See [Personal Access Tokens](/developer/personal-access-tokens) for creating
a scoped token.

## Dispatch a Scan

```bash
bh scan dispatch --scan-id "<REVISION_ID>:<ACTIVITY>" \
  --input-string "domain=acme-example.com" --input-bool "aggressive=false"
```

## Pull Run Artifacts

```bash
bh artifact download --run-id "<RUN_ID>" --name "<NAME>" -o findings.txt
bh artifact delete --run-id "<RUN_ID>" --name "<NAME>"
bh scan run delete "<RUN_ID>"
```

## Manage Blobs

```bash
bh blob upload --src ./wordlist.txt --dst "wordlists/dirs.txt"
bh blob download --src "wordlists/dirs.txt" --dst ./dirs.txt
```

Blob storage is managed from the CLI; it is not yet readable from inside a workflow step.

## Register a Runner

```bash
bh runner registration token
bh runner registration command
```

Then follow [Getting Started](/runners/getting-started) to install and start
the runner.

Full command syntax: [BH Commands](/bh/commands).