---
title: "bird email seeding runs"
description: "Read sending progress and stop future seed admissions"
canonical: "https://bird.com/docs/cli/reference/email-seeding-runs"
---

# `bird email seeding runs`

## Usage

```bash
bird email seeding runs
```

## Description

Reads show retained run progress and can lag recent writes. Provider acceptance and
delivery are separate milestones. Canceling a run leaves already granted copies and
the original source under their existing sending lifecycle.

Reads return JSON; list is paginated.

## Procedure

**Stop future seed admissions**

Stop one run while preserving already granted copies and the original source.

1. `bird email seeding runs get` — Read the intended run and its state. An explicit request to stop this run supplies authorization; clarify an ambiguous run before acting.
2. `bird email seeding runs cancel` — Already granted copies may still send. Stopping does not recall mail, cancel the original email or broadcast, or promise a refund. Before the first call, choose and retain an explicit idempotency\_key. Without an explicit key, command confirmation derives a key from the exact request; repeating that request can recover its proposal under the same OAuth grant and workspace, including after access-token refresh or a new chat. The derived key is not returned as a caller-owned recovery key. Use a new explicit key for a new intent. Keep the same key after a lost response. Command calls require browser confirmation; resume the saved confirmation and wait for its recorded result before reporting the stop. A replay is a saved snapshot. Report the stop separately from unknown or pending outcomes. Even on a stopped run, pending does not establish admission or cancellation; unknown can resolve later. not\_sent includes multiple no-send causes, so it cannot count deliveries prevented by this stop. Next: bird email seeding runs get

## Commands

| Name                                                      | Description                     |
| --------------------------------------------------------- | ------------------------------- |
| [`cancel`](/docs/cli/reference/email-seeding-runs-cancel) | Cancel an automatic seeding run |
| [`get`](/docs/cli/reference/email-seeding-runs-get)       | Get an automatic seeding run    |
| [`list`](/docs/cli/reference/email-seeding-runs-list)     | List automatic seeding runs     |

## Related resources

- [Should I use a Bird SDK or call the API directly?](/explained/platform/should-i-use-an-sdk-or-call-the-api-directly) (answer)
- [Build your first integration](/learn/paths/integration) (course)
- [Send your first email](/docs/get-started/send-your-first-email) (docs)

[Get an implementation brief](/learn/workspace?topic=api-basics)
