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




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

Copy as MD Manages sink 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 sink pipes. |
| run [OPTIONS] PIPE_NAME_OR_ID | Runs a sink job. |

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

Runs a sink job.

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

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

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


