Last update: 2025-12-18T09:52:50.000Z
Content:
---
title: "tb copy · Tinybird Docs"
theme-color: "#171612"
description: "Manage copy pipes in your Tinybird project"
inkeep:version: "forward"
---




# tb copy [¶](https://www.tinybird.co/docs/forward/dev-reference/commands/tb-copy#tb-copy)

Copy as MD Manages copy pipes. Global options apply to this command. See [Global options](/docs/forward/dev-reference/commands/global-options).

The following subcommands are available:

| Subcommand | Description |
| --- | --- |
| ls | Lists all the copy pipes. |
| run [OPTIONS] PIPE_NAME_OR_ID | Runs a copy job. |
| pause PIPE_NAME_OR_ID | Pauses a copy job. |
| resume PIPE_NAME_OR_ID | Resumes a copy job. |

## tb copy run [¶](https://www.tinybird.co/docs/forward/dev-reference/commands/tb-copy#tb-copy-run)

Runs a copy job.

| Option | Description |
| --- | --- |
| --wait / --no-wait | Waits for the copy job to finish. |
| --mode [append|replace] | Defines the copy strategy. |
| --yes | Does not ask for confirmation. |
| --param TEXT | Key and value of the params you want the copy pipe to be called with. For example: tb pipe copy run <my_copy_pipe> --param foo=bar |

## Environment support [¶](https://www.tinybird.co/docs/forward/dev-reference/commands/tb-copy#environment-support)

| Environment | Supported | Description |
| --- | --- | --- |
| `--local` | ✓ Yes (default) | Manages copy pipes locally. |
| `--cloud` | ✓ Yes | Manages copy pipes in Tinybird Cloud. |
| `--branch=BRANCH_NAME` | ✓ Yes | Manages copy pipes in a branch. |


