Skip to main content

# kater dashboard tiles remove

Takes a chart off a workspace's dashboard, with every tile of it.

{/* Written by apps/landing-page/scripts/docs/write_cli_reference.py from the kater CLI's own help and scripts/docs/cli-reference.md. Do not edit it by hand: change those, then run the script. */}

The chart stays in the workspace, and no empty slot stays behind. To put the tile back as it was, save the file that `kater dashboard open` gave before.

## Examples

```bash
# Keep the ad_reporting dashboard as it is now, to put the tile back later
kater dashboard open --request-file ad_reporting.json --json > ad_reporting_before.json
# Take the spend_mix chart off the dashboard
kater dashboard tiles remove --request-file remove_spend_mix.json
```

## Arguments

<div class="cli-options">

| Argument | Description |
| --- | --- |
| `<path>` | Optional. In place of `--request-file`: the workspace, the query file or the chart file the request names. |

</div>

## Options

<div class="cli-options">

| Option | Description |
| --- | --- |
| `--request-file <file>` | The workspace and the chart, as JSON. Give `-` to read it from standard input. See [The request](#the-request). |

</div>

It also takes the [global options](https://kater.ai/docs/cli-reference/global-options/) `--json`, `--kater-root`, `--scope` and `--help`.

## The request

| Field | What it holds |
| --- | --- |
| `namespace` | The workspace, by its full `path`. |
| `chart` | The chart to take off, by its name, such as `spend_mix`. |
| `expected_revision` | Optional. The `revision` from [`kater dashboard open`](https://kater.ai/docs/cli-reference/dashboard/open/). |
| `include_inputs` | Optional, true when you leave it out. False answers faster, without the workspace's filters. |

```json title="remove_spend_mix.json"
{"namespace": {"path": "connections/snowflake_prod_connection/workspaces/ad_reporting"}, "chart": "spend_mix"}
```

## Putting it back

Send the `file` you kept to [`kater dashboard save`](https://kater.ai/docs/cli-reference/dashboard/save/), with the dashboard's new revision. The tile comes back where it was.

## See also

- [`kater dashboard tiles`](https://kater.ai/docs/cli-reference/dashboard/tiles/)
- [All commands](https://kater.ai/docs/cli-reference/kater/)

On this page

Examples
Arguments
Options
The request
Putting it back
See also

Kater CLI Present and share dashboard tiles

kater dashboard tiles remove

Takes a chart off a workspace's dashboard, with every tile of it.

The chart stays in the workspace, and no empty slot stays behind. To put the tile back as it was, save the file that kater dashboard open gave before.

Examples

# Keep the ad_reporting dashboard as it is now, to put the tile back later
kater dashboard open --request-file ad_reporting.json --json > ad_reporting_before.json
# Take the spend_mix chart off the dashboard
kater dashboard tiles remove --request-file remove_spend_mix.json

Arguments

Argument	Description
`<path>`	Optional. In place of `--request-file`: the workspace, the query file or the chart file the request names.

Options

Option	Description
`--request-file <file>`	The workspace and the chart, as JSON. Give `-` to read it from standard input. See The request.

It also takes the global options --json, --kater-root, --scope and --help.

The request

Field	What it holds
`namespace`	The workspace, by its full `path`.
`chart`	The chart to take off, by its name, such as `spend_mix`.
`expected_revision`	Optional. The `revision` from `kater dashboard open`.
`include_inputs`	Optional, true when you leave it out. False answers faster, without the workspace’s filters.

{"namespace": {"path": "connections/snowflake_prod_connection/workspaces/ad_reporting"}, "chart": "spend_mix"}

Putting it back

Send the file you kept to kater dashboard save, with the dashboard’s new revision. The tile comes back where it was.

See also