> ## Documentation Index
> Fetch the complete documentation index at: https://docs.reachboost.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Tags

> Labels you attach to leads to group and filter them.

`reachboost tags` has 5 commands. Each one lists its arguments, its flags and what it is allowed to change.

Read-only

Changes data

Needs --yes

Every command also accepts the [global flags](https://docs.reachboost.io/cli/commands.md#global-flags).

## tags get

Read-only

Get a tag. Read-only.

```bash Usage theme={null}
reachboost tags get "<tag-uuid>"
```

**Arguments**

**\<tag-uuid>** `uuid` *required*

The unique identifier for the tag.

## tags list

Read-only

List tags. Read-only.

```bash Usage theme={null}
reachboost tags list
```

**Flags**

**--page \<n>** `number`

The page number.

**--per-page \<n>** `number`

The number of results per page.

**--name \<text>** `string`

Partial match filter (case-insensitive).

**--all** `boolean`

Fetch every page (up to 200 pages of 100) instead of one. Cannot be combined with --page.

## tags create

Changes data

Create a tag. Changes data.

```bash Usage theme={null}
reachboost tags create
```

**Flags**

**--name \<text>** `string`

**--body \<json>** `JSON`

The whole request body as JSON, instead of individual flags.

**--body-file \<path>** `path`

Read the whole request body as JSON from a file, or from stdin with -.

**--dry-run** `boolean`

Show exactly what would be sent, and send nothing.

```bash Example theme={null}
reachboost tags create --name VIP
```

## tags delete

Needs --yes

Delete a tag. Destructive: needs --yes.

> [!WARNING]
>
> Needs `--yes`. Without it the command shows what it would do and stops. Try it with `--dry-run` first. See [Safety](https://docs.reachboost.io/cli/safety.md#--yes).

```bash Usage theme={null}
reachboost tags delete "<tag-uuid>"
```

**Arguments**

**\<tag-uuid>** `uuid` *required*

The unique identifier for the tag.

**Flags**

**--dry-run** `boolean`

Show exactly what would be sent, and send nothing.

**--yes** `boolean`

Confirm. Without it the command shows what it would do and stops.

```bash Examples theme={null}
reachboost tags delete "<uuid>" --dry-run
reachboost tags delete "<uuid>" --yes
```

## tags update

Changes data

Update a tag. Changes data.

```bash Usage theme={null}
reachboost tags update "<tag-uuid>"
```

**Arguments**

**\<tag-uuid>** `uuid` *required*

The unique identifier for the tag.

**Flags**

**--name \<text>** `string`

**--body \<json>** `JSON`

The whole request body as JSON, instead of individual flags.

**--body-file \<path>** `path`

Read the whole request body as JSON from a file, or from stdin with -.

**--dry-run** `boolean`

Show exactly what would be sent, and send nothing.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.