---
title: tb sink
meta:
    description: Manage sink pipes in your Tinybird project
---

# tb sink

Manages sink pipes. Global options apply to this command. See [Global options](/forward/dev-reference/commands/global-options).

The following subcommands are available:

{% table %}
  * Subcommand
  * Description
  ---
  * ls
  * Lists all the sink pipes.
  ---
  * run [OPTIONS] PIPE_NAME_OR_ID
  * Runs a sink job.
{% /table %}

## tb sink run

Runs a sink job.

{% table %}
  * 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
{% /table %}

## Environment support

{% table %}
  * 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.
{% /table %}